Vollständige Audit in Jitterbit App Builder

Übersicht

Die Funktion Vollständige Audit in App Builder ist standardmäßig aktiviert für neu erstellte Datenquellen und Tabellen. Vollständige Audit ist eine Audit-Funktion, die die vorhandene Funktion Audit lite ergänzt. Vollständige Audit erfasst geschäftliche Änderungen an den Daten und ermöglicht es, diese Änderungen anzuzeigen. Wenn Vollständige Audit aktiviert ist, wird eine spezielle Audit-Protokolltabelle namens App BuilderAuditLog in der Datenquelle erstellt. Änderungen werden in der Audit-Protokolltabelle für alle Tabellen erfasst, bei denen Vollständige Audit aktiviert ist.

App Builder bereinigt oder löscht standardmäßig keine Datensätze, die in der Vollständige-Audit-Tabelle gespeichert sind. Wenn dieses Verhalten ändern möchte, siehe die Funktion Audit-Konfiguration, mit der ein Administrator-Benutzer einen Zeitraum konfigurieren kann, für den Daten beibehalten werden sollen. Danach sollte App Builder Audit-Datensätze außerhalb des definierten Zeitraums löschen.

Funktionen

Geschäftliche Änderungen

Vollständige Audit erfasst geschäftliche Änderungen für aktivierte Tabellen. Das heißt, Vollständige Audit erfasst alle Insert-, Update- oder Delete-Ereignisse, die über die Business Layer von App Builder laufen. Dies umfasst:

• Bearbeitungen aus der Application Layer
• CRUD-Geschäftsregeln

Änderungen, die nicht unterstützt werden:

• CRUD-Direktregeln
• Migrationen
• Direkte Datenbankbearbeitung
• Gespeicherte Prozeduren

Listenauflösung

Vollständige Audit versucht, Nachschlagewerte zu erfassen, wenn eine Bearbeitung über die UI Layer mit einem List-Steuerelementtyp vorgenommen wird. Wenn wir beispielsweise eine Bestellseite haben, die ein List-Steuerelement zur Auswahl eines Produkts enthält, werden sowohl die Schlüssel- als auch die Titelspalten-Werte (z. B. ProductID und ProductName) im Audit-Protokoll erfasst.

Fremdschlüsselauflösung

Ähnlich wie bei der Listenauflösung versuchen überwachte Tabellen mit Fremdschlüsseln, ihre Werte aufzulösen. CRUD-Geschäftsregeln haben keine zugeordneten List-Steuerelemente (sie laufen nicht über die UI Layer), und diese Technik ermöglicht es Vollständige Audit, weiterhin aufgelöste Titelwerte zu protokollieren. Angenommen, wir haben zwei Tabellen mit den folgenden Spalten:

Bestelltabelle

• OrderID
• ProductID (Fremdschlüssel zur Produkttabelle)

Produkttabelle

• ProductID
• Name (Titelspalten-Verwendung)

Vollständige Audit erkennt den Fremdschlüssel in der Bestelltabelle beim Protokollieren von Bearbeitungen an Order.ProductID und fügt den Titelspaltenwert „Name" in das Protokoll ein.

Umgebungsförderung

Das Aktivieren von Vollständige Audit erfordert, dass die Datenquelle (und zugehörige Apps) in der Entwicklungsumgebung konfiguriert und nach oben verschoben werden. Derzeit unterstützt App Builder nicht das Konfigurieren von Audit upstream (z. B. in QA oder Produktion, aber nicht in Entwicklung).

Obwohl die Audit-Tabelle selbst in upstream-Umgebungen erstellt wird, werden keine Audit-Protokolldaten übertragen.

Baseline-Auffüllung

App Builder ermöglicht es einem Designer, eine Baseline aller Vollständige-Audit-aktivierten Tabellen im Audit-Protokoll auszufüllen. Dies muss in jeder Umgebung manuell durchgeführt werden. Die Baseline-Auffüllung kann mehrmals ausgeführt werden – nur Datensätze, die kein vorheriges Audit-Protokoll haben, werden aufgefüllt.

App Builder enthält Vollständige Audit

Die meisten Tabellen in App Builder haben Vollständige Audit aktiviert. Dies ermöglicht es Entwicklern, Audit-Protokolle für Dinge wie Seiten, Tabellen, Spalten, Steuerelemente, Benachrichtigungsserver usw. anzuzeigen.

Vollständige Überwachung in einer App Builder-App konfigurieren

Der folgende Abschnitt beschreibt, wie man Vollständige Überwachung konfiguriert. Vollständige Überwachung ist standardmäßig aktiviert für neu erstellte Datenquellen und Tabellen.

Vollständige Überwachung für eine Datenquelle aktivieren

1. Navigiere zu App Workbench > klicke auf die Schaltfläche Data Sources
2. Wähle die Datenquelle aus, die du konfigurieren möchtest
3. Klicke auf die Schaltfläche Enable Audit
4. Klicke auf Proceed

Vollständige Überwachungsoptionen für eine Datenquelle konfigurieren

So konfigurierst du die Optionen für Vollständige Überwachung für deine Datenquelle:

1. Navigiere zu App Workbench > klicke auf die Kachel Data Sources
2. Wähle die Datenquelle aus, die du konfigurieren möchtest
3. Klicke auf die Schaltfläche Audit Config
4. Nimm erforderliche Änderungen vor und klicke auf Save

Vollständige Überwachung für eine Tabelle aktivieren

Vollständige Überwachung ist auf Tabellen standardmäßig aktiviert, wenn sie für die Datenquelle aktiviert ist. Falls erforderlich, werden nachfolgend Schritte bereitgestellt. Nach der Aktivierung von Vollständiger Überwachung auf einer Datenquelle haben alle Tabellen standardmäßig Vollständige Überwachung aktiviert. App Builder fügt eine AppBuilderAuditRefId-Spalte zu allen Tabellen hinzu, um die Überwachungsdaten zu speichern.

Falls erforderlich, kannst du Vollständige Überwachung für einzelne Tabellen deaktivieren, die nicht überwacht werden sollen. Um Vollständige Überwachung auf einer Tabelle zu deaktivieren, klicke manuell auf die Schaltfläche Disable Full Audit auf Tabellenebene. Darüber hinaus musst du möglicherweise die AppBuilderAuditRefID-Spalte für alle Tabellen löschen, die keinen einteiligen UUID-Primärschlüssel haben. Es ist eine bewährte Methode, auch Migrationsregeln zu überprüfen und zu bereinigen, um das Erstellen und Löschen der AppBuilderAuditRefID-Spalte zu vermeiden.

Einteiliger UUID-Primärschlüssel

Für eine Tabelle mit einem einteiligen UUID-Primärschlüssel ist die Aktivierung von Vollständiger Überwachung einfach:

1. Navigiere zu App Workbench
2. Klicke auf die Kachel Tables
3. Suche die Tabelle, für die du Vollständige Überwachung aktivieren möchtest, und klicke auf das Stiftsymbol zum Bearbeiten
4. Klicke im Tabellenpanel auf More > Edge Case > Enable Full Audit

Wenn du Vollständige Überwachung auf einer Tabelle deaktivieren möchtest, folge den obigen Anweisungen bis Schritt 3, klicke auf Edge Case und dann auf die Schaltfläche Disable Full Audit.

Andere Primärschlüsselkonfigurationen

Tabellen, die keinen einteiligen UUID-Primärschlüssel haben, erfordern etwas mehr Aufwand, um Vollständige Überwachung zu aktivieren. Da Vollständige Überwachung eine eindeutige UUID pro Tabellendatensatz erfordert, müssen wir eine neue Spalte hinzufügen und auffüllen. Diese neue Spalte verwendet den Spaltennutzungstyp Audit.

1. Navigiere zu App Workbench
2. Suche die Tabelle, für die du Vollständige Überwachung aktivieren möchtest, unter Tables
3. Klicke auf das Stiftsymbol zum Bearbeiten der Tabelle

4. Klicke auf + Column im Spaltenpanel, um eine neue Spalte mit den folgenden Eigenschaften hinzuzufügen:

   1. Type: UUID.
   2. Allow Nulls: True
   3. Autogenerate: True
   4. Name: AuditID (dieser Name kann beliebig sein)

5. Erstelle eine neue Migration Rule, um die Spalte für deine vorhandenen Datensätze auszufüllen

   1. Purpose: Migration
   2. Action: Update
   3. Wähle deine obige Tabelle als Quelle und Ziel
   4. Verwende die MvSQL-Funktion NewUUID() als Wert für deine AuditID-Spalte

6. Führe die Migrationsregel aus

7. Navigiere zurück zu den Spaltendetails und lege Folgendes fest:

   1. Allow Nulls: False
   2. Spalten-Usage-Typ: Audit

8. Navigiere zur Tabelle und klicke auf More > Edge Case > Enable Full Audit, Proceed. App Builder zeigt eine Erfolgsmeldung an, wenn die Aufgabe abgeschlossen ist.

Vollständige Überwachung auf einer Seite aktivieren

Damit Benutzer Vollständige Überwachungsprotokolle sehen können, muss das Seitenpanel den Audit Link aktivieren:

1. Navigiere zu der Seite, auf der du die Anzeige von Vollständiger Überwachung aktivieren möchtest
2. Gehe zu Action Drawer > Live Designer
3. Wähle das Panel aus dem Seitenpanel-Layout
4. Klicke in der Live Edit-Region auf der rechten Seite auf die Registerkarte Built-In
5. Aktiviere das Kontrollkästchen für Show Audit
6. Kehre zur Anwendungsansicht zurück, aktualisiere den Webbrowser und bestätige, dass du die erwarteten Ergebnisse siehst

Sicherheit

Um auf das vollständige Audit-Protokoll zuzugreifen, muss der Benutzer:

• Mindestens einer der folgenden Rollen angehören:

  • App Builder - Administratoren-Rolle
  • App Builder - Audit-Rolle

• Lesezugriff auf das im Seitenpanel verknüpfte Datenobjekt haben

• Lesezugriff auf die Zeile selbst haben

Baseline auffüllen

Full Audit unterstützt das Auffüllen einer Baseline für alle Datensätze in auditierten Tabellen. Dies schreibt Audit-Protokolldatensätze mit Populate als Operationsname für alle vorhandenen Datensätze in der auditierten Tabelle. Alle Audit-Protokolle, die bereits für einen Datensatz vorhanden sind, werden nicht dupliziert (daher ist es sicher, dies mehrmals auszuführen, falls erforderlich).

1. Navigiere zu Action Drawer > IDE > Additional Settings
2. Klicke auf die Schaltfläche Populate Audit Records
3. Suche deine App-Datenquelle
4. Klicke auf die Schaltfläche Populate All in der Datenquelle oder auf „Populate" für einzelne Tabellen
5. Klicke auf Proceed, dies startet eine Hintergrundaufgabe

Fehlerbehebung

Weitere Informationen zur Fehlerbehebung findest du im App Builder-Leitfaden zur Fehlerbehebung:

• Audit-Protokoll-Baseline kann nicht aufgefüllt werden