Durchsuchbare Dokumentation aufrufen | Zurück zur Dokumentationsübersicht
Navigation: Dokumentationen agorum core > agorum core administrieren (agorum core admin tools)
In welcher Version enthalten?
• agorum core open
• agorum core pro
Das agorum core audit tool enthält alle Änderungen an Objekten, um nachzuvollziehen, wann und von wem welche Objekte angelegt (create), geändert (update) und gelöscht (delete) wurden. Dazu verwendet das agorum core audit tool die Audittabelle in der Datenbank.
Die Daten können Sie in der Oberfläche von agorum core in einer grafischen Tabelle einsehen.
Das agorum core audit tool können nur Administratoren öffnen, die Sie separat über die ACL ACL_agorum core audit support tool berechtigt haben.
So finden Sie die ACL:
acaudit
Als Administrator mit entsprechender Berechtigung öffnen Sie das agorum core audit tool folgendermaßen:
Folgende Felder existieren innerhalb der Suchkriterien, im Suchergebnis als Spalte oder in den Details:
Feld | Beschreibung |
---|---|
Datum (von) | Grenzt den Zeitraum ein. |
Datum (bis) | |
Objektname | Definiert den Namen des betroffenen Objekts.
Woran Sie ein Objekt erkennen und welche Unterschiede es zu Beziehungen (Relationen) gibt, siehe Unterschied Objekt vs. Beziehung (Relation). |
Benutzername | Definiert den Benutzernamen |
Aktion | Definiert die Aktion, die das System durchgeführt hat. |
Klassenname | Definiert den Klassennamen des Objekts, das betroffen ist ( FileObject, MailObject, FolderObject, …). |
Referenzobjekt ID | Definiert das eigentliche agorum core-Objekt (ID), auf das sich die Aktion bezieht. |
Referenzobjekt UUID | Definiert das eigentliche agorum core-Objekte (UUID), auf das sich die Aktion bezieht. |
Linksseitiges Objekt (UUID) | Definiert bei einer Relation das linksseitige Objekt (UUID). Welche Unterschiede es zwischen Beziehungen (Relationen) und Objekten gibt, siehe Unterschied Objekt vs. Beziehung (Relation). |
Rechtsseitiges Objekt (UUID) | Definiert bei einer Relation das rechtsseitige Objekt (UUID). Welche Unterschiede es zwischen Beziehungen (Relationen) und Objekten gibt, siehe Unterschied Objekt vs. Beziehung (Relation). |
Benutzer-UUID | Definiert die UUID des Benutzers, der die Aktion vorgenommen hat. |
isHead (letzte Änderung eines Objektes) | True Der markierte Audit-Eintrag stellt die letzte Änderung des betroffenen Objekts dar. False Der markierte Audit-Eintrag stellt NICHT die letzte Änderung des betroffenen Objekts dar, d. h. es existiert noch ein Eintrag / eine Aktion, die aktueller ist und eventuell nachfolgend ausgeführt wurde. |
isCommitHead (letzte Transaktion, in dem das Objekt geändert wurde) | True Der markierte Audit-Eintrag stellt den letzten Eintrag innerhalb eines Commits (Datenbanktransaktion) dar. False Der markierte Audit-Eintrag stellt NICHT den letzten Eintrag innerhalb eines Commits (Datenbanktransaktion) dar, d. h. es existiert noch ein Eintrag / eine Aktion innerhalb eines Commits, die aktueller ist und eventuell nachfolgend ausgeführt wurde. |
Aktionszeitpunkt | Definiert den Zeitpunkt der Aktion (Zeitstempel). |
Audit-ID | Definiert eine interne, eindeutige ID des jeweiligen Audit-Eintrags (aufsteigend). |
Commit-ID: | Definiert die ID eines commits (Datenbanktransaktion).
|
Info | (nur in den Details) Definiert, von wo oder durch welches Protokoll die Aktion durchgeführt wurde (etwa ApiSession = Weboberfläche). Wird im Regelfall nur intern für Entwickler von agorum core benötigt. |
Attribute | (nur in den Details) Enthält diverse Standard-Attribute aus der Datenbank, die gesetzt / geändert wurden. |
Max. Anzahl Einträge | (nur in den Suchkriterien) Definiert, wie viele Einträge das System pro Suche maximal findet (Standard: 100): |
Timeout in Sekunden | (nur in den Suchkriterien) Definiert einen Time-out für die Suche in Sekunden (Standard: 10). Benötigt das System für die Suche länger als die angegebenen Sekunden, bricht es die Suche komplett ab und zeigt eine Fehlermeldung an. Im Suchergebnis tauchen keine Einträge auf. Achtung: Beeinträchtigung der Systemleistung bei Benutzung der PostgreSQL-Datenbank. Das Feld Timeout in Sekunden hat für die PostgreSQL-Datenbank keine Relevanz. Die PostgreSQL-Datenbank sucht in diesem Falle die eingestellte maximale Anzahl an Einträgen. Eine hohe Anzahl an zu suchenden Einträgen kann die Systemleistung erheblich beeinträchtigen, sodass andere Benutzer das System eventuell nicht mehr optimal verwenden können. Stellen Sie keine hohen Werte im Feld Max. Anzahl Einträge ein oder belassen Sie die Einträge im Standard. |
Die Tabelle stellt 2 Typen von Informationen dar:
Ein Objekt erkennen Sie in der Oberfläche anhand folgender Merkmale:
Objekte können sein:
Objekte teilen sich wiederum in Klassen ein und erscheinen in der Oberfläche in der Spalte Klassenname. Folgende Klassennamen kommen am häufigsten vor:
Klassenname | Beschreibung |
---|---|
ATTRIBUTEXMLOBJECT | Interne Ablage der Metadaten in einer XML-Struktur |
FILEOBJECT | Datei, Dokument |
FOLDEROBJECT | Ordner |
MAILDOCUMENTOBJECT | Anhang einer E-Mail |
MAILOBJECT | |
AMAILMAIL | E-Mail aus dem E-Mail-Adapter |
AMAILFOLDER | Ordner in einer adaptierten Mailbox |
AMAILMOUNTPOINT | Adaptierte Mailbox (E-Mail-Adapter) |
Mit Beziehungen können Sie einen ganzen Lebenszyklus eines Dokuments von der Ablage bis zum Löschvorgang nachvollziehen, d. h. wo / wie kam es ins System, wohin wurde es verschoben und wo wurde es gelöscht.
Eine Beziehung (Relation) erkennen Sie in der Oberfläche anhand folgender Merkmale:
Im Suchergebnis in der Spalte Objektname ist ein Name mit folgendem Aufbau eingetragen:
Aufbau <Klassenname linksseitiges Objekt>,<Klassenname rechtsseitiges Objekt> Beispiel FOLDEROBJECT,FILEOBJECT
In dieser Abbildung ist eine Beziehung zwischen dem Ordner statistics (Linksseitiges Objekt mit dem Objektnamen FOLDEROBJECT) und der Datei 1604391080966-settings.json (Rechtsseitiges Objekt mit dem Objektnamen FILEOBJECT) vorhanden.
Die angegebene JSON-Datei befindet sich im Ordner statistics, folglich besteht eine Beziehung zwischen Datei und Ordner. Das Linksseitige Objekt ist also immer das Objekt, bei dem die Beziehung startet. Das Rechtsseitige Objekt ist immer das Objekt, zu dem das Linksseitige Objekt eine Beziehung aufbaut.
Hinweis: Sollten Objekte wie Dateien gelöscht worden sein, taucht statt dem Objektnamen die UUID des gelöschten Objekts auf.
Beispiel zu linksseitigen und rechtsseitigen Beziehungen
Folgende Ordner sind vorhanden:
Ein Blick auf Ordner 1.1 verrät, dass Ordner 1 oberhalb / links von Ordner 1.1 steht. D. h. der Ordner 1 ist das linksseitige Objekt aus Sicht des Ordners 1.1, während der Ordner 1.1.1 unterhalb / rechts von Ordner 1.1 steht. Aus Sicht des Ordners 1.1 handelt es sich hierbei also um das rechtsseitige Objekt.
Durch linksseitige und rechtsseitige Beziehungen navigieren
Das folgende Beispiel verdeutlicht das Vorgehen, wie die Navigation durch linksseitige und rechtsseitige Beziehungen funktioniert. Als Ausgangslage und Beispiel dient die Datei Willkomen.pdf, die unter dem Pfad /agorum/roi/Files/Demo liegt.
Sie möchten nun herausfinden, unter welchem Pfad die Datei Willkommen.pdf liegt. Die Datei selbst hat etwa die UUID bb2d5340-51d0-11ec-aa23-080027d70ff8.
Tipps:
• Klicken Sie auf den Pfeil nach rechts, um sich in Richtung des root-Ordners nach links zu bewegen.
• Klicken Sie auf den Pfeil nach links, um sich vom Ordner aus gesehen nach rechts zu bewegen.
Beziehungsarten
Verschiedene Beziehungsarten existieren, um Objekte miteinander in Beziehung zu setzen.
Beziehung | Beschreibung |
---|---|
FOLDERPATHRELATION | Definiert die Relation (Beziehung) für die Darstellung der Objekte als Fileserver.
|
D4WADDRESSFOLDERRELATION | Definiert eine interne Beziehung in einer Adresse. |
D4WAPPCALENDARFOLDERRELATION | Definiert eine interne Beziehung in einem Kalendereintrag. |
AMAILFOLDERPATHRELATION | Definiert eine Beziehung zwischen einem AMailMail und einem AMailFolder (aus dem Mailadapter). |
Die folgenden Beziehungen verbinden Objekte zu einem bestimmten Kontext. Diese Beziehungen sind im Regelfall für die Entwickler von agorum core wichtig. Hier können Sie nachvollziehen, ob Objekte richtig verbunden sind.
Beziehung | Beschreibung |
---|---|
GROUPMEMBERRELATIONOBJECT | Definiert eine interne Beziehung bei Benutzergruppen. |
CHANGEHISTORYRELATIONOBJECT | Definiert eine interne Beziehung bei Historien. |
FOLDERDELETERELATIONOBJECT | Dient für den Serverpapierkorb, sodass dieser das gelöschte Objekt wieder am richtigen Ort herstellen kann. |
ATTACHMENTSRELATIONOBJECT | Definiert ein Objekt, das zu einem anderen Objekt in Beziehung steht (Verknüpfung). |
ANYOBJECTRELATIONOBJECT | Definiert ein intern verwendetes Beziehungsobjekt, das ein Entwickler wählen kann. |
ALLOCATIONRELATIONOBJECT | Definiert ein internes Beziehungsobjekt. |
ATTRIBUTERELATIONOBJECT | Verknüpft ein Objekt mit einem AttributeXmlObject (Metadaten an einem Objekt). |
MAILBODYRELATIONOBJECT | Verknüpft den Mailbody mit der E-Mail. |
MAILATTACHMENTSRELATIONOBJECT | Verknüpft einen E-Mail-Anhang mit einer E-Mail. |
MAILMSGRELATIONOBJECT | Definiert ein internes Beziehungsobjekt (historisch), wird in neuen Systemen nicht mehr verwendet. |
LINKRELATIONOBJECT | Definiert ein internes Beziehungsobjekt (historisch), wird in neuen Systemen nicht mehr verwendet. |
FILERELATIONOBJECT | Definiert ein internes Beziehungsobjekt (historisch), wird in neuen Systemen nicht mehr verwendet. |
MEDIARELATIONOBJECT | Definiert ein internes Beziehungsobjekt (historisch), wird in neuen Systemen nicht mehr verwendet. |
NOTERELATIONOBJECT | Definiert ein internes Beziehungsobjekt (historisch), wird in neuen Systemen nicht mehr verwendet. |
D4WADDRESSEMAILRELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
D4WADDRESSPHONERELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
D4WADDRESSCONTAINERRELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
D4WADDRESSNOTERELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
D4WADDRESSDATARELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
D4WADDRESSLINKRELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
D4WANSWERRELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
DOCUMENTTEXTRELATIONOBJECT | Definiert ein internes Beziehungsobjekt und verbindet ein Objekt mit einem DocumentTextObject. |
D4WADDRESSIMAGERELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
NOTERECIPIENTRELATIONOBJECT | Definiert ein internes Beziehungsobjekt für eine Adresse. |
WORKFLOWRELATION | Definiert ein internes Beziehungsobjekt für den agorum core workflow 1.0, wird in neuen Systemen nicht mehr verwendet. |
PREVIEWIMAGERELATION | Definiert ein internes Beziehungsobjekt und verbindet ein Objekt mit einem PreviewImage. |
PREVIEWOVERLAYRELATION | Definiert ein internes Beziehungsobjekt. |
AGORUMCORESYNCSETTINGSRELATION | Definiert ein internes Beziehungsobjekt (historisch), wird in neuen Systemen nicht mehr verwendet. |
AGORUMCORESYNCSETFOLDRELATION | Definiert ein internes Beziehungsobjekt (historisch), wird in neuen Systemen nicht mehr verwendet. |
AGORUMCOREBACKENDSETRELATION | Definiert ein internes Beziehungsobjekt. Verbindet ein Objekt mit einem Storage. |
D4WADDRESSPERSONRELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
D4WADDRESSUSERRELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
D4WADDRESSMAILINGLISTRELATION | Definiert ein internes Beziehungsobjekt für eine Adresse. |
FIRSTASSOCIATEDRELATIONOBJECT | Definiert ein internes Beziehungsobjekt für eine ACL (historisch), wird in neueren Systemen nicht mehr verwendet. |
GENERICATTARELATIONOBJECT | Definiert ein internes Beziehungsobjekt, wird vom Entwickler unterschiedlich eingesetzt. |
GENERICRELATIONOBJECT | Definiert ein internes Beziehungsobjekt, wird vom Entwickler unterschiedlich eingesetzt. |
ATTRIBUTELOOKUPRELATIONOBJECT | Definiert ein internes Beziehungsobjekt. |
WORKFLOWACTATTARELATION | Definiert ein internes Beziehungsobjekt für den agorum core workflow 1.0, wird in neuen Systemen nicht mehr verwendet. |
PROXYRELATION | Definiert ein internes Beziehungsobjekt. |
Dieser Abschnitt beschreibt, welche Probleme Sie im täglichen Betrieb mit dem agorum core support tool abfangen und wie Sie diese bearbeiten können.
Ein Benutzer meldet, dass eine Datei immer eine falsche Dateiendung erhält, obwohl er sie richtig hochgeladen / geändert hat.
So gehen Sie vor, um nachzuvollziehen, wie die falsche Dateiendung zustande kommt:
Ein Benutzer meldet, dass ein Verzeichnis aus einem Ordner verschwunden ist. Das kann passieren, wenn Ordner oder Dokumente aus Versehen mit der Maus verschoben wurden, indem sie auf eine Stelle klicken, die Maustaste unbewusst halten und gleichzeitig die Maus bewegen. In diesem Falle ist nichts im Serverpapierkorb zu finden, weil das Verzeichnis nur verschoben wurde.
So gehen Sie vor, um nachzuvollziehen, wo das verschobene Verzeichnis zu finden ist:
FOLDEROBJECT,FOLDEROBJECTDadurch geht das System nur noch auf gelöschte Ordner-zu-Ordner-Beziehungen ein.
Wenn Sie sich unsicher sind, ob ein Benutzer Zugriff auf eine Gruppe hat, oder wenn Sie etwa nachvollziehen wollen, warum ein Benutzer Workflow-Aufgaben über eine Gruppenzugehörigkeit erhält, können Sie die direkte Zugehörigkeit zu einer Gruppe überprüfen. Sie können über das Audit-Tool insbesondere auch nachträglich überprüfen, wann und in welchem Zusammenhang ein Benutzer Zugriff bekommen/verloren hat.
Auf ähnliche Weise können Sie auch für ein Benutzerkonto überprüfen, welchen Gruppen es direkt zugeordnet ist:
Im Detailfenster können Sie in der Registerkarte Audit einige Informationen zum markierten Objekt erfahren, ohne das agorum core audit tool verwenden zu müssen.
agorum core schreibt Informationen zu allen Aktionen in die Audittabelle. Über die Audittabelle und die Anzeige im agorum core audit tool können alle Änderungen an Objekten in agorum core nachvollzogen werden.
Hinweis: Die Einträge in der Audittabelle werden nie nachträglich geändert. Wenn eine neue Aktion auf einem Objekt, etwa einem Dokument, durchgeführt wird, wird jeweils ein neuer Eintrag in der Tabelle erzeugt.
Ab Version 11.8 wird agorum core mit einer neuen Audittabelle agorumcoreaudit_v2 ausgeliefert. Diese Tabelle hat weniger Indexe als die alte Audittabelle, benötigt weniger Platz als die alte Audittabelle und belastet daher das System weniger.
Bei der Migration der Daten von der alten in die neue Audittabelle werden die Einträge aus den Tabellen agorumcoreaudit und internalobject in die neue Audittabelle überführt. Es wird nur noch noch eine Tabelle benötigt. Die neue Audittabelle enthält zudem weniger Indexe als die alte Audittabelle.
Die Audittabelle agorumcoreaudit_v2 enthält folgende Spalten:
Spalte | Beschreibung |
---|---|
ID | ID des Audit-Eintrags |
COMMITID | ID des Commits (Datenbanktransaktion). Werden mehrere Objekte in einer Transaktion manipuliert, besitzen alle Operationen dieselbe COMMITID. |
REFERENCEOBJECT | agorum core-Objekt (ID) an, auf das sich der Eintrag bezieht (das verändert wurde). |
OBJECTUUID | UUID des agorum core-Objekts an, auf das sich der Eintrag bezieht (das verändert wurde). |
ACTIONDATE | Zeitpunkt der Aktion (Zeitstempel). |
USERUUID | UUID des Benutzers, der die Aktion vorgenommen hat. |
OBJECTCLASSNAME | Klassenname des Objekts, das betroffen ist (FILEOBJECT, MAILOBJECT, FOLDEROBJECT, …). |
OBJECTNAME | Name des betroffenen Objekts zum Zeitpunkt der Aktion. |
ACTION | Aktion, die das System durchgeführt hat (1 create, 2 update, 3 delete). |
LEFTOBJECTUUID | Gibt bei einer Relation das linksseitige Objekt (UUID) an. Für die Unterschiede zwischen Beziehungen (Relationen) und Objekten siehe Unterschied Objekt vs. Beziehung (Relation). |
RIGHTOBJECTUUID | Gibt bei einer Relation das rechtsseitige Objekt (UUID) an. Für die Unterschiede zwischen Beziehungen (Relationen) und Objekten siehe Unterschied Objekt vs. Beziehung (Relation). |
INFO | Definiert, von wo oder durch welches Protokoll die Aktion durchgeführt wurde (etwa ApiSession = Weboberfläche). |
ATTRIBUTES | Enthält diverse Standard-Attribute aus der Datenbank, die gesetzt / geändert wurden. |
Sie können von der bisher verwendeten auf die neue Tabelle umsteigen, wenn Sie eine Version ab 11.8 installiert haben.
Gehen Sie dazu wie folgt vor:
/Eigene Dateien/Administration/customers/acaudit/js/tools/switch-to-audit-version-2.js
optimize table agorumcoreaudit; optimize table internalobject;
Sie können theoretisch alte Einträge aus der neuen Audittabelle agorumcoreaudit_v2 in eine andere Datenbank auslagern, etwa um Platz zu sparen. Berücksichtigen Sie bei der Entscheidung, ob dies sinnvoll ist, aber unbedingt folgende Hinweise: