Die Audit-Historie einer Entität anzeigen

Wenn Sie die vollständige Änderungshistorie eines bestimmten Datensatzes benötigen — eines einzelnen Fahrzeugs, einer Buchung oder eines Fahrers — bietet MobilityManager eine dafür vorgesehene Ansicht der Entitätshistorie. Sie liefert jeden Audit-Eintrag für diesen Datensatz in einem einzigen Aufruf, die neuesten zuerst. Dieser Artikel erläutert, wie Sie sie verwenden.

Erforderliche Berechtigung

Das Anzeigen der Audit-Historie einer Entität erfordert die Berechtigung settings:view. Der Zugriff ist schreibgeschützt und auf Ihren aktuellen Mandanten beschränkt.

So rufen Sie die Historie einer Entität ab

Ermitteln Sie den Entitätstyp des Datensatzes — die Art des Datensatzes, etwa Vehicle, Booking oder Driver.
Ermitteln Sie die Entitäts-ID des Datensatzes — seinen Primärschlüsselwert.
Rufen Sie GET /api/audit/entity/{entityType}/{entityId} auf.

Die Antwort listet alle übereinstimmenden Audit-Einträge auf, geordnet vom neuesten zum ältesten, zusammen mit einer Anzahl, wie viele zurückgegeben wurden.

Was Sie zu jeder Änderung sehen

Jeder Eintrag in der Historie enthält die Aktion (Insert, Update oder Delete), den Zeitstempel in UTC und den Benutzer, der die Änderung vorgenommen hat. Bei Aktualisierungen zeigt der Eintrag genau, welche Spalten sich geändert haben, samt ihrer ursprünglichen und neuen Werte, sodass Sie nachvollziehen können, wie sich der Datensatz Feld für Feld entwickelt hat.

Tipp: Der erste (älteste) Eintrag eines Datensatzes ist in der Regel sein Insert, und der neueste Eintrag steht ganz oben. Wenn Sie von unten nach oben lesen, rekonstruieren Sie das Leben des Datensatzes von der Erstellung bis zu seinem aktuellen Zustand.

Entitätstyp und ID müssen exakt übereinstimmen

Der Entitätstyp wird namensgenau abgeglichen, verwenden Sie also den exakten Typ, wie er im Audit-Trail aufgezeichnet ist (zum Beispiel Vehicle, nicht vehicles). Die Entitäts-ID ist der Primärschlüssel des Datensatzes. Falls einer der beiden Werte nicht übereinstimmt, kommt die Historie leer zurück, anstatt einen Fehler auszulösen.

Hinweis: Anders als die allgemeine Audit-Liste ist die Entitätshistorie nicht seitenweise aufgeteilt — sie gibt die vollständige Menge der Einträge für den Datensatz zurück. Bei sehr aktiven Datensätzen kann dies eine lange Liste sein.

Wann Sie dies anstelle der gefilterten Liste verwenden sollten

Die gefilterte Audit-Liste eignet sich am besten, um über viele Datensätze oder Benutzer hinweg zu stöbern. Die Ansicht der Entitätshistorie eignet sich am besten, wenn Sie den genauen Datensatz bereits kennen und seinen vollständigen, in sich geschlossenen Zeitverlauf in einer einzigen Anfrage wünschen.