Zum Inhalt springen

Betriebsoptionen im Jitterbit Integration Studio

Einführung

Konfigurieren Sie 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 Standorten aus aufrufen:

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

options tab

Konfigurieren von Betriebsoptionen

Die folgenden Abschnitte beschreiben jede Betriebsoption:

options dialog

Betriebszeitüberschreitung

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

Sie möchten 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.

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

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

Hinweis

Vorgänge, die durch API Manager APIs ausgelöst werden, ignorieren diese Einstellung bei Cloud-Agenten. Für private Agenten aktivieren Sie EnableAPITimeout in der Konfigurationsdatei des privaten Agenten, damit die Einstellung Operation Time Out für durch APIs ausgelöste Vorgänge gilt.

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 Vorgänge 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 Kindvorgänge werden nicht protokolliert. Übergeordnete (Root-Level) Vorgänge werden immer protokolliert, da sie für eine ordnungsgemäße Funktion protokolliert werden müssen.

Debug-Modus aktivieren bis

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.

Warnung

Bei Cloud-Agentengruppen ist die Dauer dieser Einstellung unzuverlässig. Protokolle können vor dem Ende des ausgewählten Zeitraums nicht mehr erstellt werden.

Wenn Sie den Debug-Modus für Vorgänge mit Kindvorgängen aktivieren, können Sie dieselbe Einstellung für alle Kindvorgänge mit dem Kontrollkästchen Auch auf Kindvorgänge anwenden anwenden.

Die Debug-Protokollierung erzeugt je nach Agententyp unterschiedliche Protokollarten:

Protokolltyp
Protokollbeschreibung Agenttyp
Debug-Protokolldateien Debug-Protokolldateien für detaillierte Fehlersuche. Diese Dateien können direkt auf dem Agenten zugegriffen oder über die Management-Konsole heruntergeladen werden. Das Debug-Logging kann auch für das gesamte Projekt direkt vom privaten Agenten selbst aktiviert werden (siehe Betriebs-Debug-Logging). Die Debug-Protokolldateien sind direkt auf privaten Agenten zugänglich und können über die Seiten Agenten und Betriebsabläufe der Management-Konsole heruntergeladen werden.

Warnung

Der Debug-Modus erstellt große Protokolldateien. Nur während des Testens verwenden, nicht in der Produktion.

Nur private Agenten
Eingabe- und Ausgabekomponenten Anforderungs- und Antwortdaten (30 Tage aufbewahrt). Zugriff über die Seite Betriebsabläufe der Management-Konsole.

Vorsicht

Komponenten-Eingabe- und Ausgabedaten werden immer in die Harmony-Cloud protokolliert, selbst wenn Cloud-Protokollierung deaktiviert ist. Um dies bei privaten Agenten zu stoppen, setzen Sie verbose.logging.enable=false in der Konfigurationsdatei unter [VerboseLogging].

Debug-Protokolle enthalten alle Anforderungs- und Antwortdaten, einschließlich sensibler Informationen wie Passwörter und personenbezogene Daten (PII). Diese Daten erscheinen im Klartext in den Harmony-Cloud-Protokollen für 30 Tage.

Cloud- und private Agenten
API-Betriebsprotokolle Protokolle für erfolgreiche API-Betriebsvorgänge (konfiguriert für benutzerdefinierte APIs oder OData-Dienste). Standardmäßig werden nur API-Betriebsvorgänge mit Fehlern in den Betriebsprotokollen protokolliert.
Cloud- und private Agenten

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. Dies gilt nur, wenn die ursprüngliche Operation eine Quellaktivität für einen dieser Connectoren enthält:

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.

Hinweis

Die Einstellung AlwaysRunSuccessOperation in der Konfigurationsdatei des privaten Agents überschreibt diese Option.

Chunking aktivieren

Chunking zerlegt große Datensätze in kleinere Teile. 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 Connectoren enthalten:

Verwenden Sie Chunking in diesen Situationen:

  • Sie verarbeiten große Datensätze mit Tausenden von Datensätzen.
  • Sie verwenden Webdienste mit Datensatzlimits. 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 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 in jeder Ziel-Datei. Standard ist 0, was bedeutet, dass es kein Limit gibt.

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

Warnung

Chunking beeinflusst, wie globale und Projektvariablen funktionieren. Nur Änderungen vom ersten Thread werden beibehalten. Siehe detaillierte Informationen zu Chunking unten.

Optionen für Salesforce-Bulk-Operationen

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

salesforce write failure and success

  • Erfolgreiche Datensätze schreiben nach: Wählen Sie aus, wohin erfolgreiche Datensätze nach Abschluss der Massenoperation 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 aus, wohin fehlgeschlagene Datensätze nach Abschluss der Massenoperation 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 Operationskette 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 konfigurierten Email-Benachrichtigungen. Standard: Keine.

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

Hinweis

Dateibasierte Aktivitäten und Email-Benachrichtigungen, die in diesen Optionen ausgewählt wurden, müssen nicht Teil einer bestehenden bereitgestellten Operation sein. Das Integration Studio wird diese Komponenten automatisch bereitstellen und verwalten, wenn sie ausgewählt werden.

Detaillierte Chunking-Informationen

Chunking wird verwendet, um die Quelldaten basierend auf der konfigurierten Chunk-Größe in mehrere Teile 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 werden kombiniert, 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 Transformationsverarbeitung.

Warnung

Die Verwendung von Chunking beeinflusst das Verhalten von globalen und Projektvariablen. Siehe Variablen mit Chunking verwenden unten.

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 sind. 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 unterteilen. Da jeder Chunk isoliert verarbeitet wird, können mehrere Chunks parallel verarbeitet werden. Dies gilt nur, wenn die Quelldatensätze auf der Ebene der Chunk-Knoten unabhängig voneinander sind. Webservices können parallel unter Verwendung von Chunking aufgerufen werden, was die Leistung verbessert.

Bei der Verwendung von Chunking in einer Operation, bei der 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, wenn 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.

Verwenden Sie Variablen mit Chunking

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

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

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

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