Migrationsregeln im Jitterbit App Builder

Migrationsregeln sind Regeln, die ausgeführt werden, wenn eine Version von App Builder auf einem Server installiert wird. Migrationsregeln werden im Business-SQL-Bereich der Business-Logik-Schicht konfiguriert.

Migrationsregeln werden verwendet, um Daten in einer vorhandenen App zu bearbeiten oder zu bereinigen und dienen auch zur Datenmigration nach einer Schema. Migrationsregeln ermöglichen es einem Benutzer, eine Datenbank mit den Aktionen Cram, Löschen, Einfügen oder Aktualisieren zu ändern. Migrationsregeln werden ähnlich wie eine CRUD-Regel definiert und in der Umfeld ausgeführt. Migrationsregeln (im Gegensatz zu CRUD-Regeln) werden zu Änderungsverwaltungsschritten hinzugefügt, die der Reihe nach ausgeführt werden, wenn ein LP in eine neue Umfeld übertragen wird. App Builder zeichnet die Regel auf und führt sie während eines Upgrades aus.

Migrationsregeln sollten spezifisch für eine Ausführung sein. Wenn Sie ähnliche Migrationsregeln zweimal ausführen müssen, empfiehlt es sich, für die zweite Ausführung eine neue Regel zu erstellen. Wenn Sie eine Migrationsregel ausführen (z. B. durch Klicken auf die Schaltfläche Ausführen), erstellt App Builder einen Snapshot der Regel und bettet ihn in das Änderungsset ein. Dem Änderungsset wird erst nach der Ausführung der Migrationsregel etwas hinzugefügt. Nach der Ausführung der Regel kann die Migrationsregel gelöscht werden.

Lernprogramm zu Migrationsregeln

Wichtige Hinweise zu Migrationsregeln

Migrationsregeln unterstützen keine Enumeration.
XP CRUD wird für Migrationsregeln nicht unterstützt.
Daten können nicht mithilfe einer Migrationsregel in/aus verschlüsselten Spalten migriert werden. Entwickler müssen CRUD-Geschäftsregeln verwenden, um Daten in/aus verschlüsselten Spalten zu verschieben.
Derzeit ist es nicht möglich, eine CRUD-Regel zu einer Migrationsregel zu ändern. Andernfalls wird sie nicht ausgelöst.

Migrationsregelaktionen

Die für eine Migrationsregel ausgewählte Aktion richtet sich nach dem Zweck der Regel. Folgende Aktionsoptionen stehen zur Verfügung:

Cram - Fügt eindeutige Datensätze basierend auf den als Primärschlüssel gekennzeichneten Feldern ein.
Delete - Löscht Spalten aus einer Tabelle.
Insert - Erstellt Spalten in einer Tabelle.
Update - Aktualisiert Spalten in einer Tabelle.

Erstellen Sie eine Migrationsregel zum Datencramming

Navigieren Sie zu App Workbench > Regeln.
Bestätigen Sie, dass die ausgewählte App-Datenquelle die Regel enthält.
Klicken Sie auf + Regel.
Vergeben Sie einen Namen für die Migrationsregel. Beispiel: EventDate (EventDate Migration).
Wählen Sie Migration als Zweck.
Legen Sie die Aktion auf Cram fest.
Legen Sie als Ziel die Tabelle fest, mit der aktualisiert werden soll. Beispiel: EventDate.
Klicken Sie auf Speichern.
Klicken Sie auf + Tabellen und fügen Sie die Zieltabelle ein. Beispiel: EventDate.
Fügen Sie im Bereich Spalten den Primärschlüssel, den Ausdruck zur Beschreibung der zu aktualisierenden Daten und das Ziel (die Zielspalte des Ausdrucks) hinzu.
Abhängig von Ihrer Regel benötigen Sie möglicherweise zusätzliche Logik.
Klicken Sie auf Validieren und überprüfen Sie, ob die Informationen den Erwartungen entsprechen (keine Fehler).

Erstellen einer Migrationsregel zum Löschen von Daten

Navigieren Sie zu App Workbench > Regeln.
Bestätigen Sie, dass die ausgewählte App-Datenquelle die Regel enthält.
Klicken Sie auf + Regel.
Weisen Sie der Migrationsregel einen Namen zu. Beispiel: Kontakt (Verwaiste Kontakte löschen).
Wählen Sie Migration als Zweck.
Legen Sie die Aktion auf Löschen fest.
Legen Sie als Ziel die Tabelle fest, mit der aktualisiert werden soll. Beispiel: Kontakt.
Klicken Sie auf Speichern.
Klicken Sie auf + Tabelle und fügen Sie die Zieltabelle hinzu.
Fügen Sie im Bereich Spalten den Primärschlüssel, den Ausdruck zur Beschreibung der zu aktualisierenden Daten und das Ziel (die Zielspalte des Ausdrucks) hinzu.

Wichtig

Der Primärschlüssel muss einem Ziel zugeordnet sein, damit Löschregeln funktionieren. Andernfalls löscht die Regel den gesamten Tabelleninhalt.
Klicken Sie auf Validieren und überprüfen Sie, ob die Informationen den Erwartungen entsprechen (keine Fehler).

Erstellen einer Migrationsregel zum Einfügen von Daten

Migrationsregeln mit dem Aktionstyp Einfügen können neue Spalten in einer Tabelle erstellen. Alle Pflichtfelder der Tabelle, in der eine neue Spalte erstellt wird, müssen der Quelltabelle zugeordnet sein.

Navigieren Sie zu App Workbench > Regeln.
Bestätigen Sie, dass die Regel in der ausgewählten App-Datenquelle hinzugefügt werden soll.
Klicken Sie auf + Regel.
Weisen Sie der Migrationsregel einen Namen zu. Beispiel: Sitzung (Sitzung einfügen).
Wählen Sie Migration als Zweck.
Legen Sie die Aktion auf Einfügen fest.
Legen Sie das Ziel auf die Tabelle fest, mit der aktualisiert werden soll. Beispiel: Sitzung.
Klicken Sie auf Speichern.
Klicken Sie auf + Tabelle und fügen Sie die Zieltabelle ein.
Geben Sie im Bereich Spalten den Ausdruck ein, der beschreibt, was eingefügt werden soll, sowie das Ziel, die Zielspalte für den Ausdruck.
Klicken Sie auf Validieren und überprüfen Sie, ob die Informationen den Erwartungen entsprechen (keine Fehler).

Erstellen einer Migrationsregel zum Aktualisieren von Daten

Navigieren Sie zu App Workbench > Regeln.
Bestätigen Sie, dass die ausgewählte App-Datenquelle die Regel enthält.
Klicken Sie auf + Regel.
Vergeben Sie einen Namen für die Migrationsregel. Beispiel: Reach (AuditID-Migration).
Wählen Sie Migration als Zweck.
Legen Sie die Aktion auf Aktualisieren fest.
Legen Sie als Ziel die Tabelle fest, mit der aktualisiert werden soll. Beispiel: Reach.
Klicken Sie auf Speichern.
Klicken Sie auf + Tabelle und fügen Sie die Zieltabelle hinzu.
Fügen Sie im Bereich Spalten den Primärschlüssel, den Ausdruck zur Beschreibung der zu aktualisierenden Daten und das Ziel (die Zielspalte des Ausdrucks) hinzu.
Klicken Sie auf Validieren und überprüfen Sie, ob die Informationen den Erwartungen entsprechen (keine Fehler).