Betriebsoptionen in Jitterbit Studio

Einführung

Konfigurieren Sie die Betriebsoptionen, um Zeitüberschreitungen, Protokollierung und Datenverarbeitung zu steuern. Die meisten Operationen funktionieren gut mit den Standardeinstellungen, aber Sie können diese an spezifische Bedürfnisse anpassen.

Zugriff auf Betriebsoptionen

Sie können die Einstellungen-Option für Operationen von diesen Orten aus aufrufen:

• Der Workflows-Tab im Projektbereich (siehe Komponentenaktionsmenü im Projektbereich Workflows-Tab).
• Der Komponenten-Tab im Projektbereich (siehe Komponentenaktionsmenü im Projektbereich Komponenten-Tab).
• Die Entwurfskanvas (siehe Komponentenaktionsmenü in Entwurfskanvas).
• Die Entwurfskanvas durch Doppelklick auf die Operation (dies öffnet Einstellungen direkt).

Nachdem der Bildschirm für die Betriebseinstellungen geöffnet ist, wählen Sie den Tab Optionen:

Konfigurieren der Betriebsoptionen

Die folgenden Abschnitte beschreiben jede Betriebsoption:

• Betriebszeitüberschreitung
• Was protokolliert werden soll
• Auf dediziertem Agenten ausführen
• Debug-Protokollierungsmodus aktivieren bis
• Erfolgreiche Operation ausführen, auch wenn keine passenden Quelldateien vorhanden sind
• Chunking aktivieren
• Salesforce-Bulk-Betriebsoptionen

Betriebszeitüberschreitung

Setzen Sie, wie lange die Operation läuft, bevor sie abgebrochen wird. Der Standardwert beträgt 2 Stunden, was für die meisten Operationen funktioniert.

Möglicherweise möchten Sie diese Einstellung aus folgenden Gründen anpassen:

• Erhöhen Sie das Timeout für große Datensätze, die länger zur Verarbeitung benötigen. Geplante Operationen, die große Datenmengen verarbeiten, benötigen möglicherweise längere Timeouts. Wenn Ihre Datensätze die Timeout-Grenzen überschreiten, siehe Chunking aktivieren für Optionen, die große Datensätze in kleinere Chargen aufteilen und die Anzahl der pro Ausgabedatei geschriebenen Datensätze steuern.

• Verringern Sie das Timeout für zeitkritische Operationen, die schnell abgeschlossen werden müssen.

Geben Sie eine Zahl ein und wählen Sie Sekunden, Minuten oder Stunden aus dem Dropdown-Menü.

Was zu protokollieren ist

Wählen Sie aus, welche Informationen in den Betriebsprotokollen angezeigt werden:

• Alles: Protokolliert alle Betriebsaktivitäten (empfohlen).
• Nur Fehler: Protokolliert nur Operationen mit einem Fehlerstatus (wie Fehler, SOAP-Fehler oder Erfolg mit Kindfehler). Verwenden Sie diese Einstellung, wenn Sie Leistungsprobleme haben und keine detaillierten Protokolle benötigen. Erfolgreiche Kindoperationen werden nicht protokolliert. Elternoperationen (Root-Ebene) werden immer protokolliert, da sie für eine ordnungsgemäße Funktion protokolliert werden müssen.

Debugging

Der Abschnitt Debugging enthält Optionen, um eine Operation auf einem dedizierten Agenten auszuführen und den Debug-Modus zu aktivieren.

Auf dediziertem Agenten ausführen

Leiten Sie diese Operation zur Ausführung auf einem bestimmten Agenten als vorübergehende Fehlerbehebung. Diese Option gilt nur für private Agentengruppen, die mit einer Hochverfügbarkeit (HA) Agentengruppenkategorie konfiguriert sind. Verwenden Sie sie, um Fehler auf einem bestimmten Agenten zu reproduzieren oder um einen problematischen Agenten zu umgehen, während der Rest der Gruppe betriebsbereit bleibt.

Um diese Option zu aktivieren, wählen Sie das Kontrollkästchen Auf dediziertem Agenten ausführen aus und konfigurieren Sie Folgendes:

• Wählen Sie einen Agenten aus: Wählen Sie den spezifischen Agenten innerhalb der HA-Gruppe aus, der für die Ausführung dieser Operation verwendet werden soll. Wenn der von Ihnen ausgewählte Agent gelöscht wird, während diese Option aktiv ist, wird die Ausführung auf einem dedizierten Agenten automatisch deaktiviert und die Operation wechselt zur Ausführung in der Standard-Agentengruppe.

• Bis: Wählen Sie ein Datum bis zu zwei Wochen ab heute. Die Ausführung auf einem dedizierten Agenten wird an diesem Datum automatisch deaktiviert, und die Operation wechselt zum Verhalten der Standard-Agentengruppe.

• Auf untergeordnete Operationen anwenden: Wenn die Operation untergeordnete Operationen hat, wird dieses Kontrollkästchen angezeigt. Wählen Sie es aus, um alle untergeordneten Operationen auf demselben Agenten wie die übergeordnete Operation auszuführen.

Wenn Auf dediziertem Agenten ausführen aktiviert ist, erscheint eine Warnung.

Debug-Modus bis aktivieren

Aktivieren Sie detaillierte Protokollierung zur Fehlersuche. Wählen Sie ein Datum bis zu zwei Wochen ab heute. Der Debug-Modus wird an diesem Datum automatisch deaktiviert.

Wenn Sie den Debug-Modus für Operationen mit untergeordneten Operationen aktivieren, können Sie dieselbe Einstellung auf alle untergeordneten Operationen anwenden, indem Sie das Kontrollkästchen Auch auf untergeordnete Operationen anwenden aktivieren.

Die Debug-Protokollierung erzeugt verschiedene Arten von Protokollen, basierend auf Ihrem Agententyp:

Führen Sie die Erfolgsoperation aus, auch wenn keine übereinstimmenden Quelldateien vorhanden sind

Diese Option zwingt eine Operation zum Erfolg, selbst wenn ihr Trigger fehlschlägt. Dadurch können andere Operationen, die Bei Erfolg dieser Operation ausgelöst werden, unabhängig vom Ergebnis der ursprünglichen Operation ausgeführt werden. Sie gilt nur, wenn die ursprüngliche Operation eine Quellaktivität für einen dieser Konnektoren enthält:

• API
• Dateifreigabe
• FTP
• HTTP
• Lokaler Speicher
• SOAP
• Temporärer Speicher
• Variablenaktivität

Standardmäßig werden alle Bei Erfolg-Operationen nur ausgeführt, wenn sie eine übereinstimmende Quelldatei zum Verarbeiten haben. Diese Option kann nützlich sein, um spätere Teile eines Projekts einzurichten, ohne den Erfolg einer abhängigen Operation zu erfordern.

Chunking aktivieren

Chunking zerlegt große Datensätze in kleinere Teile (Batches). Dies beschleunigt die Verarbeitung und hilft, die API-Datensatzlimits einzuhalten. Um Chunking zu aktivieren, muss Ihre Operation eine Transformation oder eine Aktivität von einem dieser Konnektoren enthalten:

• Datenbank
• NetSuite
• Salesforce
• Salesforce Service Cloud
• ServiceMax
• SOAP-Aktivität

Verwenden Sie Chunking in diesen Situationen:

• Sie verarbeiten große Datensätze mit Tausenden von Datensätzen.
• Sie verwenden Webdienste mit Datensatzgrenzen. Zum Beispiel erlaubt Salesforce nur 200 Datensätze pro Aufruf.
• Sie möchten mehrere CPU-Kerne für die parallele Verarbeitung nutzen.

Wenn eine Salesforce, Salesforce Service Cloud oder ServiceMax Aktivität in der Operation enthalten ist, wird Chunking automatisch aktiviert.

Wenn diese Einstellung aktiviert ist, konfigurieren Sie diese Felder:

• Chunk-Größe: Die Anzahl der Datensätze in jedem Chunk. Standard ist 1 für die meisten Operationen und 200 für Salesforce-Operationen.

  Hinweis

  Wenn Sie eine (Salesforce, Salesforce Service Cloud oder ServiceMax) Bulk-Aktivität verwenden, ändern Sie diesen Standard auf eine viel größere Zahl, wie z.B. 10.000.

• Anzahl der Datensätze pro Datei: Die Anzahl der Datensätze, die in jede Zieldatei (Batch) geschrieben werden sollen. Standard ist 0, was keine Begrenzung bedeutet.

• Maximale Anzahl von Threads: Die Anzahl der Verarbeitungsthreads, die gleichzeitig ausgeführt werden. Standardmäßig ist dies 1 für die meisten Operationen und 2 für Salesforce-Operationen.

Salesforce-Bulk-Operationsoptionen

Die folgenden Optionen erscheinen nur für Salesforce, Salesforce Service Cloud und ServiceMax Bulk-Operationen (außer Bulk Query-Operationen):

• Erfolgreiche Datensätze schreiben nach: Wählen Sie, wohin erfolgreiche Datensätze nach Abschluss der Bulk-Operation gesendet werden sollen. Wählen Sie aus konfigurierten dateibasierten Aktivitäten: HTTP, API, FTP, Dateifreigabe, Lokaler Speicher, Temporärer Speicher oder Variable. Standard: Keine.

• Fehlerhafte Datensätze schreiben nach: Wählen Sie, wohin fehlgeschlagene Datensätze nach Abschluss der Bulk-Operation gesendet werden sollen. HTTP, API, FTP, Dateifreigabe, Lokaler Speicher, Temporärer Speicher oder Variable. Standard: Keine.

  Wichtig

  Wenn Sie Variable-Aktivitäten verwenden, können nur Operationen in derselben Operation-Kette während der Laufzeit auf den Variablenwert zugreifen.

• Erfolgreiche Datensätze senden an: Wählen Sie eine Email-Benachrichtigung, um erfolgreiche Datensätze zu erhalten. Wählen Sie aus den konfigurierten Email-Benachrichtigungen. Standard: Keine.

• Fehlerhafte Datensätze senden an: Wählen Sie eine Email-Benachrichtigung, um fehlerhafte Datensätze zu erhalten. Wählen Sie aus den konfigurierten Email-Benachrichtigungen. Standard: Keine.

Detaillierte Chunking-Informationen

Chunking wird verwendet, um die Quelldaten basierend auf der konfigurierten Chunk-Größe in mehrere Chunks (Batches) zu unterteilen. Die Chunk-Größe ist die Anzahl der Quelldatensätze (Knoten) für jeden Chunk. Die Transformation wird dann für jeden Chunk separat durchgeführt, wobei jeder Quell-Chunk einen Ziel-Chunk produziert. Die resultierenden Ziel-Chunks kombinieren sich, um das endgültige Ziel zu erzeugen.

Chunking kann nur verwendet werden, wenn die Datensätze unabhängig und aus einer nicht-LDAP-Quelle stammen. Wir empfehlen, eine so große Chunk-Größe wie möglich zu verwenden, wobei sichergestellt wird, dass die Daten für einen Chunk in den verfügbaren Speicher passen. Für zusätzliche Methoden zur Begrenzung des Speicherverbrauchs einer Transformation siehe Transformation-Verarbeitung.

API-Beschränkungen

Viele Webservice-APIs (SOAP/REST) haben Größenbeschränkungen. Zum Beispiel akzeptiert ein Salesforce-basiertes Upsert nur 200 Datensätze pro Aufruf. Bei ausreichendem Speicher könnten Sie eine Operation so konfigurieren, dass sie eine Chunk-Größe von 200 verwendet. Die Quelle würde in Chunks von jeweils 200 Datensätzen unterteilt, und jede Transformation würde den Webservice einmal mit einem 200-Datensatz-Chunk aufrufen. Dies würde wiederholt, bis alle Datensätze verarbeitet wurden. Die resultierenden Zieldateien würden dann kombiniert. (Beachten Sie, dass Sie auch Salesforce-basierte Bulk-Aktivitäten verwenden könnten, um die Verwendung von Chunking zu vermeiden.)

Parallelverarbeitung

Wenn Sie eine große Quelle und einen Multi-CPU-Computer haben, kann Chunking verwendet werden, um die Quelle für die Parallelverarbeitung zu teilen. Da jeder Chunk isoliert verarbeitet wird, können mehrere Chunks parallel verarbeitet werden. Dies gilt nur, wenn die Quellaufzeichnungen auf der Ebene der Chunk-Knoten unabhängig voneinander sind. Webdienste können parallel unter Verwendung von Chunking aufgerufen werden, was die Leistung verbessert.

Beim Einsatz von Chunking in einem Vorgang, bei dem das Ziel eine Datenbank ist, beachten Sie, dass die Zieldaten zunächst in zahlreiche temporäre Dateien (eine für jeden Chunk) geschrieben werden. Diese Dateien werden dann zu einer Zieldatei kombiniert, die an die Datenbank zum Einfügen/Aktualisieren gesendet wird. Wenn Sie die Jitterbit-Variable jitterbit.target.db.commit_chunks auf 1 oder true setzen, während Chunking aktiviert ist, wird jeder Chunk stattdessen an die Datenbank übergeben, sobald er verfügbar ist. Dies kann die Leistung erheblich verbessern, da die Datenbankeinfügungen/Aktualisierungen parallel durchgeführt werden.

Variablen mit Chunking verwenden

Da Chunking Multi-Threading auslösen kann, kann dessen Verwendung das Verhalten von Variablen beeinflussen, die nicht zwischen den Threads geteilt werden.

Globale und Projektvariablen sind zwischen den Instanzen des Chunkings segregiert, und obwohl die Daten kombiniert werden, sind Änderungen an diesen Variablen nicht vorhanden. Nur Änderungen, die im ursprünglichen Thread vorgenommen werden, werden am Ende der Transformation beibehalten.

Wenn beispielsweise ein Vorgang — mit Chunking und mehreren Threads — eine Transformation hat, die eine globale Variable ändert, ist der Wert der globalen Variable nach dem Ende des Vorgangs der aus dem ersten Thread. Alle Änderungen an der Variablen in anderen Threads sind unabhängig und werden verworfen, wenn der Vorgang abgeschlossen ist.

Diese globalen Variablen werden an die anderen Threads nach Wert und nicht nach Referenz übergeben, was sicherstellt, dass Änderungen an den Variablen nicht in anderen Threads oder Vorgängen widergespiegelt werden. Dies ähnelt der Funktion RunOperation, wenn sie im asynchronen Modus ist.