Erstellen und Konfigurieren eines 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. Operationen werden verwendet, um zu definieren, was ein Integrationsprozess tun soll und wann dies geschehen soll.

Operationen bestehen aus einer Kombination aus einer oder mehreren Aktivitäten, Scripts oder Transformations:

Die spezifische Kombination und Reihenfolge dieser Komponenten muss dem Satz gültiger Muster folgen. Einzelheiten zu diesen Mustern finden Sie unter Operationsgültigkeit.

Auf dieser Seite werden die Teile 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, Scripts und Transformations innerhalb einer Operation auf der Design-Canvas gebildet. Die Operation kann aus nur einem einzigen Script bestehen, oder die Anordnung kann eine Abfolge von Schritten bilden, die aus einer oder mehreren Aktivitäten, Scripts oder Transformations besteht. Die spezifischen Kombinationen, die zulässig sind, werden 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. Zusätzlich zur 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 bevor ein Ziel erreicht wird.

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 von Zielaktivität eine Antwort bereitstellt, können Sie auch ein Schema haben. Wenn Sie die Antwort in ein anderes Ziel schreiben möchten, wird das Schema entweder automatisch bereitgestellt oder kann beim Konfigurieren der Aktivität oder Transformation definiert werden. Wenn der Zieltyp eine Antwort bereitstellt, ist kein Operation erforderlich, um die Antwort in ein anderes Ziel zu schreiben. Das heißt, ein Schema kann bereitgestellt werden, kann aber innerhalb des Operation ignoriert werden, wenn es nicht erforderlich ist.

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

Scripts

Ein Script, das als Projektkomponente erstellt wird, kann als Schritt in einer Operation verwendet werden, um Daten zu transformieren, Berechnungen durchzuführen oder eine logische Validierung durchzuführen. Sie können beispielsweise ein Script vor oder nach einer Aktivität verwenden, um Daten abzurufen und dann 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 einer resultierenden Ausgabe zuzuordnen oder umzuwandeln. Nachdem Sie eine Transformation erstellt haben, müssen Sie sie konfigurieren, indem Sie verschiedene Eingaben, z. B. Quellobjekte, Variablen oder Scripts, der resultierenden Zielausgabe zuordnen, normalerweise einer Zieldatenstruktur. Weitere Informationen finden Sie unter Transformations.

Schritte zu einem Operation hinzufügen

Operationen bestehen aus Projektkomponenten, die aus Aktivitäten, Scripts oder Transformations 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 Vorgehensweise beim 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 hat, wird die Drop-Zone allein oben auf der Design-Canvas angezeigt. In einem Workflow, der mindestens eine Operation hat, wird eine Drop-Zone allein unten auf der Design-Canvas angezeigt, unter der letzten Operation. Um zusätzliche Ablagezonen für Operation anzuzeigen, bewegen Sie den Mauszeiger über eine vorhandene Operation.

  

• Vorhandener Vorgang: Vorhandene Vorgänge werden auf der Design-Canvas mit hellgrauem Hintergrund angezeigt. Wenn Sie mit der Maus nach links oder rechts neben eine Komponente in einem 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 Standort 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, als nächstes behandelt.

Verbindungen erstellen, dann Aktivitäten hinzufügen und konfigurieren

Die Design-Komponentenpalette bietet Zugriff auf Konnektivitätsressourcen. Hier bieten Konnektoren die Schnittstelle, über die benutzerdefinierte Eingaben wie Anmeldeinformationen eingegeben werden, um eine Verbindung herzustellen. Innerhalb der Komponentenpalette zeigt der Filter Konnektoren die Konnektortypen an, die konfiguriert werden können:

Jeder Konnektor wird durch ein Konnektor-Ordnersymbol dargestellt, das mit dem Konnektornamen beschriftet ist. 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 zum Konfigurieren einer Verbindung finden Sie bei der jeweiligen Verbindung unter Konnektoren. Jedes Mal, wenn Sie eine neue Verbindung erstellen, müssen Sie dies über die Connector-Ordnersymbole tun, auf die im Filter Connectors zugegriffen werden kann.

Sobald Sie eine Verbindung erstellt haben, wird sie 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 per Drag & Drop-Zone in eine Operation oder Komponenten-Drop-Zone kopieren:

Sobald eine Aktivität erstellt wurde, können Sie darauf doppelklicken, um sie wie für jede spezifische Aktivität unter Konnektoren beschrieben zu konfigurieren.

Hinzufügen und Konfigurieren von Transformations oder Scripts

Möglicherweise möchten Sie einer Operation auch Transformations oder Scripts hinzufügen. Transformations werden verwendet, wenn Sie Daten transformieren möchten, bevor sie ihr Ziel erreichen. Scripts können innerhalb von Transformations auf Zielfeldern und -knoten verwendet werden, um eine bestimmte Logik oder Bedingungen auf die Daten anzuwenden. Scripts können auch als optionale Schritte innerhalb einer Operation für verschiedene Zwecke verwendet werden, z. B. zur Fehlerbehandlung oder zum Durchlaufen von Datensätzen.

Um einer Operation direkt eine neue Transformation oder ein neues Script hinzuzufügen, klicken Sie mit der rechten Maustaste oder auf das Aktionsmenü einer Drop-Zone und wählen Sie Neues Script oder Neue Transformation:

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

Aktionsmenü „Operationsaktionen“

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

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

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

• Die Design-Canvas (siehe Aktionsmenü in Entwurfsfläche).

Umbenennen von Operationen und Operation

Wenn Sie eine neue Operation erstellen, lautet ihr Standardname Neue Operation. Nachfolgende neue Operationen mit Standardnamen werden mit einer in Klammern angehängten Nummer versehen. Operationsnamen müssen eindeutig sein und dürfen keine Schrägstriche enthalten (/) oder Doppelpunkte (:) um 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 des Projektbereichs (siehe Aktionsmenü im Projektbereich Tab Komponenten).

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

Arbeitsschritte können auch in ihren individuellen Konfigurationsbildschirmen umbenannt werden.

Operationen erweitern oder reduzieren

Wenn eine Operation erstellt wird, ist sie standardmäßig erweitert. Operationen können einzeln oder alle auf einmal reduziert oder erweitert werden:

• Einzelne Operation ausblenden: Um eine einzelne Operation auszublenden, klicken Sie auf das Symbol zum Reduzieren in der Aktionsleiste für 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 ausgeblendet ist, klicken Sie auf das Erweitern-Symbol in der Operation.

• Alle Vorgänge ausblenden: Um alle Vorgänge in einem Workflow auszublenden, klicken Sie auf Alle Vorgänge ausblenden oder auf Symbol „Alles ausblenden“ 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 Operationen 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 Entwurfsfläche).