Invoke Operation (Beta) Tool in Jitterbit Studio

Einführung

Das Invoke Operation (Beta) Tool ist eine Projektkomponente, die als Schritt in einer Operation verwendet wird, um eine bestimmte Operation auszuführen, die im aktuellen Projekt existiert. Es kann überall dort als Operationsschritt verwendet werden, wo ein Skript als Operationsschritt eingesetzt werden kann.

Erstellen einer Invoke Operation Instanz

Eine neue Instanz eines Invoke Operation (Beta) Tools kann von diesen Standorten aus erstellt werden:

• Der Komponenten-Registerkarte im Projektbereich über das Menü Neu erstellen (siehe Aktionenmenü der Komponenten-Registerkarte in Projektbereich Komponenten-Registerkarte).

• Der Tools-Registerkarte der Design-Komponentenpalette (siehe Tools in Design-Komponentenpalette).

Ein vorhandenes Invoke Operation (Beta) Tool kann von diesen Standorten aus bearbeitet werden:

• Der Design-Leinwand (siehe Aktionenmenü der Komponenten in Design-Leinwand).

• Der Komponenten-Tab im Projektbereich (siehe Aktionen-Menü für Komponenten im Projektbereich Komponenten-Tab).

Konfigurieren eines Invoke Operation-Tools

Der Konfigurationsbildschirm für Invoke Operation (Beta) enthält diese Felder und Aktionen:

• Name: Geben Sie einen Namen ein, um die Instanz des Invoke Operation (Beta)-Tools zu identifizieren.

• Verwende den Operationsnamen: Wenn ausgewählt, entspricht der Name der Instanz des Invoke Operation (Beta)-Tools dem Namen der im Feld Operation ausgewählten Operation. Das Feld Name wird deaktiviert und passt sich automatisch dem Operationsnamen an, wenn dieser geändert wird:

  

  Hinweis

  Wenn mehrere Instanzen des Invoke Operation (Beta)-Tools dieselbe Operation aufrufen, kann nur eine den genauen Namen der Operation verwenden. Dies liegt an den Validierungsregeln für Projektkomponenten von Studio. Die Option Verwende den Operationsnamen wird in anderen Tool-Instanzen, die dieselbe Operation aufrufen, deaktiviert. Ein Tooltip beschreibt den Grund.

• Operation: Verwenden Sie das Menü, um eine Operation im aktuellen Projekt auszuwählen.

• Ausführungstyp: Wählen Sie aus, ob nachgelagerte Operationen synchron oder asynchron ausgeführt werden:

  • Synchron: Wenn ausgewählt, wird die aufgerufene (untergeordnete) Operation oder Operationskette sequenziell von der aufrufenden (übergeordneten) Operation ausgeführt.

  • Asynchron: Wenn ausgewählt, wird die aufgerufene (untergeordnete) Operation oder Operationskette gleichzeitig mit der aufrufenden (übergeordneten) Operation ausgeführt.

  Für weitere Informationen siehe Synchronicität.

• Fehlerbehandlung: Diese Optionen zur Fehlerbehandlung sind aktiviert, wenn Synchron als Ausführungstyp ausgewählt ist:

  • Fehler auslösen, wenn die Operation fehlschlägt: Wenn ausgewählt und die aufgerufene Operation fehlschlägt, schlägt die initiierende Operation (in der sich das Invoke Operation (Beta)-Tool befindet) fehl und stoppt die Verarbeitung. Die Verarbeitung wird für alle On Fail Betriebsaktionen fortgesetzt, die für die initiierende Operation konfiguriert sind.

    Eine fatale Fehlermeldung wird in die Protokollnachrichten der initiierenden Operation geschrieben, die von den Betriebsprotokollen oder dem Nachrichtentab der Runtime Operations Seite eingesehen werden kann:

    Fatal Error <message> Dieser Fehler wurde durch einen Aufruf der RaiseError-Funktion ausgelöst.
    

  • Betriebsablauf abbrechen, wenn die Operation fehlschlägt: Wenn ausgewählt und die aufgerufene Operation fehlschlägt, wird die initiierende Operation (in der sich das Invoke Operation (Beta)-Tool befindet) fortgesetzt. Die Verarbeitung wird nach Abschluss dieser Operation gestoppt und nicht für alle On Fail oder On Success Betriebsaktionen fortgesetzt, die für die initiierende Operation konfiguriert sind.

  Wichtig

  Wenn beide Fehlerbehandlungsoptionen aktiviert sind, wird ein Fehler für die initiierende Operation ausgelöst und es erfolgt keine weitere Verarbeitung in der initiierenden Operation oder in den verketteten Operationen durch die konfigurierten On Fail-Aktionen.

• Änderungen speichern: Nachdem Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen wurden, klicken Sie auf Speichern und schließen Sie die Konfiguration.

• Änderungen verwerfen: Nachdem Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen wurden, klicken Sie auf Schließen, ohne die Konfiguration zu speichern. Eine Nachricht fordert Sie auf, zu bestätigen, dass Sie die Änderungen verwerfen möchten.

Sobald konfiguriert, wird die Invoke Operation (Beta)-Instanz nach dem Namen der Operation benannt, die sie aufruft.

Aktionen

Die Aktionsleiste für ein Invoke Operation (Beta)-Tool hat folgende Aktionen:

Synchronizität

Operationen, die mit dem Invoke Operation (Beta) Tool oder der RunOperation-Funktion aufgerufen werden, laufen standardmäßig synchron, können jedoch konfiguriert werden, um bei Bedarf asynchron als Teil einer Operationskette ausgeführt zu werden.

• Synchron: Die aufgerufene (Kind-)Operationenkette läuft sequenziell von der aufrufenden (Eltern-)Operation. Die Agentengruppe wartet darauf, dass die aufgerufene Operationenkette abgeschlossen ist, bevor sie die nächsten Schritte in der aufrufenden Operationenkette verarbeitet:

• Asynchron: Die aufgerufene (Kind-)Operationenkette läuft gleichzeitig mit der aufrufenden (Eltern-)Operation. Die Agentengruppe verarbeitet die Schritte in der aufrufenden Operationenkette weiter, während sie unabhängig die aufgerufene Operationenkette bearbeitet. Es gibt keine Garantie, welche Operation oder Kette zuerst abgeschlossen wird:

Wenn es zwei oder mehr Agenten in einer Gruppe gibt, können mehrere Agenten in der Gruppe an der Verarbeitung ganzer Operationenkette beteiligt sein. Um die Zeitersparnis, die asynchrone Aufrufe für Workflows bringen können, zu nutzen, sind zwei oder mehr Agenten erforderlich.

Konfigurationsoptionen

Bestimmte Optionen bezüglich der Synchronität von Operationenkette können im Abschnitt [Operation Engine] der Datei jitterbit.conf konfiguriert werden.

Zusätzlich kann die jitterbit.operation.max_async_chain_length-Variable verwendet werden, um den Wert MaxAsyncOperationChainLength der Datei jitterbit.conf zu überschreiben, vorausgesetzt, dass MaxAsyncOperationChainLengthOverrideAllowed auf true gesetzt ist.