Audit-Einträge anzeigen und filtern

Der Audit-Trail kann sehr umfangreich werden, daher können Sie in MobilityManager Einträge filtern und seitenweise durchblättern, um die für Sie relevanten Änderungen zu finden. Dieser Artikel erläutert die verfügbaren Filter, wie die Seitennavigation funktioniert und wie Sie einen einzelnen Eintrag öffnen.

Erforderliche Berechtigung

Das Anzeigen von Audit-Einträgen erfordert die Berechtigung settings:view. Jeglicher Audit-Zugriff ist schreibgeschützt und auf Ihren aktuellen Mandanten beschränkt.

Einträge auflisten

Fordern Sie die Audit-Liste über GET /api/audit an. Die Ergebnisse werden mit den neuesten zuerst (nach Zeitstempel) zurückgegeben, zusammen mit der Gesamtzahl der übereinstimmenden Einträge, damit Sie Steuerelemente für die Seitennavigation aufbauen können.

Verfügbare Filter

Kombinieren Sie beliebige dieser Abfrageparameter, um die Ergebnisse einzugrenzen:

Filter	Zweck
`entityType`	Nur Änderungen an einem bestimmten Datensatztyp, zum Beispiel `Vehicle` oder `Booking`.
`entityId`	Nur Änderungen an einem bestimmten Datensatz, identifiziert über seinen Primärschlüssel.
`action`	Nur eine bestimmte Aktion: `Insert`, `Update` oder `Delete`.
`userEmail`	Nur Änderungen, die von der E-Mail-Adresse eines bestimmten Benutzers vorgenommen wurden.
`userId`	Nur Änderungen, die von einer bestimmten Benutzer-ID vorgenommen wurden.
`fromDate` / `toDate`	Einschränkung auf einen Datums- und Uhrzeitbereich (einschließlich).

Durch die Ergebnisse blättern

Zwei Parameter steuern die Seite:

skip — wie viele Einträge übersprungen werden sollen; Standardwert ist 0.
take — wie viele Einträge zurückgegeben werden sollen; Standardwert ist 50 und ist auf 100 begrenzt.

Um durch die Seiten zu navigieren, erhöhen Sie skip bei jeder Anfrage um Ihre Seitengröße. Vergleichen Sie die laufende Gesamtzahl der abgerufenen Einträge mit der gemeldeten Gesamtanzahl, um zu erkennen, wann Sie das Ende erreicht haben.

Hinweis: Ein take, das größer als 100 angefordert wird, gibt nicht mehr als 100 Einträge zurück — die Seitengröße ist aus Leistungsgründen begrenzt.

Einen einzelnen Eintrag öffnen

Wenn Sie die numerische ID eines Eintrags haben, rufen Sie genau diesen Eintrag mit GET /api/audit/{auditEntryId} ab. Die Antwort enthält alle Details: alte und neue Werte sowie die geänderten Spalten bei Aktualisierungen. Falls die ID nicht existiert, gibt die Anfrage "Audit entry not found" zurück.

Tipp: Um den vollständigen Zeitverlauf eines Datensatzes zu untersuchen, filtern Sie sowohl nach entityType als auch nach entityId, oder verwenden Sie die dafür vorgesehene Ansicht der Entitätshistorie.