Relations-Struktur anzeigen

Sie können sich in agorum core die Relations-Struktur eines Objekts anzeigen lassen, also eines Dokuments, einer E-Mail, einer Notiz oder auch eines Ordners.

Durch die Anzeige der Relations-Struktur eines Objekts können Sie etwa

die Objektverknüpfungen nachvollziehen und überprüfen
die Ablagestruktur der Objekte in der Datenbank visualisieren
den Ursprung vererbter Metadaten ermitteln
bei Konfigurationen per Skript feststellen, ob durch das Skript erstellte Objekte richtig angelegt werden
in Kombination mit dem agorum core audit tool Änderungen an Objekten im Detail nachvollziehen

Hinweis: Aus der Reihenfolge der Relationen in der Anzeige können Sie keine Rückschlüsse auf die zeitliche Reihenfolge der Anlage der Objekte ziehen. Zur Analyse der Reihenfolge der Erstellung können Sie die Audittabelle verwenden.

Was ist eine Relations-Struktur?

Die Objekte in agorum core stehen in Relationen (oder Beziehungen) zueinander. Das entspricht in etwa der Struktur, in der die Objekte in der Datenbank gespeichert werden.

Darstellung der Relations-Struktur zwischen einem Ordner und einer Datei

Ein anschauliches Beispiel ist eine Datei, die sich in einem Ordner befindet. In diesem Beispiel ist das eine Objekt der Ordner und das andere Objekt die Datei. Die Beziehung zwischen den beiden Objekten ist selbst auch ein Objekt und hat einen Namen, den Relations-Klassennamen. Die Relation zwischen einem Ordner und einer Datei hat etwa den Namen FOLDERPATHRELATIONOBJECT. Neben der Relation zwischen den beiden Objekten gibt es auch eine Struktur: Die Datei befindet sich in einem Ordner. Man muss zuerst den Ordner öffnen, um zur Datei zu gelangen. Wie in der Explorer-Anzeige wird der Ordner als linksseitiges (übergeordnetes) Objekt abgelegt und die Datei als rechtsseitiges (untergeordnetes) Objekt.

Zu jeder Relations-Struktur gehören entsprechend

eine Referenz auf die Objekte, zwischen denen die Struktur besteht
der Relations-Klassenname
die Einordnung der Objekte in der Relation in links (übergeordnet) und rechts (untergeordnet)
und eine eindeutige ID für die Relations-Struktur selbst

Die beiden Objekte, Ordner und Datei, befinden sich jeweils nicht nur in einer Relation, sondern in mehreren. Der Ordner ist etwa selbst wieder ein Unterordner eines anderen Ordners. In dieser Relations-Struktur, die auch den Relations-Klassennamen FOLDERPATHRELATIONOBJECT hat, ist der Unterordner, in dem sich die Datei befindet, das rechte Objekt und der übergeordnete Ordner das linke.

Darstellung der Relation-Struktur zwischen einem Ordner, einem Unterordner und einer Datei

Neben dem Relations-Klassennamen FOLDERPATHRELATIONOBJECT gibt es viele weitere Relationen zwischen Objekten und entsprechend Relations-Klassennamen.

Einige der wichtigsten sind:

Relations-Klassenname	Beschreibung
AttributeRelationObject	Beschreibt die Relation zwischen einem Objekt und den zugeordneten Metadaten in einer XML-Struktur, enthält auch die Information, wie die Metadaten dem Objekt zugeordnet wurden (direkt oder durch Vererbung)
CHANGEHISTORYRELATIONOBJECT	Beschreibt die Relation zwischen einem Objekt und seinen Vorgängerversionen
DocumentTextRelationObject	Beschreibt die Relation zwischen einem Objekt und einem zugeordneten Text
FOLDERPATHRELATIONOBJECT	Beschreibt die Relation zwischen Ordnern und darin enthaltenen Objekten
MailBodyRelationObject	Beschreibt die Relation zwischen einem E-Mail-Objekt und dem Inhalt des E-Mail-Bodys, also dem Text- oder HTML-Inhalt der E-Mail
NoteRelationObject	Beschreibt die Relation zwischen einem Objekt und einer Notiz
PreviewImageRelation	Beschreibt die Relation zwischen einem Objekt und der objektabhängigen Preview-Datei, die beim Öffnen der Vorschau erstellt wird
PreviewOverlayRelation	Beschreibt die Relation zwischen einem Preview-Objekt und einem zugeordneten Overlay, etwa Stempel oder Notizen direkt auf dem Vorschaudokument.

Relations-Struktur öffnen

Sie öffnen die Anzeige der Relations-Struktur entweder über das Kontextmenü für das ausgewählte Objekt oder über die Kopfleiste und Angeben des Objekts, dessen Relations-Struktur Sie öffnen wollen.

Hinweis: Voraussetzung für das Öffnen der Relations-Struktur ist, dass Sie Administrator sind und die Relations-Struktur wie andere Administrationsfunktionen für Sie mit der ACL ACL_agorum admin tools freigeschaltet worden ist.

Relations-Struktur über das Kontextmenü öffnen

Öffnen Sie links in der Seitenleiste Explorer.
Klicken Sie ein Objekt (Datei oder Ordner) mit der rechten Maustaste an.
Wählen Sie im Kontextmenü Administration > Werkzeuge > Relations-Struktur (vom gewählten Objekt).

Ergebnis: Die Anzeige der Relations-Struktur öffnet sich und zeigt das gewählte Objekt an.
Lassen Sie sich die Objektinformationen durch Klicken auf das Objekt anzeigen.

Ergebnis: Die Objektinformationen werden auf der rechten Seite angezeigt.
Navigieren Sie durch die Relations-Struktur des gewählten Objekts durch Aufklappen der Strukturen unter dem Objekt.

Relations-Struktur über die Kopfzeile öffnen

Klicken Sie oben rechts in der Kopfleiste auf und dann auf Administration > Werkzeuge > Relations-Struktur.

Ergebnis: Die Anzeige der Relations-Struktur öffnet sich mit leerer Anzeige.
Geben Sie die ID oder UUID des Objekts an, dessen Relations-Struktur Sie anzeigen lassen wollen, und klicken Sie Suchen.

Ergebnis: Das Objekt wird angezeigt.
Lassen Sie sich die Objektinformationen durch Klicken auf das Objekt anzeigen.

Ergebnis: Die Objektinformationen werden auf der rechten Seite angezeigt.
Navigieren Sie durch die Relations-Struktur des gewählten Objekts durch Aufklappen der Strukturen unter dem Objekt.

Anzeige der Relations-Struktur

Anzeige der Relations-Struktur einer PDF-Datei

Die Anzeige der Relations-Struktur ist abhängig vom ausgewählten Objekt.

Auf der linken Seite finden Sie die Anzeige der Relations-Struktur des gewählten Objekts mit der oben in der Suche angezeigten ID oder UUID. In diesem Beispiel handelt es sich um die Datei Willkommen.pdf.
Willkommen.pdf hat mehrere Relations-Strukturen nach Rechts etwa eine mit dem Relations-Klassennamen DOCUMENTTEXTRELATIONOBJECT zu einer XML-Datei. Die XML-Datei enthält den extrahierten Text der PDF-Datei, um sie besser durchsuchbar zu machen. Die PDF-Datei ist dieser Datei übergeordnet, ebenso wie sie das Hauptobjekt für die anderen über Relations-Strukturen zugeordneten Objekte wie die Vorschaubilder, Notizen und Versionshistorien ist.

Willkommen.pdf hat eine Relations-Struktur nach Links mit dem Relations-Klassennamen FOLDERPATHRELATIONOBJECT zum Ordner Demo. Die PDF-Datei ist also dem Ordner untergeordnet, sie befindet sich in diesem Ordner.

Unterhalb von Rechts und Links können Sie sich weiter durch die hierarchischen Relations-Strukturen der Objekte klicken, etwa um herauszufinden, in welcher Ordnerstruktur sich der Demo-Ordner befindet.
Auf der rechten Seite finden Sie die Anzeige der Detailinformationen des jeweils in der linken Seite ausgewählten Objekts. Darunter finden Sie auch die Relationsinformationen. In diesem Beispiel sind das die Informationen der XML-Datei, die den extrahierten Text enthält. Durch Klicken auf die Links in der Detailinformation können Sie die Anzeige der Relations-Struktur des jeweiligen Objekts öffnen.
In der Toolbar über den Detailinformationen können Sie verschiedene Aktionen für das ausgewählte Objekt ausführen, das in den Detailinformationen angezeigt wird. Für weitere Informationen zur Toolbar in der Relations-Struktur Anzeige, siehe Relations-Struktur Toolbar.

Relationsinformationen

Die Relationsinformationen sind die Informationen zu einer Relations-Struktur zwischen Objekten in agorum core. Dazu gehören:

Feld	Beschreibung
Relations-Klassenname	Name, der die Relation zwischen den Objekten beschreibt, siehe Tabelle Relations-Klassennamen
ID	ID des Relations-Strukturobjekts
UUID	UUID des Relations-Strukturobjekts
Linksseitiges Objekt	Enthält einen Link auf das übergeordnete Objekt. Der Linktext besteht aus Objektname und UUID.
Rechtsseitiges Objekt	Enthält einen Link auf das untergeordnete Objekt. Der Linktext besteht aus Objektname und UUID.

Relations-Struktur Toolbar

Die Toolbar in der Anzeige der Relations-Struktur erlaubt Ihnen folgende Aktionen für das jeweils ausgewählte und in den Detailinformationen angezeigte Objekt:

Schaltfläche	Beschreibung
Details	Öffnet das Objekt im Detailfenster.
Öffnen	Öffnet das ausgewählte Objekt abhängig von der Art des Objekts. Wenn es sich etwa um einen Ordner handelt, wird dieser geöffnet. Ist es ein Dokument, wird dieses in der konfigurierten Anwendung geöffnet.
Dokumententext	Diese Aktion ist nur bei Textdokumenten verfügbar und öffnet die Anzeige Dokumententext.
Audit Tool	Öffnet das agorum core audit tool für das ausgewählte Objekt.
Herunterladen	Lädt das Dokument auf Ihren Rechner herunter. Diese Schaltfläche ist nur verfügbar, wenn das Objekt heruntergeladen werden kann. Bei Ordnern etwa ist ein Herunterladen nicht möglich.