Vollständige Prüfung im Jitterbit App Builder
Übersicht
Die Vollständige Prüfung-Funktion in App Builder ist standardmäßig für neu erstellte Datenquellen und Tabellen aktiviert. Full Audit ist eine Auditfunktion, die als Ergänzung zum bestehenden Audit lite hinzugefügt wurde-Funktion. Full Audit zeichnet Änderungen an Ihren Daten auf Unternehmensebene auf und ermöglicht Ihnen, diese Änderungen anzuzeigen. Wenn Full Audit aktiviert ist, wird eine spezielle Prüfprotokolltabelle mit dem Namen App Builder AuditLog wird in Ihrer Datenquelle erstellt. Änderungen werden in der Audit-Log-Tabelle für alle Tabellen erfasst, für die die vollständige Prüfung aktiviert ist.
Standardmäßig App Builder bereinigt oder löscht keine Datensätze, die in der Tabelle „Vollständige Prüfung“ gespeichert sind, automatisch. Wenn Sie dieses Verhalten ändern möchten, lesen Sie die Audit-Konfiguration-Funktion, mit der ein Administratorbenutzer einen Zeitraum konfigurieren kann, für den Daten gespeichert werden. App Builder sollte Prüfdatensätze nach dem festgelegten Zeitrahmen löschen.
Wichtig
Auf die Schaltfläche „Audit“ zum Anzeigen von Audit-Protokollen kann nur über die folgenden Paneltypen zugegriffen werden:
- Formular (Schaltfläche „Audit“ im Panelrahmen)
- Raster (Audit-Symbol neben den Symbolen „Bearbeiten/Löschen“)
CRUD-Regeln erfassen derzeit nicht den vorherigen Wert in der Audit-Tabelle. Wenn die CRUD-Regel durch die Business-Schicht läuft, erfasst Audit sie.
App Builder kann beim Auffüllen der Baseline einen Fehler auslösen, wenn Felder gefunden werden, die Nvarchar(700) oder eine binäre Spalte überschreiten. Als Workaround können Sie überzählige oder binäre Felder manuell aus der vollständigen Prüfung entfernen. Dieses Verhalten wird in einer späteren Version behoben.
Merkmale
Änderungen auf Geschäftsebene
Full Audit erfasst Änderungen auf Geschäftsebene für aktivierte Tabellen. Das heißt, Full Audit zeichnet alle Einfüge-, Aktualisierungs- oder Löschereignisse auf, die durch die Geschäftsebene von App Builder. Dazu gehören:
- Änderungen aus der Anwendungsebene
- CRUD-Geschäftsregeln
Änderungen, die nicht unterstützt werden:
- CRUD-Direktregeln
- Migrationen
- Direkte Datenbankmanipulation
- Gespeicherte Prozeduren
Listenauflösung
Full Audit versucht, Nachschlagewerte aufzuzeichnen, wenn eine Bearbeitung von der UI-Ebene aus mithilfe eines Listensteuerelementtyps vorgenommen wird. Wenn wir beispielsweise eine Bestellseite haben, die ein Listensteuerelement zum Auswählen eines Produkts enthält, werden sowohl die Werte der Schlüssel- als auch der Titelspalte (z. B. Produkt-ID und Produktname) im Audit-Protokoll erfasst.
Fremdschlüsselauflösung
Ähnlich wie bei der Listenauflösung wird bei geprüften Tabellen mit Fremdschlüsseln versucht, deren Werte aufzulösen. CRUD-Geschäftsregeln haben keine zugehörigen Listenkontrollen (sie laufen nicht durch die UI-Ebene), und daher ermöglicht diese Technik Full Audit, weiterhin aufgelöste Titelwerte zu protokollieren. Nehmen wir an, wir haben zwei Tabellen mit den folgenden Spalten:
Bestelltabelle
OrderID
-ProductID
(Fremdschlüssel zur Produkttabelle)
Produkttabelle
ProductID
-Name
(Verwendung der Titelspalte)
Full Audit erkennt den Fremdschlüssel in der Bestelltabelle, wenn Änderungen an Order.ProductID protokolliert werden, und nimmt den Wert „Name“ in der Titelspalte in das Protokoll auf.
Umweltförderung
Um die vollständige Prüfung zu aktivieren, muss die Datenquelle (und die zugehörigen Apps) in der Umfeld konfiguriert und nach oben verschoben werden. Derzeit App Builder unterstützt keine davorlegende-Audit-Konfiguration (z. B. in der Qualitätssicherung oder Produktion, aber nicht in der Entwicklung).
Obwohl die Audit-Tabelle selbst in davorlegende-Umgebungen erstellt wird, werden keine der Audit-Protokolldaten übertragen.
Basisbevölkerung
App Builder ermöglicht es einem Designer, eine Baseline aller Tabellen mit aktivierter Vollprüfung im Prüfprotokoll zu füllen. Dies muss in jeder Umfeld manuell erfolgen. Das Füllen der Baseline kann mehrmals ausgeführt werden. Es werden nur Datensätze gefüllt, für die kein vorheriges Prüfprotokoll vorliegt.
App Builder Beinhaltet vollständiges Audit
Die meisten Tabellen innerhalb App Builder Vollständige Prüfung aktiviert haben. Dadurch können Entwickler Prüfprotokolle für Dinge wie Seiten, Tabellen, Spalten, Steuerelemente, Benachrichtigungsserver usw. anzeigen.
So konfigurieren Sie die vollständige Überwachung in an App Builder App
Der folgende Abschnitt beschreibt, wie Sie die vollständige Prüfung konfigurieren. Die vollständige Prüfung ist für neu erstellte Datenquellen und Tabellen standardmäßig aktiviert.
So aktivieren Sie die vollständige Überwachung für eine Datenquelle
- Navigieren Sie zu App Workbench > klicken Sie auf die Schaltfläche Datenquellen
- Wählen Sie die Datenquelle aus, die Sie konfigurieren möchten
- Klicken Sie auf die Schaltfläche Audit aktivieren
- Klicken Sie auf Fortfahren
So konfigurieren Sie vollständige Überwachungsoptionen für eine Datenquelle
So konfigurieren Sie die Optionen für die vollständige Prüfung für Ihre Datenquelle:
- Navigieren Sie zu App Workbench > klicken Sie auf die Fliese Datenquellen
- Wählen Sie die Datenquelle aus, die Sie konfigurieren möchten
- Klicken Sie auf die Schaltfläche Audit Config
- Nehmen Sie die erforderlichen Änderungen vor und klicken Sie auf Speichern
Vollständiges Audit für eine Tabelle aktivieren
Die vollständige Prüfung ist für Tabellen standardmäßig aktiviert, sofern die Datenquellen diese Funktion aktiviert haben. Falls erforderlich, werden unten die erforderlichen Schritte beschrieben. Nachdem Sie die vollständige Prüfung für eine Datenquelle aktiviert haben, ist die vollständige Prüfung für alle Tabellen standardmäßig aktiviert. App Builder fügt ein AppBuilder AuditRefId
Spalte für alle Tabellen, um die Prüfdaten aufzunehmen.
Bei Bedarf können Sie die vollständige Prüfung für einzelne Tabellen deaktivieren, die nicht geprüft werden sollen. Um die vollständige Prüfung für eine Tabelle zu deaktivieren, klicken Sie manuell auf die Schaltfläche Vollständige Prüfung deaktivieren auf Tabellenebene. Darüber hinaus müssen Sie möglicherweise die AppBuilder AuditRefID
Spalte für jede Tabelle, die keinen einteiligen UUID-Primärschlüssel hat. Es ist eine gute Praxis, auch Migrationsregeln zu überprüfen und zu bereinigen, um das Erstellen und Löschen der AppBuilder AuditRefID
Spalte.
Einteiliger UUID-Primärschlüssel
Für eine Tabelle mit einem einteiligen UUID-Primärschlüssel ist die Aktivierung des vollständigen Audits ganz einfach:
- Navigieren Sie zu App Workbench
- Klicken Sie auf die Fliese Tabellen
- Suchen Sie die Tabelle, für die Sie die vollständige Prüfung aktivieren möchten, und klicken Sie auf das Bleistift-Bearbeitungssymbol
- Klicken Sie im Tabellenbereich auf Mehr > Randfall > Vollständige Prüfung aktivieren
Wenn Sie die vollständige Prüfung für eine Tabelle deaktivieren möchten, folgen Sie den obigen Anweisungen bis Schritt 3, klicken Sie auf Edge Case und dann auf die Schaltfläche Vollständige Prüfung deaktivieren.
Andere Primärschlüsselkonfigurationen
Tabellen, die keinen einteiligen UUID-Primärschlüssel haben, erfordern etwas mehr Arbeit, um Full Audit zu aktivieren. Da Full Audit eine eindeutige UUID pro Tabellendatensatz erfordert, müssen wir eine neue Spalte hinzufügen und ausfüllen. Diese neue Spalte verwendet die Audit
Spaltennutzungstyp.
- Navigieren Sie zu App Workbench
- Suchen Sie in Tabellen die Tabelle, für die Sie die vollständige Prüfung aktivieren möchten
- Klicken Sie auf das Bleistift-Bearbeitungssymbol der Tabelle
-
Klicken Sie im Spaltenbereich auf + Spalte, um eine neue Spalte mit den folgenden Eigenschaften hinzuzufügen:
- Typ:
UUID
. - Nullwerte zulassen:
True
- Automatisch generieren:
True
- Name:
AuditID
(dieser Name kann beliebig sein)
- Typ:
-
Erstellen Sie eine neue Migrationsregel, um die Spalte für Ihre vorhandenen Datensätze zu füllen
- Zweck:
Migration
- Aktion:
Update
- Wählen Sie aus der obigen Tabelle aus und zielen Sie darauf ab.
- Verwenden Sie die MvSQL-Funktion
NewUUID()
als Wert für Ihre AuditID-Spalte
- Zweck:
-
Führen Sie die Migrationsregel aus
-
Navigieren Sie zurück zu den Spaltendetails und legen Sie Folgendes fest:
- Nullwerte zulassen:
False
- Spalte Verwendungstyp:
Audit
- Nullwerte zulassen:
-
Navigieren Sie zur Tabelle und klicken Sie auf Mehr > Randfall > Vollständige Prüfung aktivieren, Fortfahren. App Builder gibt eine Erfolgsmeldung aus, wenn die Aufgabe abgeschlossen ist.
Vollständige Prüfung auf einer Seite aktivieren
Damit Benutzer die vollständigen Prüfprotokolle sehen können, muss im Seitenbereich der Prüflink aktiviert werden:
- Navigieren Sie zu der Seite, auf der Sie die Anzeige des vollständigen Audits aktivieren möchten
- Gehen Sie zur Action Drawer > Live Designer
- Wählen Sie das Panel aus dem Seitenpanel-Layout
- Klicken Sie im Live Edit-Bereich rechts auf die Tab Integriert
- Aktivieren Sie die Option Audit anzeigen
- Kehren Sie zur Anwendungsansicht zurück, aktualisieren Sie den Webbrowser und bestätigen Sie, dass Sie die erwarteten Ergebnisse sehen
Sicherheit
Um auf das vollständige Prüfprotokoll zugreifen zu können, muss der Benutzer:
-
Mindestens eine der folgenden Rollen besitzen:
- App Builder - Rolle
- App Builder - Rolle
-
Lesezugriff auf das im Seitenbereich verknüpfte Datenobjekt haben
- Lesezugriff auf die Zeile selbst haben
Grundlinie füllen
Full Audit unterstützt das Auffüllen einer Baseline für alle Datensätze in geprüften Tabellen. Dadurch werden Audit-Protokolldatensätze mit Populate
als Operation für alle vorhandenen Datensätze in der überwachten Tabelle. Alle bereits für einen Datensatz vorhandenen Überwachungsprotokolle werden nicht dupliziert (es ist also sicher, dies bei Bedarf mehrmals auszuführen).
- Navigieren Sie zu Action Drawer > IDE > Zusätzliche Einstellungen
- Klicken Sie auf die Schaltfläche Audit-Datensätze füllen
- Suchen Sie Ihre App-Datenquelle
- Klicken Sie auf die Schaltfläche Alle auffüllen in der Datenquelle oder auf Auffüllen in einzelnen Tabellen
- Klicken Sie auf Fortfahren. Dadurch wird eine Hintergrundaufgabe gestartet, die ausgeführt wird