Gültige Operationsmuster in Jitterbit Studio

Einführung

Operationen müssen gültig sein, bevor Sie sie bereitstellen können. Diese Seite erläutert, wie Sie ungültige Operationen identifizieren, welche Validierungsmuster Operationen befolgen müssen, und enthält Beispiele für jedes Muster.

Ungültige Operationen

Bei neuen Projekten hebt die Design-Canvas standardmäßig ungültige Elemente hervor, wenn Ungültige Elemente hervorheben ausgewählt ist. Um diese Option zu deaktivieren, heben Sie die Auswahl auf:

Wenn Sie Ungültige Elemente hervorheben auswählen, werden ungültige Operationen oder Komponenten auf der Design-Canvas mit einer roten Umrandung und einem Ungültig-Symbol neben ihrem Namen angezeigt:

Im Projektbereich werden die Namen ungültiger Workflows und Komponenten in roten Kursivbuchstaben aufgelistet und mit einem Ungültig-Symbol angezeigt:

Klicken Sie auf das Ungültig-Symbol neben dem Operationsnamen, um eine Meldung mit den Validierungsfehlern für die Operation anzuzeigen.

Das Ungültig-Symbol wird nicht angezeigt, wenn die Operation ungültig ist, weil sie andere Komponenten mit impliziten Fehlern enthält. Projektkomponenten, die als Teil einer Operation verwendet werden, müssen gültig sein, damit die Operation gültig ist. Diese Anforderung umfasst Komponenten, die als Schritte einer Operation verwendet werden, sowie andere Komponenten, die zur Unterstützung einer Operation verwendet werden. Die folgenden Beispiele veranschaulichen diese Anforderung:

• Eine Komponente, die direkt als Schritt in der Operation verwendet wird, z. B. eine Aktivität, Transformation oder ein Skript.
• Ein Endpunkt, von dem eine in der Operation verwendete Aktivität abhängt.
• Eine Komponente, die ein Skript in der Operation aufruft.

Die Validierungsregeln hängen vom Komponententyp ab. Weitere Informationen finden Sie unter Komponentengültigkeit.

Eine vollständige Referenz der Validierungsfehlermeldungen und deren Lösungen finden Sie unter Fehlerbehebung bei Operationen.

Validierungsmuster

Operationen müssen bestimmte Validierungsmuster befolgen, bevor Sie sie in der Harmony-Cloud bereitstellen und auf Jitterbit-Agenten ausführen können. Diese Muster stellen sicher, dass Agenten alle Teile eines Projekts unterstützen und erwarten.

Die folgende Legende zeigt die Definition der in den Musterdiagrammen verwendeten Flusslinien:

Flusslinie	Definition
	Eine erforderliche Komponente.
	Eine optionale Komponente.
	Null oder mehr Skripte oder Flow Control Tools sind gültig.

Häufig gestellte Fragen (FAQ)

Bei der Gestaltung von Operationen können die folgenden häufig gestellten Fragen hilfreich sein:

• Was ist der Unterschied zwischen einer Quelle und einem Ziel?
  Aktivitäten fungieren als Quelle, wenn sie Daten innerhalb einer Operation bereitstellen. Aktivitäten fungieren als Ziel, wenn sie Daten innerhalb einer Operation empfangen. Weitere Informationen zu Quellen und Zielen sowie zu den Teilen der Operation finden Sie unter Operation creation and configuration.

• Welche Muster sind mit meinem Endpunkt gültig?
  Die einzelnen Aktivitätsseiten unter Connectors dokumentieren die Muster, die Sie mit jedem spezifischen Aktivitätstyp verwenden können. Auf jeder Aktivitätsseite werden die spezifischen Muster, die Sie verwenden können, im Abschnitt „Next Steps" angezeigt, der normalerweise der letzte Abschnitt auf jeder Aktivitätsseite ist.

• Kann ich eine Salesforce-Aktivität mit einem anderen Connector kombinieren?
  Wenn eine Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität Daten als Ziel empfängt, kann die Quellaktivität mit einem beliebigen Endpunkttyp verknüpft werden. Wenn eine dieser Aktivitäten Daten als Quelle bereitstellt, muss die Zielaktivität mit dem API, Database, File Share, FTP, HTTP, Local Storage, Temporary Storage oder Variable Connector verknüpft werden. Eine Operation kann auch nur eine NetSuite-, Salesforce-, Salesforce Service Cloud-, SAP-, ServiceMax- oder SOAP-Aktivität enthalten.

• Was ist, wenn mein Anwendungsfall nicht zu einem gültigen Muster passt?
  Wenn eine bestimmte gewünschte Operationsanordnung nicht einem gültigen Muster entspricht, können Sie möglicherweise eine Kombination von Operationen verwenden, die jeweils einem gültigen Muster folgen. Erstellen Sie dazu jede Operation separat und verketten Sie sie dann mit operation actions.

• Was sind häufige Validierungsfehler?
  Die häufigsten Probleme sind Operationen, die keinem gültigen Muster entsprechen, Transformationen ohne erforderliche Aktivitäten und Schema-Nichtübereinstimmungen. Eine vollständige Liste der Validierungsfehler und deren Behebung finden Sie unter Operation troubleshooting.

Archive pattern

Das Archive-Muster ist für die Verwendung mit Quell- und Zielaktivitäten vorgesehen, die mit Dateien interagieren. Sie können dieses Muster verwenden, um inaktive Daten (in ihrem ursprünglichen Dateiformat) von einem Produktionssystem in einem sicheren Speichersystem zur späteren Abfrage zu speichern.

Script(s) oder Flow Control tools + Source Activity + Script(s) + Target Activity + Script(s)

Dieser Vorgang archiviert Dateien, indem er sie von einem FTP-Server in den temporären Speicher verschiebt, ohne sie zu transformieren.

Bei diesem Muster können die Quell- und Zielaktivitäten mit einem der folgenden Endpunkttypen verknüpft werden:

• API ^A
• Dateifreigabe
• FTP
• HTTP
• Lokaler Speicher
• NetSuite
• Salesforce ^B
• Salesforce Service Cloud ^B
• ServiceMax ^B
• Temporärer Speicher
• Variable

^A Wenn eine Operationskette eine API-Aktivität enthält, muss es die einzige API- oder API SOAP Request-Aktivität in der Operationskette sein, und sie muss die Quelle der ersten Operation sein. Das heißt, keine andere Operation darf diese Operation aus einem Skript oder einer „bei Erfolg"- oder „bei Fehler"-Operationsaktion aufrufen.

^B An dieser Stelle können nur Nicht-Bulk-Aktivitäten verwendet werden.

Skriptmuster

Skript(e) oder Ablaufsteuerung Tools + Zielaktivität

Bei diesem Muster kann die Zielaktivität mit einem der folgenden Endpunkttypen verknüpft werden:

• API
• Dateifreigabe
• FTP
• HTTP
• Lokaler Speicher
• Temporärer Speicher
• Variable

Transformationsmuster

Skript(e) oder Ablaufsteuerung Tools + (Gruppe: Quellaktivität + Skript[e] oder Ablaufsteuerung Tools) + Transformation + (Gruppe: Skript[e] oder Ablaufsteuerung Tools + Zielaktivität) + Skript[e] ^{E, F}

Bei diesem Muster können die Quell- und Zielaktivitäten mit einem beliebigen Endpunkttyp verknüpft werden, solange mindestens eine Aktivität vorhanden ist. Eine Transformation kann nicht allein in einer Operation ohne eine Aktivität existieren.

^A Wenn eine Operationskette eine API-Aktivität enthält, muss es die einzige API- oder API SOAP Request-Aktivität in der Operationskette sein, und sie muss die Quelle der ersten Operation sein. Das heißt, keine andere Operation darf diese Operation aus einem Skript oder einer „bei Erfolg"- oder „bei Fehler"-Operationsaktion aufrufen.

^B Nur nicht-Bulk-Aktivitäten können an dieser Stelle verwendet werden.

^C Mindestens eine Aktivität muss enthalten sein; eine Transformation kann nicht für sich allein existieren.

^D Wenn eine Salesforce-, Salesforce Service Cloud- oder ServiceMax-Abfrage als Quellaktivität verwendet wird, ist eine Zielaktivität erforderlich.

^E Operationen können nicht mehr als eine NetSuite-, Salesforce-, Salesforce Service Cloud-, SAP-, ServiceMax- oder SOAP-Aktivität enthalten.

^F In einer Operation, die eine Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität enthält, hängen die für die anderen Aktivitäten zulässigen Connectoren von der Datenrichtung ab. Wenn die Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität Daten als Ziel empfängt, kann die Quellaktivität mit einem beliebigen Endpunkttyp verknüpft werden. Wenn sie Daten als Quelle bereitstellt, muss die Zielaktivität mit dem API, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable-Connector verknüpft sein.

Zwei-Ziel-Archivierungsmuster

Mit dem Zwei-Ziel-Archivierungsmuster können inaktive Daten (in ihrem ursprünglichen Format) von einem Produktionssystem in einem sicheren Speichersystem für den späteren Abruf archiviert werden.

Script(s) oder Flow Control Tools + (Gruppe: Quellaktivität 1 + Script(s) oder Flow Control Tools + Transformation + Zielaktivität 1 / Quellaktivität 2 + Script(s) oder Flow Control Tools + Zielaktivität 2 + Script(s) oder Flow Control Tools ^{C, D}

In diesem Muster archiviert die zweite Zielaktivität eine Antwort aus der mittleren Aktivität, die sowohl als erstes Ziel als auch als zweite Quelle fungiert.

Die Antwort aus der mittleren Aktivität wird als Rohdaten an ein zweites Ziel weitergeleitet, ohne sie zu transformieren. Man kann sich dies als Archivierung oder als Weitergabe von Daten vorstellen (manchmal auch als Passthrough bezeichnet).

Die Quell- und Zielaktivitäten müssen je nach Verwendungsort im Muster mit bestimmten Endpunkttypen verknüpft sein:

• Quellaktivität 1 ^A: Falls verwendet, kann die erste Quellaktivität mit einem beliebigen Endpunkttyp verknüpft werden.
• Zielaktivität 1 / Quellaktivität 2: Die erste Zielaktivität (auch als zweite Quellaktivität bezeichnet) kann mit einem der folgenden Endpunkttypen verknüpft werden:
  • NetSuite
  • Salesforce ^{B, D}
  • Salesforce Service Cloud ^{B, D}
  • SAP
  • ServiceMax ^{B, D}
  • SOAP

• Zielaktivität 2: Die zweite Zielaktivität kann mit einem der folgenden Endpunkttypen verknüpft werden:
  • API
  • Dateifreigabe
  • FTP
  • HTTP
  • Lokaler Speicher
  • Temporärer Speicher
  • Variable

^A Wenn eine Operationskette eine API-Aktivität enthält, muss sie die einzige API- oder API-SOAP-Request-Aktivität in der Operationskette sein und muss die Quelle der ersten Operation sein. Das heißt, keine andere Operation darf diese Operation aus einem Skript oder einer „Bei Erfolg"- oder „Bei Fehler"-Operationsaktion aufrufen.

^B An dieser Stelle können nur Nicht-Bulk-Aktivitäten verwendet werden.

^C Operationen können nicht mehr als eine NetSuite-, Salesforce-, Salesforce Service Cloud-, SAP-, ServiceMax- oder SOAP-Aktivität enthalten.

^D In einer Operation, die eine Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität enthält, hängen die für die anderen Aktivitäten zulässigen Konnektoren von der Datenrichtung ab. Wenn die Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität Daten als Ziel empfängt, kann die Quellaktivität mit einem beliebigen Endpunkttyp verknüpft werden. Wenn sie Daten als Quelle bereitstellt, muss die Zielaktivität mit dem API, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable-Konnektor verknüpft werden.

Zwei-Ziel-HTTP-Archivmuster

Mit dem Zwei-Ziel-HTTP-Archivmuster können inaktive Daten (in ihrem ursprünglichen Format) aus einem Produktionssystem in einem sicheren Speichersystem archiviert und später über HTTP-Protokolle und -Dienste abgerufen werden.

Skript(e) oder Ablaufsteuerung Tools + Quellaktivität 1 + Skript(e) oder Ablaufsteuerung Tools + Transformation + Skript(e) oder Ablaufsteuerung Tools + Zielaktivität 1 / Quellaktivität 2 + Zielaktivität 2 + Skript(e) oder Ablaufsteuerung Tools

Bei diesem Muster archiviert die zweite Zielaktivität eine Antwort der mittleren Aktivität, die sowohl als erstes Ziel als auch als zweite Quelle fungiert. Dieses Muster unterscheidet sich vom Zwei-Ziel-Archivmuster, da die mittlere Aktivität eine HTTP-Aktivität ist.

Die Antwort der mittleren HTTP-Aktivität leitet die rohen Antwortdaten an ein zweites Ziel weiter, ohne sie zu transformieren. Man kann sich dies als Archivierung oder als Weitergabe von Daten vorstellen (manchmal auch als Passthrough bezeichnet).

Quelle und Zielaktivitäten müssen je nach ihrer Verwendung im Muster mit bestimmten Endpunkttypen verknüpft werden:

• Quellaktivität 1 ^A: Falls verwendet, kann die erste Quellaktivität mit jedem Endpunkttyp verknüpft werden.
• Zielaktivität 1 / Quellaktivität 2: Die erste Zielaktivität (auch als zweite Quellaktivität bezeichnet) kann mit einem der folgenden Endpunkttypen verknüpft werden:
  • HTTP ^C
• Zielaktivität 2: Die zweite Zielaktivität kann mit einem der folgenden Endpunkttypen verknüpft werden:
  • API
  • Dateifreigabe
  • FTP
  • HTTP
  • Lokaler Speicher
  • Temporärer Speicher
  • Variable

^A Falls eine Operationskette eine API-Aktivität enthält, muss diese die einzige API- oder API SOAP Request-Aktivität in der Operationskette sein und die Quelle der ersten Operation darstellen. Das heißt, keine andere Operation darf diese Operation aus einem Skript oder einer „bei Erfolg"- oder „bei Fehler"-Operationsaktion aufrufen.

^B An dieser Stelle können nur Nicht-Bulk-Aktivitäten verwendet werden.

^C Die HTTP-Aktivität muss einen Request-Body empfangen und einen Response-Body erzeugen. Eine HTTP GET-Aktivität gibt stattdessen eine Nachricht zurück, die Erfolg {"success": true} oder Fehler {"success": false} anzeigt, anstatt die tatsächliche Antwort zu liefern.

Zwei-Transformations-Muster

Skript(e) oder Ablaufsteuerung Tools + (Gruppe: Quellaktivität 1 + Skript(e) oder Ablaufsteuerung Tools) + Transformation 1 + Zielaktivität 1 / Quellaktivität 2 + Transformation 2 + Skript(e) oder Ablaufsteuerung Tools + Zielaktivität 2 + Skript(e) oder Ablaufsteuerung Tools ^C

In diesem Muster nimmt die zweite Transformation die Antwort der mittleren Aktivität (die sowohl als erste Zielaktivität als auch als zweite Quelle fungiert), transformiert sie und schreibt sie dann optional in ein zweites Ziel.

Quelle und Zielaktivitäten müssen je nach ihrer Verwendung im Muster mit bestimmten Endpunkttypen verknüpft werden:

• Quellaktivität 1 ^A: Falls verwendet, kann die erste Quellaktivität mit jedem Endpunkttyp verknüpft werden.
• Zielaktivität 1 / Quellaktivität 2: Die erste Zielaktivität (auch als zweite Quellaktivität bezeichnet) kann mit jedem Endpunkttyp verknüpft werden, außer mit API, Datenbank, Dateifreigabe, FTP, HTTP, Lokaler Speicher, Temporärer Speicher oder Variable.
• Zielaktivität 2 ^B: Falls verwendet, kann die zweite Zielaktivität mit jedem Endpunkttyp verknüpft werden.

^A Wenn eine Operationskette eine API-Aktivität enthält, muss diese die einzige API- oder API SOAP Request-Aktivität in der Operationskette sein, und sie muss die Quelle der ersten Operation darstellen. Das heißt, keine andere Operation darf diese Operation aus einem Skript oder einer „bei Erfolg"- oder „bei Fehler"-Operationsaktion aufrufen.

^B An dieser Stelle können nur Nicht-Bulk-Aktivitäten verwendet werden.

^C Operationen können nicht mehr als eine NetSuite-, Salesforce-, Salesforce Service Cloud-, SAP-, ServiceMax- oder SOAP-Aktivität enthalten.

Salesforce Bulk-Quellmuster

Skript(e) oder Ablaufsteuerung Tools + Quellaktivität + Skript(e) oder Ablaufsteuerung Tools + Zielaktivität + Skript(e) oder Ablaufsteuerung Tools

In diesem Muster muss die Quellaktivität eine Salesforce Bulk Query-Aktivität, Salesforce Service Cloud Bulk Query-Aktivität oder ServiceMax Bulk Query-Aktivität sein. Die Zielaktivität kann mit einem der folgenden Endpunkttypen verknüpft werden:

• Dateifreigabe
• FTP
• HTTP
• Lokaler Speicher
• Temporärer Speicher
• Variable

Salesforce Bulk-Zielmuster

Skript(e) oder Ablaufsteuerung Tools + Quellaktivität + Skript(e) oder Ablaufsteuerung Tools + Zielaktivität + Skript(e) oder Ablaufsteuerung Tools

In diesem Muster kann die Quellaktivität mit einem der folgenden Endpunkttypen verknüpft werden:

• Dateifreigabe
• FTP
• HTTP
• Lokaler Speicher
• Temporärer Speicher
• Variable

Die Zielaktivität kann mit einem der folgenden Endpunkttypen verknüpft werden:

• Salesforce Bulk Insert
• Salesforce Bulk Update
• Salesforce Bulk Upsert
• Salesforce Bulk Delete
• Salesforce Bulk Hard Delete
• Salesforce Service Cloud Bulk Insert
• Salesforce Service Cloud Bulk Update
• Salesforce Service Cloud Bulk Upsert
• Salesforce Service Cloud Bulk Delete
• Salesforce Service Cloud Bulk Hard Delete
• ServiceMax Bulk Insert
• ServiceMax Bulk Update
• ServiceMax Bulk Upsert
• ServiceMax Bulk Delete
• ServiceMax Bulk Hard Delete