Jitterbit-Variablen in Design Studio

Übersicht

Jitterbit-Variablen sind einer der drei Typen globaler Datenelemente, die in Harmony verfügbar sind. (Die beiden anderen Typen globaler Datenelemente - globale Variablen und Projektvariablen - sind auch global im gesamten Projekt verfügbar. Sie werden unterschiedlich festgelegt, wie in Globale Variablen beschrieben.) und Projektvariablen.)

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

Die häufigsten Anwendungsfälle für Jitterbit-Variablen sind das Lesen einer Variable, damit Sie Informationen darüber sammeln können, was während eines Operation passiert ist, oder das Abrufen globaler Informationen wie des Namens der aktuellen Quelldatei. Weniger häufig werden Jitterbit-Variablen beschrieben, wenn Standardeinstellungen geändert werden, die für die Verarbeitung der Operation verwendet werden.

Wenn eine Jitterbit-Variable die Art und Weise beeinflusst, wie eine Funktion funktioniert, muss es davorlegende dem Funktionsaufruf gesetzt werden. Vorgelagerte Operationen oder Scripts sind solche, die innerhalb einer Operation durch Operation oder die RunOperation oder RunScript Funktionen. Upstream bezieht sich in diesem Zusammenhang auch auf das Ändern des Wertes der Variable Jitterbit im selben Script, jedoch vor dem Funktionsaufruf.

Da es sich bei diesen Variablen um vordefinierte Variablen handelt, erstellen oder ändern Projekte nur sehr selten den Standardwert einer Jitterbit-Variable. Bei Verwendung eines privaten Agenten können jedoch Jitterbit-Variablen erstellt oder ihr Standardwert geändert werden. Siehe Neue Variablen erstellen oder Standardwerte für private Agenten festlegen weiter unten für weitere Einzelheiten.

Dokumentation zu den vordefinierten Jitterbit-Variablen finden Sie auf diesen Seiten:

• API Jitterbit-Variablen
• Gehostete Endpoint Jitterbit-Variablen
• NetSuite Jitterbit-Variablen
• Operation Jitterbit-Variablen
• Skripting von Jitterbit-Variablen
• SFDC Jitterbit-Variablen
• Quell-Jitterbit-Variablen
• Ziel-Jitterbit-Variablen
• Text-Jitterbit-Variablen
• Transformation Jitterbit-Variablen
• Webdienst-Jitterbit-Variablen
• Verschiedene Jitterbit-Variablen

Anzeige von Jitterbit-Variablen

Beim Entwerfen Ihres Projekts sind Jitterbit-Variablen auf der Tab Datenelemente des Script Builders verfügbar, auf den über die Bildschirme „Scripts“ und „Transformations“ zugegriffen werden kann. Jede von Jitterbit vordefinierte Jitterbit-Variable wird auf einer Seite unter diesem Abschnitt dokumentiert.

Festlegen von Jitterbit-Variablen in Scripts oder Transformations

Während der häufigste Anwendungsfall für Jitterbit-Variablen das Lesen von Informationen ist, gibt es einige Jitterbit-Variablen, die Sie möglicherweise festlegen möchten, um einem Agenten etwas mitzuteilen. In Integration Studio, Jitterbit-Variablen können entweder mit Jitterbit Script oder JavaScript, auf die gleiche Weise, wie jede globale Variable gesetzt werden kann.

Jitterbit Script

In Jitterbit Script, die innerhalb von Scripts verwendet werden und Transformations, kann der Wert einer Jitterbit-Variable durch ein Dollarzeichen beginnend festgelegt werden $oder telefonisch unter Set() Funktion.

• $: Verwendung des Dollarzeichens $ Syntax, $jitterbit.api.response="Success" legt die API Antwort fest (jitterbit.api.response), um die Zeichenfolge zurückzugeben "Success" zur anfordernden Anwendung.
• Set: Mit dem Set() Funktion, Set("jitterbit.api.response", "Success") legt die API Antwort fest (jitterbit.api.response), um die Zeichenfolge zurückzugeben "Success" zur anfordernden Anwendung.

In Scripts und Transformations werden Jitterbit-Variablen auch auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Jitterbit-Variablen angezeigt.

JavaScript

In JavaScript, das innerhalb von Scripts verwendet wird als Projektkomponente erstellt wurde, können von Jitterbit vordefinierte Jitterbit-Variablen nur mit dem Jitterbit.SetVar() Funktion. Dies liegt daran, dass alle von Jitterbit vordefinierten Jitterbit-Variablen Punkte im Variablennamen enthalten.

• Jitterbit.SetVar: Verwenden Jitterbit.SetVar, das Codebeispiel Jitterbit.SetVar("$jitterbit.api.response", "Success") legt die API Antwort so fest, dass die Zeichenfolge zurückgegeben wird "Success" zur anfordernden Anwendung.

In Scripts und Transformations werden Jitterbit-Variablen auch auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Jitterbit-Variablen angezeigt.

In JavaScript sollten Sie nicht die Verwendung von SetVar (Und GetVar) mit $-Präposition beim Setzen (und Abrufen) einer Variablen. Verwenden Sie nur eine Syntax. Das Mischen der beiden verschiedenen Syntaxen für dieselbe Variable kann zur Laufzeit zu Problemen führen.

Abrufen von Jitterbit-Variablen in Scripts oder Transformations

Der Wert einer Jitterbit-Variable kann entweder mit Jitterbit Script zurückgegeben werden (in Scripts oder Transformations) oder mithilfe von JavaScript (nur in Scripts, die als Projektkomponente erstellt wurden) auf die gleiche Weise wie eine globale Variable kann abgerufen werden.

Jitterbit Script

In Scripts und Transformations, können Sie mit einem Dollarzeichen beginnen $ oder verwenden Sie die Get() Funktion zum Abrufen des Wertes einer Jitterbit-Variable:

• $: Mit einem Dollarzeichen als Präfix $, das Codebeispiel $jitterbit.operation.error ruft den Wert der Jitterbit-Variable ab "jitterbit.operation.error".
• Get: Mit dem Get() Funktion, das Codebeispiel Get("jitterbit.operation.error") gibt den gleichen Wert zurück.

In Scripts und Transformations werden Jitterbit-Variablen auch auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Jitterbit-Variablen angezeigt.

JavaScript

In JavaScript Scripts innerhalb einer Operation kann auf von Jitterbit vordefinierte Jitterbit-Variablen nur mit dem Jitterbit.SetVar() Und Jitterbit.GetVar() Funktionen. Dies liegt daran, dass alle von Jitterbit vordefinierten Jitterbit-Variablen Punkte im Variablennamen enthalten.

• Jitterbit.GetVar: Verwenden Jitterbit.GetVar, das Codebeispiel Jitterbit.GetVar("$jitterbit.operation.error") gibt den Wert der Jitterbit-Variable namens " zurückjitterbit.operation.error". Beachten Sie, dass ein führendes Dollarzeichen $ ist optional vor dem Namen, wenn Werte abgerufen werden. Die Namen jitterbit.operation.name Und $jitterbit.operation.name sind beim Abrufen von Werten gleichwertig.

In JavaScript sollten Sie nicht die Verwendung von SetVar (Und GetVar) mit $-Präposition beim Setzen (und Abrufen) einer Variablen. Verwenden Sie nur eine Syntax. Das Mischen der beiden verschiedenen Syntaxen für dieselbe Variable kann zur Laufzeit zu Problemen führen.

In Scripts und Transformations werden Jitterbit-Variablen auch auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Jitterbit-Variablen angezeigt.

Jitterbit-Variablen in Definitionsbildschirmen verwenden

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

Wenn Sie beispielsweise die Variable Jitterbit als Teil eines Dateinamens oder als Eigenschaft eines anderen Objekts verwenden, das sich nicht in einem Script befindet, können Sie mit Klammern wie folgt darauf verweisen: [jitterbit.source.filename].

Erstellen Sie neue Variablen oder legen Sie Standardwerte für private Agenten fest

Wer private Agenten verwendet, kann das Standardverhalten von Jitterbit-Variablen programmgesteuert ändern sowie neue Jitterbit-Variablen über die private Agentenkonfigurationsdatei 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 Projektvariable behandelt werden anstelle einer Jitterbit-Variable.

Das Ändern von Standardwerten oder das Erstellen neuer Jitterbit-Variablen erfolgt über diese Abschnitte der privaten Agent-Konfigurationsdatei:

• [PredefinedGlobalVariables]
  Überprüfen oder ändern Sie die Standardwerte 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), Punkte und Unterstriche. Andere Zeichen werden nicht empfohlen und können Probleme verursachen.

Weitere Informationen zum Bearbeiten oder Erstellen von Jitterbit-Variablen finden Sie unter Bearbeiten der Konfigurationsdatei (jitterbit.conf).