Gültige Betriebsmuster in Jitterbit Studio

Einführung

Betriebe müssen gültig sein, bevor Sie sie bereitstellen können. Diese Seite behandelt, wie ungültige Betriebe identifiziert werden, die Validierungsmuster, denen Betriebe folgen müssen, und Beispiele für jedes Muster.

Ungültige Betriebe

Für neue Projekte hebt die Design-Leinwand standardmäßig ungültige Elemente hervor, wenn Ungültige Elemente hervorheben ausgewählt ist. Um diese Option zu deaktivieren, deaktivieren Sie diese Auswahl:

ungültige Elemente hervorheben

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

Betrieb ungültig

Im Projektbereich werden die Namen ungültiger Workflows und Komponenten in roter Kursivschrift aufgeführt und mit einem ungültigen Symbol angezeigt:

ungültiger Betrieb

Klicken Sie auf das ungültige Symbol neben dem Betriebsnamen, um eine Nachricht anzuzeigen, die die Validierungsfehler für den Betrieb auflistet.

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

Eine Komponente, die direkt als Schritt im Betrieb verwendet wird, wie eine Aktivität, Transformation oder ein Skript.
Ein Endpunkt, von dem eine Aktivität im Betrieb abhängt.
Eine Komponente, die von einem Skript im Betrieb aufgerufen wird.

Die Validierungsregeln hängen vom Typ der Komponente ab. Für weitere Informationen siehe Komponenten-Gültigkeit.

Für eine vollständige Referenz der Validierungsfehlermeldungen und deren Lösungen siehe Fehlerbehebung beim Entwurf von Operationen.

Validierungsmuster

Operationen müssen bestimmten Validierungsmustern folgen, bevor sie in der Harmony-Cloud bereitgestellt und auf Jitterbit-Agenten ausgeführt werden können. Diese Muster stellen sicher, dass die Agenten alle Teile eines Projekts unterstützen und erwarten.

Die folgende Legende zeigt die Definition der Flusslinien, die in den Musterdarstellungen verwendet werden:

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

Häufig gestellte Fragen (FAQ)

Als Sie Operationen entwerfen, 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. Für weitere Informationen zu Quellen versus Zielen und den Teilen der Operation siehe Operationserstellung und -konfiguration.
Welche Muster sind mit meinem Endpunkt gültig?
Die einzelnen Aktivitätsseiten unter Konnektoren dokumentieren die Muster, die Sie mit jedem spezifischen Aktivitätstyp verwenden können. Auf jeder Aktivitätsseite erscheinen die spezifischen Muster, die Sie verwenden können, im Abschnitt "Nächste Schritte", der typischerweise der letzte Abschnitt auf jeder Aktivitätsseite ist.
Was ist, wenn mein Anwendungsfall nicht zu einem gültigen Muster passt?
Wenn eine bestimmte gewünschte Anordnung der Operation nicht einem gültigen Muster entspricht, können Sie möglicherweise eine Kombination von Operationen verwenden, die jeweils einem gültigen Muster folgen. Dazu erstellen Sie jede Operation separat und verknüpfen sie dann mithilfe von Operationsaktionen.
Was sind häufige Validierungsfehler?
Die häufigsten Probleme umfassen Operationen, die keinem gültigen Muster entsprechen, Transformationen ohne erforderliche Aktivitäten und Schemainkonsistenzen. Für eine vollständige Liste der Validierungsfehler und wie man sie behebt, siehe Fehlerbehebung bei der Operationserstellung.

Tipp

Wenn Sie sich mit den Mustern vertraut machen, können diese Verallgemeinerungen hilfreich sein:

Dateibasierte Konnektoren wie FTP, HTTP und Temporärer Speicher können ohne Transformationen verwendet werden.
Anwendungskonnektoren wie Salesforce, NetSuite und Workday erfordern typischerweise Transformationen.
Skripte können fast überall in einer Operation hinzugefügt werden.
Bulk-Operationen wie Salesforce Bulk haben spezifische Muster und können keine Transformationen verwenden.

Archivmuster

Das Archivmuster ist für die Verwendung mit Quell- und Zielaktivitäten gedacht, die mit Dateien interagieren. Sie können dieses Muster verwenden, um inaktive Daten (im ursprünglichen Dateiformat) von einem Produktionssystem in ein sicheres Speichersystem zur späteren Abholung zu speichern.

Skript(e) oder Flusskontrolle Werkzeuge + Quellaktivität + Skript(e) + Zielaktivität + Skript(e)

Beispiel

Anwendungsfall: Sichern von Kundenbestelldateien von FTP in die Cloud-Speicherung.

operation simple file transfer

Diese Operation archiviert Dateien, indem sie von einem FTP-Server in einen temporären Speicher verschoben werden, ohne dass eine Transformation stattfindet.

In diesem Muster können die Quell- und Zielaktivitäten mit einem der folgenden Endpunkttypen verbunden werden:

^A Wenn eine Operationenkette eine API-Aktivität enthält, muss dies die einzige API- oder API SOAP-Anforderungsaktivität in der Operationenkette sein, und sie muss die Quelle der ersten Operation sein. Das bedeutet, dass keine andere Operation diese Operation aus einem Skript oder einer "bei Erfolg" oder "bei Fehler" Operation ausführen darf.

^B Es dürfen nur Nicht-Bulk-Aktivitäten an diesem Ort verwendet werden.

Skriptmuster

Skript(e) oder Flusskontrolle Werkzeuge + Zielaktivität

Beispiel

Anwendungsfall: Generieren und Speichern eines Zeitstempels für den täglichen Bericht.

operation generate timestamp

Diese Operation verwendet ein Skript, um einen formatierten Zeitstempel und einen Berichtsnamen zu generieren, und schreibt ihn dann in eine globale Variable zur Verwendung in nachfolgenden Operationen.

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

Transformationsmuster

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

Beispiel

Anwendungsfall: Kontakte von Salesforce mit einer Datenbank synchronisieren.

operation FTP read

Diese Operation fragt aktuelle Kontakte von Salesforce ab, transformiert die Daten, um dem Datenbankschema zu entsprechen, und fügt die Datensätze in eine Kundendatenbanktabelle ein.

In diesem Muster können die Quell- und Zielaktivitäten mit jedem Endpunkttyp verbunden werden, solange mindestens eine Aktivität enthalten ist. Eine Transformation kann nicht allein in einer Operation ohne eine Aktivität existieren.

^A Wenn eine Operationenkette eine API-Aktivität enthält, muss sie die einzige API- oder API SOAP-Anforderungsaktivität in der Operationenkette 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" Operation ausführen.

^B Es dürfen nur Nicht-Bulk-Aktivitäten an dieser Stelle verwendet werden.

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

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

^E Operationen dürfen nicht mehr als eine NetSuite-, Salesforce-, Salesforce Service Cloud-, SAP-, ServiceMax- oder SOAP-Aktivität enthalten.

^F Operationen, die eine Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität enthalten, dürfen keine anderen Aktivitäten enthalten, außer denen, die mit den API, Datenbank, Dateifreigabe, FTP, HTTP, Lokalen Speicher, Temporären Speicher oder Variablen verbunden sind.

Zwei-Ziel-Archivmuster

Sie können das Zwei-Ziel-Archivmuster verwenden, um inaktive Daten (in ihrem ursprünglichen Format) von einem Produktionssystem in ein sicheres Speichersystem zur späteren Abfrage zu speichern.

Skript(e) oder Flow Control Werkzeuge + (Gruppe: Quellaktivität 1 + Skript[e]) oder Flow Control Werkzeuge + Transformation + Zielaktivität 1 / Quellaktivität 2 + Skript(e) oder Flow Control Werkzeuge + Zielaktivität 2 + Skript(e) oder Flow Control Werkzeuge ^{C, D}

Beispiel

Anwendungsfall: Erstellen Sie einen Salesforce-Fall und archivieren Sie die Antwort.

operation create case

Diese Operation ruft Daten zu Support-Tickets von einer API ab, transformiert sie, um einen Salesforce-Fall zu erstellen, und archiviert dann die Salesforce-Antwort in einer globalen Variablen. Die Salesforce-Antwort wird unverändert an das zweite Ziel weitergeleitet, ohne zusätzliche Transformation.

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

Die Antwort von der mittleren Aktivität leitet die Rohantwortdaten an ein zweites Ziel weiter, ohne sie zu transformieren. Sie können dies als Archiv oder als Durchleitung von Daten betrachten (manchmal als Durchlauf bezeichnet).

Die Quell- und Zielaktivitäten müssen je nach Verwendung im Muster mit bestimmten Endpunkttypen verbunden sein:

Quellaktivität 1 ^A: Wenn verwendet, kann die erste Quellaktivität mit jedem Endpunkttyp verbunden sein.
Zielaktivität 1 / Quellaktivität 2: Die erste Zielaktivität (auch als zweite Quellaktivität bezeichnet) kann mit einem der folgenden Endpunkttypen verbunden sein:
- NetSuite
- Salesforce ^{B, D}
- Salesforce Service Cloud ^{B, D}
- SAP
- ServiceMax ^{B, D}
- SOAP
Hinweis

Eine Variation dieses Musters, die HTTP als mittlere Aktivität verwendet, ist das Zwei-Ziel-HTTP-Archivmuster.
Zielaktivität 2: Die zweite Zielaktivität kann mit einem der folgenden Endpunkttypen verbunden sein:
- API
- Dateifreigabe
- FTP
- HTTP
- Lokaler Speicher
- Temporärer Speicher
- Variable

^A Wenn eine Operationenkette eine API-Aktivität enthält, muss sie die einzige API- oder API SOAP-Anforderungsaktivität in der Operationenkette 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" Aktionsaktion aufrufen.

^B Es dürfen nur Nicht-Massenaktivitäten an diesem Ort verwendet werden.

^C Operationen dürfen nicht mehr als eine NetSuite-, Salesforce-, Salesforce Service Cloud-, SAP-, ServiceMax- oder SOAP-Aktivität enthalten.

^D Operationen, die eine Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität enthalten, dürfen keine anderen Aktivitäten enthalten, außer denen, die mit den API, Datenbank, Dateifreigabe, FTP, HTTP, lokalem Speicher, temporärem Speicher oder Variablen verbunden sind.

Zwei-Ziel-HTTP-Archivmuster

Sie können das Zwei-Ziel-HTTP-Archivmuster verwenden, um inaktive Daten (in ihrem ursprünglichen Format) von einem Produktionssystem in ein sicheres Speichersystem zu übertragen, um sie später über HTTP-Protokolle und -Dienste abzurufen.

Skript(e) oder Flow Control Werkzeuge + Quellaktivität 1 + Skript(e) oder Flow Control Werkzeuge + Transformation + Skript(e) oder Flow Control Werkzeuge + Zielaktivität 1 / Quellaktivität 2 + Zielaktivität 2 + Skript(e) oder Flow Control Werkzeuge

Beispiel

Anwendungsfall: Eine Zahlung verarbeiten und die Antwort protokollieren.

operation payment processing

Diese Operation fragt ausstehende Zahlungsdatensätze aus einer Datenbank ab, transformiert die Daten, um dem Zahlungs-API-Anforderungsformat zu entsprechen, fügt über ein Skript Authentifizierungsheader hinzu, sendet an die Zahlungs-Gateway-API und archiviert die HTTP-Antwort im temporären Speicher zu Prüfungszwecken.

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

Die Antwort von der mittleren HTTP-Aktivität wird ohne Transformation der Rohantwortdaten an ein zweites Ziel weitergeleitet. Sie können dies als Archiv oder als Durchleitung von Daten betrachten (manchmal als Passthrough bezeichnet).

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

Quellaktivität 1 ^A: Wenn 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 Wenn eine Betriebskette eine API-Aktivität enthält, muss sie die einzige API- oder API SOAP-Anforderungsaktivität in der Betriebskette 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" Operation aufrufen.

^B Es dürfen nur Nicht-Bulk-Aktivitäten an diesem Ort verwendet werden.

^C Die HTTP-Aktivität muss einen Anforderungstext empfangen und einen Antworttext erzeugen. Eine HTTP GET-Aktivität gibt eine Nachricht zurück, die Erfolg {"success": true} oder Misserfolg {"success": false} anzeigt, anstelle der tatsächlichen Antwort.

Zwei-Transformationsmuster

Skript(e) oder Flusskontrolle Werkzeuge + (Gruppe: Quellaktivität 1 + Skript[e] oder Flusskontrolle Werkzeuge) + Transformation 1 + Zielaktivität 1 / Quellaktivität 2 + Transformation 2 + Skript(e) oder Flusskontrolle Werkzeuge + Zielaktivität 2 + Skript(e) oder Flusskontrolle Werkzeuge

Beispiel

Anwendungsfall: Erstellen Sie einen NetSuite-Kunden und verarbeiten Sie die Antwort.

operation netsuite customer

Diese Operation ruft ausstehende Kundendaten von einer CRM-API ab, transformiert sie, um einen NetSuite-Kundenrekord zu erstellen, transformiert dann die NetSuite-Antwort und aktualisiert die lokale Datenbank mit der NetSuite-ID für zukünftige Referenzen.

In diesem Muster übernimmt die zweite Transformation die Antwort aus der mittleren Aktivität (die sowohl als erste Ziel- als auch als zweite Quellaktivität fungiert), transformiert sie und schreibt sie dann optional in ein zweites Ziel.

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

Quellaktivität 1 ^A: Wenn 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: Wenn verwendet, kann die zweite Zielaktivität mit jedem Endpunkttyp verknüpft werden.

^A Wenn eine Operationenkette eine API-Aktivität enthält, muss sie die einzige API- oder API SOAP-Anforderungsaktivität in der Operationenkette 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" Operation ausführen.

^B Nur Nicht-Massenaktivitäten können an diesem Standort verwendet werden.

^C Operationen dürfen nicht mehr als eine NetSuite-, Salesforce-, Salesforce Service Cloud-, SAP-, ServiceMax- oder SOAP-Aktivität enthalten.

^D Operationen, die eine Salesforce-, Salesforce Service Cloud- oder ServiceMax-Aktivität enthalten, dürfen keine anderen Aktivitäten enthalten, außer denen, die mit den API, Datenbank, Dateifreigabe, FTP, HTTP, Lokalen Speicher, Temporären Speicher, oder Variablen -Konnektoren verbunden sind.

Salesforce-Muster für Massenquellen

Skript(e) oder Flusskontrolle Werkzeuge + Quellaktivität + Skript(e) oder Flusskontrolle Werkzeuge + Zielaktivität + Skript(e) oder Flusskontrolle Werkzeuge

Beispiel

Anwendungsfall: Extrahieren Sie einen großen Datensatz aus Salesforce zur Analyse.

operation salesforce bulk query

Diese Operation verwendet eine Salesforce Bulk Query-Aktivität, um alle in diesem Jahr erstellten Konten zu extrahieren und die Daten dann auf einen FTP-Server für den Import in das Data Warehouse zu schreiben. Verwenden Sie dieses Muster, um große Datensätze (typischerweise 50.000 oder mehr Datensätze) effizient ohne Transformation zu extrahieren.

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 verbunden sein:

Salesforce Bulk-Zielmuster

Skript(e) oder Flow-Control Werkzeuge + Quellaktivität + Skript(e) oder Flow-Control Werkzeuge + Zielaktivität + Skript(e) oder Flow-Control Werkzeuge

Beispiel

Anwendungsfall: Massenladen von Kundendaten in Salesforce.

operation salesforce bulk upsert

Diese Operation liest eine CSV-Datei mit Kundendaten von einem FTP-Server, validiert die Daten mit einem Skript und führt dann einen Bulk-Upsert in Salesforce-Kontaktobjekte durch. Verwenden Sie dieses Muster, um große Datensätze (typischerweise 50.000 oder mehr Datensätze) effizient ohne Transformation zu laden.

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

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