Migrationsregeln im Jitterbit App Builder

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

Migrationsregeln werden verwendet, um Daten in einer vorhandenen App zu bearbeiten oder zu bereinigen und werden auch zum Migrieren von Daten nach einer Schema verwendet. 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 (d. h. auf die Schaltfläche Ausführen für eine Migrationsregel klicken), App Builder macht einen Snapshot der Regel und bettet ihn in den Änderungssatz ein. Dem Änderungssatz wird nichts hinzugefügt, bis die Migrationsregel ausgeführt wurde. Nach der Ausführung der Regel kann die Migrationsregel gelöscht werden.

Lernprogramm zu Migrationsregeln

Wichtige Hinweise zu Migrationsregeln

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

Migrationsregelaktionen

Die für eine Migrationsregel ausgewählte Aktion hängt davon ab, was die Regel bewirken soll. Aktionsoptionen sind:

Cram - fügt eindeutige Datensätze basierend auf den als Primärschlüssel markierten Feldern ein
Delete - löscht Spalten aus einer Tabelle
Insert - erstellt Spalten innerhalb einer Tabelle
Update - aktualisiert Spalten innerhalb einer Tabelle

Erstellen einer Migrationsregel zum Crammen von Daten

Navigieren Sie zu App Workbench > Regeln
Bestätigen Sie, dass die ausgewählte App-Datenquelle diejenige ist, der Sie die Regel hinzufügen möchten
Klicken Sie auf + Regel
Weisen Sie der Migrationsregel einen Namen zu. Beispiel: EventDate (EventDate Migration)
Wählen Sie Migration als Zweck
Legen Sie die Aktion auf Cram fest
Legen Sie das Ziel auf die Tabelle fest, die 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 dessen, was aktualisiert wird, sowie das Ziel, das die Zielspalte für den Ausdruck ist, hinzu
Abhängig von Ihrer Regel müssen Sie möglicherweise zusätzliche Logik definieren
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 diejenige ist, der Sie die Regel hinzufügen möchten
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 das Ziel auf die Tabelle fest, die aktualisiert werden soll. Beispiel: Kontakt
Klicken Sie auf Speichern
Klicken Sie auf + Tabelle und fügen Sie die Zieltabelle ein
Fügen Sie im Bereich Spalten den Primärschlüssel, den Ausdruck zur Beschreibung dessen, was aktualisiert wird, sowie das Ziel, das die Zielspalte für den Ausdruck ist, hinzu.

Wichtig

Der Primärschlüssel muss einem Ziel zugeordnet sein, damit Löschregeln funktionieren, sonst löscht die Regel alles in der Tabelle.
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 erforderlichen Felder für die Tabelle, in der eine neue Spalte erstellt wird, müssen aus der Quelltabelle zugeordnet werden.

Navigieren Sie zu App Workbench > Regeln
Bestätigen Sie, dass die ausgewählte App-Datenquelle diejenige ist, der Sie die Regel hinzufügen möchten
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 wird, zusammen mit dem Ziel, das die Zielspalte für den Ausdruck ist
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 diejenige ist, der Sie die Regel hinzufügen möchten
Klicken Sie auf + Regel
Weisen Sie der Migrationsregel einen Namen zu. Beispiel: Reach (AuditID-Migration)
Wählen Sie Migration als Zweck
Legen Sie die Aktion auf Aktualisieren fest
Legen Sie das Ziel auf die Tabelle fest, gegen die aktualisiert werden soll. Beispiel: Reach
Klicken Sie auf Speichern
Klicken Sie auf + Tabelle und fügen Sie die Zieltabelle ein
Fügen Sie im Bereich Spalten den Primärschlüssel, den Ausdruck zur Beschreibung dessen, was aktualisiert wird, sowie das Ziel, das die Zielspalte für den Ausdruck ist, hinzu
Klicken Sie auf Validieren und überprüfen Sie, ob die Informationen wie erwartet sind (keine Fehler)