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 in einem Projekt verfügbar. Sie werden unterschiedlich gesetzt, wie in Globalen Variablen und Projektvariablen beschrieben.)

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

Die häufigsten Anwendungsfälle für Jitterbit-Variablen sind das Lesen einer Variablen, 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 Standardwerte, 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. Vorangehende Operationen oder Skripte sind diejenigen, die innerhalb einer Vorgangskette mit Hilfe von Operationsaktionen oder den Funktionen RunOperation oder RunScript verknüpft sind. Vorangehend bezieht sich in diesem Kontext 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 ihr Standardwert geändert werden. Siehe Neue Variablen erstellen oder Standardwerte bei privaten Agenten festlegen unten für Details.

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

• API Jitterbit-Variablen
• Gehostete Endpunkt Jitterbit-Variablen
• NetSuite Jitterbit-Variablen
• Operation Jitterbit-Variablen
• Scripting Jitterbit-Variablen
• SFDC Jitterbit-Variablen
• Quell Jitterbit-Variablen
• Ziel Jitterbit-Variablen
• Text Jitterbit-Variablen
• Transformation 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 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 wurde, die als Projektkomponente fungieren, 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 angezeigt, innerhalb des Unter-Tabs Jitterbit-Variablen.

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 $ versehen, ruft das Codebeispiel $jitterbit.operation.error den Wert der Jitterbit-Variablen "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 Skriptkomponenten-Palette 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-Variablen mit dem Namen "jitterbit.operation.error" zurück. Beachten Sie, dass ein führendes 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 $-Vorabsetzung 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 Skriptkomponenten-Palette 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 von fortgeschrittenen Benutzern verwendet wird. 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-Variablennamen 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 Bearbeiten der Konfigurationsdatei (jitterbit.conf).