Ereignis-Aktionstypen im Jitterbit App Builder

Der App Builder unterstützt viele verschiedene Ereignis-Aktionstypen, die für Aktionen definiert werden können, die mit Ereignissen verbunden sind, abhängig von der beabsichtigten Verwendung der Aktion. Diese Seite beschreibt die verschiedenen Aktionstypen und wie Sie mit ihnen arbeiten können.

Um auf die verschiedenen Ereignis-Aktionstypen zuzugreifen:

1. Wählen Sie App Workbench > Regeln.

2. Suchen Sie die Tabelle (oder Regel), in der Sie eine Aktion definieren möchten, und klicken Sie auf das entsprechende Ereignisse-Symbol. Der Dialog Alle Ereignisse öffnet sich.

3. Wählen Sie das intrinsische oder angepasste Ereignis aus, das die Aktion auslösen soll, indem Sie auf die entsprechende Zeile doppelklicken. Ein Dialog öffnet sich.

4. Wählen Sie im Panel Aktionen Registrieren und konfigurieren Sie den Aktionstyp im sich öffnenden Aktion-Dialog (siehe Abbildung).

   

Es stehen neun Aktionstypen zur Verfügung, die in Basis und Randfälle unterteilt sind. Der Standardaktionstyp ist Regel, da er am häufigsten verwendet wird. Die grundlegenden Aktionstypen, Regeln und Benachrichtigungen, sind separat dokumentiert, während diese Seite die verbleibenden Typen dokumentiert.

Aktionstypen:

• Basis

  • Regel

  • Benachrichtigung

• Randfälle

  • API-Aufruf

  • Ereignis

  • Export

  • Import

  • Plugin

  • Prozedur

  • RFC (Remote Function Call)

API-Aufruf

Verwenden Sie den Aktionstyp API-Aufruf, um einen API-Manager oder REST-Endpunkt als Aktion aufzurufen. Um eine API-Aufruf-Aktion zu konfigurieren, greifen Sie auf den Aktion-Dialog zu, wie oben beschrieben, und konfigurieren Sie diese Felder:

• Typ: Auf API-Aufruf setzen.

• Endpunkt: Wählen Sie den benannten Endpunkt aus, der mit der Aktion aufgerufen werden soll.

• Bezeichnung: (Optional) Geben Sie eine Bezeichnung (max. 30 Zeichen) ein, die im Ereignisdiagramm angezeigt werden soll. Wenn keine Bezeichnung angegeben wird, wird der Endpunktname verwendet.

• Position

  • Order: Geben Sie einen Wert ein, um die Reihenfolge der Ausführung bei der Ausführung eines Ereignisses zu steuern.

  • Active: Standardmäßig aktiviert, bestimmt diese Option, ob die Aktion ausgeführt wird.

  • When: Stellen Sie auf Before oder After ein, um zu bestimmen, wann die Aktion ausgeführt werden soll.

• Technical Help: (Optional) Geben Sie eine Beschreibung der Verantwortlichkeiten und des Verhaltens der Aktion ein, um anderen Entwicklern zu helfen.

Um die Aktionserstellung abzuschließen, klicken Sie auf Save.

Event

Verwenden Sie den Aktionstyp Event, um ein anderes benanntes Ereignis auszuführen. Um eine Event-Aktion zu konfigurieren, greifen Sie auf den Action-Dialog zu, wie oben beschrieben, und konfigurieren Sie diese Felder:

• Type: Stellen Sie auf Event ein.

• Rule: Wählen Sie die Regel aus, die die Aktion ausführen wird.

• Event: Wählen Sie das Ereignis aus, das die Aktion auslösen wird.

• Treat Validation Warnings As Errors: Standardmäßig aktiviert. Deaktivieren Sie diese Option, wenn Sie dem aufgerufenen Ereignis erlauben möchten, Warnvalidierungen zu erhalten, auf die der Benutzer entschieden hat, fortzufahren, aber alle Aktionen vor dieser werden erneut ausgeführt. Um dies zu verhindern, ziehen Sie in Betracht, die gleiche Validierung im aktuellen (aufrufenden) Ereignis hinzuzufügen.

• Label: (Optional) Geben Sie ein Label (max. 30 Zeichen) ein, das im Ereignisdiagramm angezeigt werden soll. Wenn kein Label angegeben ist, wird der Zielereignisname verwendet.

• Position

  • Order: Geben Sie einen Wert ein, um die Reihenfolge der Ausführung bei der Ausführung eines Ereignisses zu steuern.

  • Active: Standardmäßig aktiviert, bestimmt diese Option, ob die Aktion ausgeführt wird.

  • When: Stellen Sie auf Before oder After ein, um zu bestimmen, wann die Aktion ausgeführt werden soll.

• Technische Hilfe: (Optional) Geben Sie eine Beschreibung der Verantwortlichkeiten und des Verhaltens der Aktion ein, um anderen Entwicklern zu helfen.

Um die Erstellung der Aktion abzuschließen, klicken Sie auf Speichern.

Export

Verwenden Sie den Aktionstyp Export, um einen Bericht in eine Datei zu exportieren. Diese Aktion exportiert eine Datei, schreibt sie mit Kommas, Pipes oder Tabs als Trennzeichen und speichert sie dann am gewünschten Ort. Um eine Export-Aktion zu konfigurieren, greifen Sie auf den Aktion-Dialog zu, wie oben beschrieben, und konfigurieren Sie diese Felder:

• Typ: Auf Export setzen.

• Regel: Wählen Sie die Regel aus, die die Aktion ausführen wird.

• Dateisystem: Wählen Sie aus, wo die exportierten Informationen gespeichert werden sollen. Dies kann ein lokales oder ein Netzwerk-Dateisystem sein.

• Trennzeichen: Wählen Sie aus, welches Trennzeichen (Kommas, Pipes oder Tabs) für die Datei verwendet werden soll.

• Ausgabe-Header: Aktivieren Sie diese Option, wenn die exportierte Datei eine Kopfzeile enthält. Standardmäßig deaktiviert.

• Dateiname-Spalte: Wählen Sie die Dateiname-Spalte aus der referenzierten Geschäftsregel oder Tabelle aus.

• Bezeichnung: (Optional) Geben Sie eine Bezeichnung (maximal 30 Zeichen) ein, die im Ereignisdiagramm angezeigt werden soll. Wenn keine Bezeichnung angegeben ist, wird der Regelname verwendet.

• Position

  • Reihenfolge: Geben Sie einen Wert ein, um die Reihenfolge der Ausführung bei der Ausführung eines Ereignisses zu steuern.

  • Aktiv: Standardmäßig aktiviert, bestimmt diese Option, ob die Aktion ausgeführt wird.

  • Wann: Auf Vor oder Nach setzen, um zu bestimmen, wann die Aktion ausgeführt werden soll.

• Technische Hilfe: (Optional) Geben Sie eine Beschreibung der Verantwortlichkeiten und des Verhaltens der Aktion ein, um anderen Entwicklern zu helfen.

Um die Erstellung der Aktion abzuschließen, klicken Sie auf Speichern.

Import

Verwenden Sie den Aktionstyp Import, um Daten von einem Dateisystem in eine oder mehrere Tabellen zu importieren. Sie können CSV-, Excel- oder HL7-Dateien importieren. Um eine Import-Aktion zu konfigurieren, greifen Sie auf den Aktion-Dialog zu, wie oben beschrieben, und konfigurieren Sie diese Felder:

• Typ: Auf Import setzen.

• Importtyp: Wählen Sie den Typ der zu importierenden Datei aus, entweder CSV oder Excel oder HL7.

• Truncate: (Optional) Aktivieren Sie diese Option, wenn Sie möchten, dass der App Builder den Inhalt der Zieltabelle beim Import löschen soll. Standardmäßig deaktiviert.

• File System: Wählen Sie aus, wo die importierten Informationen gespeichert werden sollen. Dies kann ein lokales oder ein Netzwerk-Dateisystem sein.

• Target Table: Wählen Sie die benannte Tabelle aus, in der die importierte Datei gespeichert wird.

• Delimiter: Wählen Sie aus, welches Trennzeichen (Kommas, Pipes oder Tabs) für die Datei verwendet werden soll.

• Completed Data Source: Wählen Sie den Speicherort der Datei aus, zu dem die Importdatei verschoben wird. Lassen Sie dieses Feld leer, wenn es dasselbe wie das File System ist.

• Label: (Optional) Geben Sie ein Label (maximal 30 Zeichen) ein, das im Ereignisdiagramm angezeigt werden soll. Wenn kein Label angegeben wird, wird der Tabellenname verwendet.

• Position

  • Order: Geben Sie einen Wert ein, um die Reihenfolge der Ausführung beim Ausführen eines Ereignisses zu steuern.

  • Active: Standardmäßig aktiviert, bestimmt diese Option, ob die Aktion ausgeführt wird.

  • When: Stellen Sie auf Before oder After ein, um zu bestimmen, wann die Aktion ausgeführt werden soll.

• Technical Help: (Optional) Geben Sie eine Beschreibung der Verantwortlichkeiten und des Verhaltens der Aktion ein, um anderen Entwicklern zu helfen.

Um die Aktionserstellung abzuschließen, klicken Sie auf Save.

Plugin

Verwenden Sie den Plugin-Aktionstyp, um ein Aktions-Plugin im App Builder aufzurufen. Um eine Plugin-Aktion zu konfigurieren, greifen Sie auf den Action-Dialog zu, wie oben beschrieben, und konfigurieren Sie diese Felder:

• Type: Stellen Sie auf Plugin ein.

• Plugin: Wählen Sie das Plugin aus, das die Aktion ausführen wird. Die verfügbaren Plugins sind:

  • Clear Endpoint Cache: Löscht den Cache des Endpunkts, der aus vorherigen Aktionen generiert wurde.

  • Commit Event Transactions: Bestätigt alle offenen Transaktionen des übergeordneten Ereignisses (direkt im Ereignis oder in einem seiner übergeordneten Ereignisse).

  • Create Row on Empty Table: Erstellt eine neue Zeile, wenn das Filter-Ereignis keine Zeilen zurückgibt.

  • Http Retriever: Ruft Inhalte aus der URL-Spalte ab und speichert sie in der Result-Spalte.

  • JWT Generator: Generiert ein JSON Web Token (JWT).

  • Persistable – Refresh Row: Aktualisiert eine Zeile.

  • Persistable Salesforce – Refresh Rw: Aktualisiert eine Zeile.

  • Pluralize Name: Pluralisiert und humanisiert ein Name-Feld.

  • Run Background Event: Führt das Background-Ereignis für das Datenobjekt (im Hintergrund) aus.

  • Save Report: Speichert den Bericht im PDF-Verzeichnis.

  • Security Provider Hash Password: Hashes den Wert der Password-Spalte mit einem bestimmten Sicherheitsanbieter.

  • Security Provider Password Hash Verifier: Überprüft ein gehashtes Passwort mit einem bestimmten Sicherheitsanbieter.

  • Sleep: Pausiert entweder für eine Sekunde oder einen benutzerdefinierten Timeout-Zeitraum (in Millisekunden).

  • SMTP Mailer: Sendet Emails unter Verwendung von Email, Subject und optionalen Feldern Body und From. Eine Substitution mit {{ field }} ist innerhalb des Body und Subject verfügbar.

  • Throw Exception: Wirft eine Ausnahme.

• Label: (Optional) Geben Sie ein Label (maximal 30 Zeichen) ein, das im Ereignisdiagramm angezeigt werden soll. Wenn kein Label angegeben wird, wird der Plugin-Name verwendet.

• Position

  • Order: Geben Sie einen Wert ein, um die Reihenfolge der Ausführung zu steuern, wenn sie in einem Ereignis ausgeführt wird.

  • Active: Standardmäßig aktiviert, bestimmt diese Option, ob die Aktion ausgeführt wird.

  • When: Stellen Sie auf Before oder After ein, um zu bestimmen, wann die Aktion ausgeführt werden soll.

• Technical Help: (Optional) Geben Sie eine Beschreibung der Verantwortlichkeiten und des Verhaltens der Aktion ein, um anderen Entwicklern zu helfen.

Um die Aktionserstellung abzuschließen, klicken Sie auf Save.

Procedure

Verwenden Sie den Aktionstyp Procedure, um eine RDBMS (Relational Database Management System) gespeicherte Prozedur auszuführen. Um eine Procedure-Aktion zu konfigurieren, greifen Sie auf den Action-Dialog zu, wie oben beschrieben, und konfigurieren Sie dann diese Felder:

• Typ: Setzen Sie auf Plugin.

• Verfahren: Wählen Sie das gespeicherte Verfahren aus, das ausgeführt werden soll.

• Bezeichnung: (Optional) Geben Sie eine Bezeichnung (max. 30 Zeichen) ein, die im Ereignisdiagramm angezeigt wird.

• Position

  • Reihenfolge: Geben Sie einen Wert ein, um die Reihenfolge der Ausführung bei der Ausführung eines Ereignisses zu steuern.

  • Aktiv: Standardmäßig aktiviert, bestimmt diese Option, ob die Aktion ausgeführt wird.

  • Wann: Setzen Sie auf Vor oder Nach, um zu bestimmen, wann die Aktion ausgeführt werden soll.

• Technische Hilfe: (Optional) Geben Sie eine Beschreibung der Verantwortlichkeiten und des Verhaltens der Aktion ein, um anderen Entwicklern zu helfen.

Um die Aktionserstellung abzuschließen, klicken Sie auf Speichern.

RFC (Remote Function Call)

Verwenden Sie den Aktionstyp RFC, um einen Remote Function Call auszuführen. RFCs werden hauptsächlich verwendet, wenn extern mit SAP gearbeitet wird und um RFC BABI-Aufrufe und RFC-Tabellenlesungen zu konfigurieren. Um eine RFC-Aktion zu konfigurieren, greifen Sie auf das Aktions-Dialogfeld zu, wie oben beschrieben, und konfigurieren Sie diese Felder:

• Typ: Setzen Sie auf RFC.

• RFC: Wählen Sie die Funktion aus, die aufgerufen werden soll.

• Bezeichnung: (Optional) Geben Sie eine Bezeichnung (max. 30 Zeichen) ein, die im Ereignisdiagramm angezeigt wird.

• Position

  • Reihenfolge: Geben Sie einen Wert ein, um die Reihenfolge der Ausführung bei der Ausführung eines Ereignisses zu steuern.

  • Aktiv: Standardmäßig aktiviert, bestimmt diese Option, ob die Aktion ausgeführt wird.

  • Wann: Setzen Sie auf Vor oder Nach, um zu bestimmen, wann die Aktion ausgeführt werden soll.

• Technische Hilfe: (Optional) Geben Sie eine Beschreibung der Verantwortlichkeiten und des Verhaltens der Aktion ein, um anderen Entwicklern zu helfen.

Um die Aktionserstellung abzuschließen, klicken Sie auf Speichern.