Jitterbit-Variablen im Design Studio

Übersicht

Jitterbit-Variablen sind eine der drei Arten von globalen Datenelementen, die in Harmony verfügbar sind. (Die beiden anderen Arten von globalen Datenelementen – globale Variablen und Projektvariablen – sind ebenfalls global im gesamten Projekt verfügbar. Sie werden unterschiedlich festgelegt, wie in Globalen Variablen und Projektvariablen beschrieben.)

Die Jitterbit-Variablen sind jederzeit in Ihrem Projekt verfügbar. Sie sind von Jitterbit vordefiniert oder im Jitterbit-Konfigurationsdatei festgelegt.

Die häufigsten Anwendungsfälle für Jitterbit-Variablen bestehen darin, eine Variable zu lesen, um Informationen darüber zu sammeln, was während eines Vorgangs passiert ist, oder um globale Informationen wie den Namen der aktuellen Quelldatei abzurufen. Seltener werden Jitterbit-Variablen geschrieben, wenn die Standardeinstellungen, die für die Verarbeitung der Vorgangskette verwendet werden, geändert werden.

Wenn eine Jitterbit-Variable die Funktionsweise einer Funktion beeinflusst, muss sie vor dem Funktionsaufruf festgelegt werden. Vorhergehende Operationen oder Skripte sind diejenigen, die innerhalb einer Vorgangskette mit Hilfe von Operationsaktionen oder den Funktionen RunOperation oder RunScript verknüpft sind. In diesem Kontext bezieht sich "vorhergehend" auch darauf, den Wert der Jitterbit-Variable im selben Skript zu ändern, jedoch vor dem Funktionsaufruf.

Da es sich bei diesen Variablen um vordefinierte Variablen handelt, erstellen oder ändern Projekte sehr selten den Standardwert einer Jitterbit-Variable. Wenn jedoch ein privater Agent verwendet wird, können Jitterbit-Variablen erstellt oder deren Standardwert geändert werden. Siehe Neue Variablen erstellen oder Standardwerte bei privaten Agenten festlegen unten für weitere Details.

Referenzieren Sie diese Seiten für die Dokumentation zu den vordefinierten Jitterbit-Variablen:

• API Jitterbit-Variablen
• Gehostete Endpunkt-Jitterbit-Variablen
• NetSuite Jitterbit-Variablen
• Betriebs-Jitterbit-Variablen
• Skript-Jitterbit-Variablen
• SFDC Jitterbit-Variablen
• Quell-Jitterbit-Variablen
• Ziel-Jitterbit-Variablen
• Text-Jitterbit-Variablen
• Transformations-Jitterbit-Variablen
• Webservice-Jitterbit-Variablen
• Verschiedene Jitterbit-Variablen

Anzeige von Jitterbit-Variablen

Bei der Gestaltung Ihres Projekts sind Jitterbit-Variablen im Tab Daten-Elemente des Skript-Generators verfügbar, der über die Bildschirme für Skripte und Transformationen zugänglich ist. Jede von Jitterbit vordefinierte Jitterbit-Variable ist auf einer Seite unter diesem Abschnitt dokumentiert.

Jitterbit-Variablen in Skripten oder Transformationen festlegen

Während der häufigste Anwendungsfall für Jitterbit-Variablen darin besteht, Informationen zu lesen, gibt es einige Jitterbit-Variablen, die Sie möglicherweise festlegen möchten, um etwas an einen Agenten zu kommunizieren. In Integration Studio können Jitterbit-Variablen entweder mit Jitterbit Script oder JavaScript festgelegt werden, genau wie jede globale Variable festgelegt werden kann.

Jitterbit Script

In Jitterbit Script, das innerhalb von Skripten und Transformationen verwendet wird, kann der Wert einer Jitterbit-Variable festgelegt werden, indem mit einem Dollarzeichen $ begonnen wird oder die Funktion Set() aufgerufen wird.

• $: Mit der Dollarzeichen-$-Syntax setzt $jitterbit.api.response="Success" die API-Antwort (jitterbit.api.response) so, dass die Zeichenfolge "Success" an die anfordernde Anwendung zurückgegeben wird.
• Set: Mit der Funktion Set() setzt Set("jitterbit.api.response", "Success") die API-Antwort (jitterbit.api.response) so, dass die Zeichenfolge "Success" an die anfordernde Anwendung zurückgegeben wird.

In Skripten und Transformationen werden Jitterbit-Variablen auch im Variablen-Tab des Skriptkomponenten-Paletten angezeigt, innerhalb des Jitterbit-Variablen-Unter-Tabs.

JavaScript

In JavaScript, das innerhalb von Skripten erstellt als Projektkomponente verwendet wird, können Jitterbit-Variablen, die von Jitterbit vordefiniert sind, nur mit der Funktion Jitterbit.SetVar() festgelegt werden. Dies liegt daran, dass alle von Jitterbit vordefinierten Jitterbit-Variablen Punkte im Variablennamen enthalten.

• Jitterbit.SetVar: Mit Jitterbit.SetVar setzt das Codebeispiel Jitterbit.SetVar("$jitterbit.api.response", "Success") die API-Antwort so, dass der String "Success" an die anfordernde Anwendung zurückgegeben wird.

In Skripten und Transformationen werden Jitterbit-Variablen auch im Tab Variablen der Skriptkomponenten-Palette im Untertab Jitterbit-Variablen angezeigt.

In JavaScript mischen Sie Ihre Verwendung von SetVar (und GetVar) nicht mit der $-Präfixierung beim Setzen (und Abrufen) einer Variablen. Verwenden Sie nur eine Syntax. Das Mischen der beiden unterschiedlichen Syntaxen für dieselbe Variable kann zur Laufzeit Probleme verursachen.

Jitterbit-Variablen in Skripten oder Transformationen abrufen

Der Wert einer Jitterbit-Variablen kann entweder mit Jitterbit Script (in Skripten oder Transformationen) oder mit JavaScript (nur in als Projektkomponente erstellten Skripten) auf die gleiche Weise abgerufen werden, wie eine globale Variable abgerufen werden kann.

Jitterbit Script

In Skripten und Transformationen können Sie mit einem Dollarzeichen $ beginnen oder die Funktion Get() verwenden, um den Wert einer Jitterbit-Variablen abzurufen:

• $: Mit einem Dollarzeichen $ vorangestellt, ruft das Codebeispiel $jitterbit.operation.error den Wert der Jitterbit-Variable "jitterbit.operation.error" ab.
• Get: Mit der Funktion Get() gibt das Codebeispiel Get("jitterbit.operation.error") denselben Wert zurück.

In Skripten und Transformationen werden Jitterbit-Variablen auch im Tab Variablen der Palette für Skriptkomponenten im Untertab Jitterbit-Variablen angezeigt.

JavaScript

In JavaScript Skripten innerhalb einer Operation können Jitterbit-Variablen, die von Jitterbit vordefiniert sind, nur mit den Funktionen Jitterbit.SetVar() und Jitterbit.GetVar() zugegriffen werden. Dies liegt daran, dass alle von Jitterbit vordefinierten Jitterbit-Variablen Punkte im Variablennamen enthalten.

• Jitterbit.GetVar: Mit Jitterbit.GetVar gibt das Codebeispiel Jitterbit.GetVar("$jitterbit.operation.error") den Wert der Jitterbit-Variable mit dem Namen "jitterbit.operation.error" zurück. Beachten Sie, dass ein vorangestelltes Dollarzeichen $ beim Abrufen von Werten optional ist. Die Namen jitterbit.operation.name und $jitterbit.operation.name sind beim Abrufen von Werten gleichwertig.

In JavaScript mischen Sie nicht Ihre Verwendung von SetVar (und GetVar) mit der Verwendung von $-Präfixen beim Setzen (und Abrufen) einer Variablen. Verwenden Sie nur eine Syntax. Das Mischen der beiden unterschiedlichen Syntaxen für dieselbe Variable kann zur Laufzeit Probleme verursachen.

In Skripten und Transformationen werden Jitterbit-Variablen auch im Tab Variablen der Palette für Skriptkomponenten im Untertab Jitterbit-Variablen angezeigt.

Verwenden Sie Jitterbit-Variablen in Definitionsbildschirmen

In einem Definitionsbildschirm (während der Konfiguration von Quellen oder Zielen) können Sie auf Jitterbit-Variablen mit der Syntax [JitterbitVariableName] verweisen.

Für den Fall, dass Sie die Jitterbit-Variable als Teil eines Dateinamens oder als Eigenschaft eines anderen Objekts verwenden, das sich nicht in einem Skript befindet, können Sie darauf mit Klammern wie [jitterbit.source.filename] verweisen.

Neue Variablen erstellen oder Standardwerte für private Agenten festlegen

Benutzer von privaten Agenten können das Standardverhalten von Jitterbit-Variablen programmgesteuert ändern sowie neue Jitterbit-Variablen über die Konfigurationsdatei des privaten Agenten erstellen. Beachten Sie jedoch, dass dies nur in seltenen Anwendungsfällen verwendet wird, die von fortgeschrittenen Benutzern implementiert werden. Die meisten Anwendungsfälle können durch die Erstellung einer Projektvariablen anstelle einer Jitterbit-Variable behandelt werden.

Das Ändern von Standardwerten oder das Erstellen neuer Jitterbit-Variablen erfolgt in diesen Abschnitten der Konfigurationsdatei des privaten Agenten:

• [PredefinedGlobalVariables]
  Überprüfen oder Ändern von Standardwerten für Jitterbit-Variablen.

• [PredefinedServerGlobalDataElement]
  Definieren Sie Ihre eigenen benutzerdefinierten Jitterbit-Variablen und Standardwerte.

Jitterbit-Variablenamen können aus diesen Zeichen bestehen: Buchstaben (a-z, A-Z), Zahlen (0-9), Punkten und Unterstrichen. Andere Zeichen werden nicht empfohlen und können Probleme verursachen.

Für weitere Informationen zum Bearbeiten oder Erstellen von Jitterbit-Variablen siehe Die Konfigurationsdatei bearbeiten (jitterbit.conf).