Erstellen und Konfigurieren einer Operation im Jitterbit Integration Studio

Einführung

Eine Operation ist die kleinste Einheit innerhalb eines Workflow, die unabhängig auf einem Agenten ausgeführt und von Harmony aufgezeichnet wird. Mit Operationen wird definiert, was ein Integrationsprozess tun soll und wann dies geschehen soll.

Operationen bestehen aus einer Kombination von Aktivitäten und Tools:

Die spezifische Kombination und Reihenfolge dieser Komponenten muss den gültigen Mustern entsprechen. Details zu diesen Mustern finden Sie unter Operation Validity.

Auf dieser Seite werden die Bestandteile einer Operation erläutert. Anschließend werden das Hinzufügen von Schritten zu Operationen, der Zugriff auf Menüoptionen, das Umbenennen von Operationen, das Erweitern/Reduzieren von Operationen, das Neuanordnen von Operationen und das Wiederverwenden, Entfernen oder Verschieben von Operation behandelt.

Teile einer Operation

Operationen werden durch die Anordnung von Aktivitäten und Werkzeugen gestaltet. innerhalb einer Operation auf der Design-Canvas. Die Operation kann aus nur einem einzigen Script bestehen oder eine Abfolge von Schritten bilden, die aus einer oder mehreren Aktivitäten oder Werkzeugen besteht. Die zulässigen Kombinationen sind in Operationsgültigkeit beschrieben.

Aktivitäten

Eine Aktivität ist eine Komponente, die aus einer Verbindung erstellt wird und für die Interaktion mit einem Endpoint konfiguriert werden kann. Aktivitäten können in einer Operation entweder als Quelle oder als Ziel verwendet und mit Datenschemata konfiguriert werden, die die Anforderungs- und Antwortschemata für die Interaktion mit dem Endpoint darstellen. Neben der Verwendung als Operation Schritt können einige Aktivitäten auch in Scripts referenziert werden (siehe Endpoints in Jitterbit Script).

Weitere Informationen zu den Grundlagen von Konnektoren sowie Ressourcen zum Konfigurieren von Verbindungen und Aktivitäten nach jedem Konnektortyp finden Sie auf den Seiten unter Konnektoren.

Quellen

Eine Quellaktivität ist jede Aktivität, die Daten innerhalb einer Operation bereitstellt, die dann unverändert oder durch eine Transformation verändert auf ein Ziel übertragen werden können vor Erreichen eines Ziels.

Quellaktivitäten erfordern nur dann ein Schema, wenn sie als Eingabe in einer Transformation verwendet werden:

• Wenn die Quellaktivität Daten bereitstellt, die transformiert werden, muss sie über ein Schema verfügen, das entweder automatisch bereitgestellt wird oder beim Konfigurieren der Aktivität oder Transformation definiert werden kann.
• Wenn die Quellaktivität Daten bereitstellt, die nicht transformiert werden, muss kein Schema definiert werden, da das Schema im Operation nicht verwendet wird.

Zu den Aktivitäten, die typischerweise (aber nicht notwendigerweise) als Quellen verwendet werden, zählen solche, deren Name eines dieser Wörter enthält:

• Herunterladen
• Erhalten
• Lesen
• Anfrage
• Abfrage

Ziele

Eine Zielaktivität ist jede Aktivität, die Daten innerhalb einer Operation empfängt. Diese Daten können aus einer Quellaktivität, aus einer Transformation oder aus anderen Eingaben wie Variablen oder Scripts.

Zielaktivitäten erfordern nur dann ein Schema, wenn sie transformierte Daten empfangen oder eine Antwort bereitstellen, die Sie in ein anderes Ziel schreiben möchten:

• Wenn die Zielaktivität transformierte Daten empfängt, muss sie über ein Schema verfügen, das entweder automatisch bereitgestellt wird oder beim Konfigurieren der Aktivität oder Transformation definiert werden kann.
• Wenn die Zielaktivität Daten empfängt, die nicht transformiert wurden, muss kein Schema definiert werden, da das Schema im Operation nicht verwendet wird. Wenn ein bestimmter Typ einer Zielaktivität eine Antwort liefert, können Sie auch ein Schema verwenden. Wenn Sie die Antwort in ein anderes Ziel schreiben möchten, wird das Schema entweder automatisch bereitgestellt oder kann bei der Konfiguration der Aktivität oder Transformation definiert werden. Wenn der Zieltyp eine Antwort liefert, ist kein Operation erforderlich, um die Antwort in ein anderes Ziel zu schreiben. Das heißt, ein Schema kann bereitgestellt, aber innerhalb des Operation ignoriert werden, wenn es nicht benötigt wird.

Zu den Aktivitäten, die typischerweise (aber nicht notwendigerweise) als Ziele verwendet werden, zählen solche, deren Name eines dieser Wörter enthält:

• Hinzufügen
• Erstellen
• Löschen
• Einfügen
• Post
• Setzen
• Antwort
• Hochladen
• Aktualisieren
• Upsert
• Schreiben

Werkzeuge

Ein Tool ist eine Projektkomponente, die die Schnittstelle bereitstellt, um innerhalb einer Operation eine bestimmte Logik oder bestimmte Bedingungen auf Daten anzuwenden.

Scripts

Ein als Projektkomponente erstelltes Script kann als Schritt in einer Operation verwendet werden, um Daten zu transformieren, Berechnungen durchzuführen oder die Logik zu validieren. Sie können beispielsweise vor oder nach einer Aktivität ein Script verwenden, um Daten abzurufen und anschließend die Script zu verarbeiten, oder Sie können ein Script ausführen, bevor Sie mit einer Transformation fortfahren. Weitere Informationen finden Sie unter Script und -erstellung.

Transformations

Eine Transformation ist eine Projektkomponente, die als Schritt in einem Operation verwendet wird, um Eingaben durch Verschieben, Bereinigen oder Anwenden von Geschäftslogik in eine resultierende Ausgabe abzubilden oder zu transformieren. Nachdem Sie eine Transformation erstellt haben, müssen Sie sie konfigurieren, indem Sie verschiedene Eingaben wie Quellobjekte, Variablen oder Scripts der resultierenden Zielausgabe (in der Regel einer Zieldatenstruktur) zuordnen. Weitere Informationen finden Sie unter Transformations.

Zusätzliche Tools

Weitere Werkzeuge sind auf der Tab Tools der Design-Komponentenpalette verfügbar (siehe Tools in Design-Komponentenpalette). Diese Projektkomponenten implementieren eine bestimmte Funktion und sollen die Notwendigkeit der Verwendung von Skripten für bestimmte als Projektkomponenten verwendete Scripts ersetzen. Weitere Informationen finden Sie unter Tooltypen und Erstellung.

Hinzufügen von Schritten zu einem Operation

Operationen bestehen aus Projektkomponenten, die aus Aktivitäten oder Werkzeugen bestehen. Um Operationen zu erstellen, platzieren Sie diese Komponenten in einem Workflow auf der Design-Canvas als Schritte einer Operation.

Wählen Sie den Standort der Komponente innerhalb einer neuen oder bestehenden Operation

Die Methode zum Hinzufügen einer Komponente zu einer Operation hängt davon ab, ob die Operation neu erstellt wird oder bereits vorhanden ist:

• Neue Operation: Überall dort, wo Sie eine Komponente hinzufügen können, um eine neue Operation zu erstellen, wird auf der Design-Canvas eine Operation Drop-Zone angezeigt. In einem Workflow, der noch keine Operationen enthält, wird die Drop-Zone allein oben auf der Design-Canvas angezeigt. In einem Workflow, der mindestens eine Operation enthält, wird eine Drop-Zone allein unten auf der Design-Canvas, unter der letzten Operation, angezeigt. Um weitere Ablagezonen für Operation anzuzeigen, bewegen Sie den Mauszeiger über eine vorhandene Operation.

  

• Vorhandene Operation: Vorhandene Operationen werden auf der Design-Canvas mit hellgrauem Hintergrund angezeigt. Wenn Sie mit der Maus links oder rechts neben einer Komponente einer vorhandenen Operation fahren, wird eine Komponenten-Drop-Zone angezeigt, in der Sie einer vorhandenen Operation eine Komponente hinzufügen können.

  

Nachdem Sie sich für den Speicherort entschieden haben, unterscheiden sich die Schritte zum Hinzufügen der Komponente, je nachdem, ob es sich bei der Komponente um eine Aktivität handelt oder ein Script oder eine Transformation, wird als Nächstes behandelt.

Erstellen Sie Verbindungen und fügen Sie anschließend Aktivitäten hinzu und konfigurieren Sie sie

Die Design-Komponentenpalette bietet Zugriff auf Konnektivitätsressourcen. Hier stellen Konnektoren die Schnittstelle dar, über die benutzerdefinierte Eingaben wie Anmeldeinformationen zum Herstellen einer Verbindung eingegeben werden können. Innerhalb der Komponentenpalette zeigt der Filter Konnektoren die konfigurierbaren Konnektortypen an:

Jeder Konnektor wird durch ein Konnektor-Ordnersymbol mit dem Konnektornamen dargestellt. Klicken Sie auf einen Konnektor, um einen Konfigurationsbildschirm zu öffnen und einen neuen Endpoint für den Zugriff auf eine bestimmte Datenressource zu erstellen:

Detaillierte Anweisungen zur Konfiguration einer Verbindung finden Sie unter Konnektoren. Jedes Mal, wenn Sie eine neue Verbindung erstellen, müssen Sie dies über die Konnektor-Ordnersymbole tun, auf die im Filter Konnektoren zugegriffen werden kann.

Sobald Sie eine Verbindung erstellt haben, wird diese im Filter „Endpoints“ angezeigt. Klicken Sie auf einen Endpoint, um dessen Ordner zu öffnen und die Aktivitätstypen (Interaktionen mit einem Endpoint) anzuzeigen, die für diese Verbindung konfiguriert werden können.

Ein Endpoint bezieht sich auf eine bestimmte Verbindung und ihre Aktivitäten, die in einem Projekt als Quellen (zum Bereitstellen von Daten) oder Ziele (zum Verbrauchen von Daten) konfiguriert sind.

Um eine Instanz einer Aktivität zu erstellen, platzieren Sie einen Aktivitätstyp auf der Design-Canvas, indem Sie ihn ziehen oder in eine Operation oder Komponenten-Drop-Zone kopieren:

Sobald eine Aktivität erstellt ist, können Sie sie per Doppelklick wie für jede einzelne Aktivität unter Konnektoren beschrieben konfigurieren..

Hinzufügen und Konfigurieren von Tools

Möglicherweise möchten Sie auch Tools hinzufügen zu einer Operation. Ein Werkzeug kann von diesen Standorten aus erstellt werden:

• Die Registerkarte Komponenten im Projektbereich über das Menü Neu erstellen (siehe Aktionsmenü der Tab „Komponenten“ im Projektbereich Tab Komponenten).

• Die Tab Tools der Design-Komponentenpalette (siehe Tools in Design-Komponentenpalette).

Darüber hinaus können Script und Transformation mithilfe einer Drop-Zone auf der Design-Canvas erstellt werden (siehe Dropzone Aktionsmenü in Design-Leinwand):

Wenn Sie ein Script oder eine Transformation hinzufügen, wird der Konfigurationsbildschirm automatisch geöffnet. Details zur Konfiguration finden Sie unter Transformations und Scripts, jeweils.

Notiz

Die Reihenfolge der Arbeitsschritte kann beliebig sein. Beachten Sie jedoch, dass ein in einer benachbarten Aktivität bereitgestelltes Schema Vorrang vor einem in einer Transformation definierten Schema hat. Ob Sie ein Schema in einer Aktivität oder in einer Transformation definieren, hängt von Ihrem Anwendungsfall ab. Weitere Informationen finden Sie unter Schemaverwendung.

Aktionsmenü“

Nachdem eine Operation erstellt wurde, können die Menüaktionen für diese Operation von diesen Orten aus aufgerufen werden:

• Die Tab Workflows im Projektbereich (siehe Aktionsmenü Komponentenaktionen im Projektbereich Tab Workflows).

• Die Tab Komponenten im Projektbereich (siehe Aktionsmenü im Projektbereich Tab Komponenten).

• Die Design-Canvas (siehe Aktionsmenü in Design-Leinwand).

Umbenennen von Operationen und Operation

Wenn Sie eine neue Operation erstellen, lautet ihr Standardname „Neue Operation“. Nachfolgende neue Operationen mit Standardnamen werden mit einer fortlaufenden Nummer in Klammern versehen. Operationsnamen müssen eindeutig sein und dürfen keine Schrägstriche enthalten (/) oder Doppelpunkte (:) gültig zu sein.

Operationen und Operation können an diesen Stellen umbenannt werden:

• Die Tab Workflows im Projektbereich (siehe Aktionsmenü Komponentenaktionen im Projektbereich Tab Workflows).

• Die Tab Komponenten im Projektbereich (siehe Aktionsmenü im Projektbereich Tab Komponenten).

• Die Design-Canvas (siehe Umbenennen von Workflows, Operationen und Operation in Design-Leinwand).

Arbeitsschritte können auch in den jeweiligen Konfigurationsbildschirmen umbenannt werden.

Vorgänge erweitern oder reduzieren

Beim Erstellen einer Operation wird diese standardmäßig erweitert. Operationen können einzeln oder alle gleichzeitig reduziert oder erweitert werden:

• Einzelne Operation ausblenden: Um eine einzelne Operation auszublenden, klicken Sie auf das Symbol zum Reduzieren in der Operation.

  Beim Ausblenden einer Operation werden nur der Operation und ihr einsetzen angezeigt:

  

• Erweitern einer einzelnen Operation: Um eine einzelne Operation zu erweitern, wenn sie reduziert ist, klicken Sie auf das Erweitern-Symbol in der Operation.

• Alle Vorgänge reduzieren: Um alle Vorgänge in einem Workflow zu reduzieren, klicken Sie auf Alle Vorgänge reduzieren oder auf die Symbol „Alles reduzieren“ oben auf der Design-Canvas.

• Alle Operationen erweitern: Um alle Operationen in einem Workflow zu erweitern, wenn sie reduziert sind, klicken Sie auf Alle Operationen erweitern oder auf die Symbol „Alle erweitern“ oben auf der Design-Canvas.

Neuanordnungsvorgänge

Die Reihenfolge der Vorgänge kann innerhalb oder zwischen Workflows über die Tab Workflows im Projektfenster geändert werden (siehe Vorgänge neu anordnen im Projektbereich Tab Workflows).

Operationen können innerhalb desselben Workflow von der Design-Canvas aus neu angeordnet werden (siehe Operationen neu anordnen in Design-Leinwand).