Jitterbit-Variablen in Integration Studio

Übersicht

Jitterbit-Variablen sind einer der in Harmony verfügbaren Typen globaler Datenelemente. Die anderen Typen globaler Datenelemente - Projektvariablen, globale Variablen und Dateinamen-Schlüsselwörter - sind ebenfalls global im gesamten Projekt verfügbar. Sie werden unterschiedlich festgelegt, wie in Projektvariablen beschrieben., Globale Variablen und Dateinamen-Schlüsselwörter bzw. Da alle globalen Datenelemente denselben Namespace verwenden, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

Jitterbit-Variablen werden am häufigsten zum Lesen einer Variable verwendet, um Informationen zum Ablauf einer Operation zu erhalten oder globale Informationen wie den Namen der aktuellen Quelldatei abzurufen. Ein weiterer häufiger Anwendungsfall ist die Verwendung von Jitterbit-Variablen zum Ändern der Standardeinstellungen für die Verarbeitung der Operation.

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

Wenn Sie einen privaten Agenten verwenden, können Sie das Verhalten von Jitterbit programmgesteuert ändern, indem Sie den Standardwert einer vordefinierten Jitterbit-Variablen ändern oder Ihre eigene Jitterbit-Variable erstellen und vordefinieren.

Auf diesen Seiten finden Sie Dokumentationen zu den vordefinierten Jitterbit-Variablen:

• API -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

Jitterbit-Variablen werden an mehreren Stellen angezeigt:

• Im Script Editor, Jitterbit-Variablen werden in der Komponentenpalette rechts im Tab Variablen im Unterreiter Jitterbit-Variablen angezeigt. Von hier aus können Jitterbit - Variablenreferenzen einfach in Scripts eingefügt werden, auch in Transformation im Script.
• Im Transformation Mapping-Modus, Jitterbit-Variablen werden auf der Tab Variablen links in der Kategorie Jitterbit-Variablen angezeigt. Von hier aus können Sie während der Transformation im Zuordnungsmodus einfach auf Jitterbit-Variablenreferenzen zugreifen.
• In Endpoint, können Jitterbit-Variablen in allen Feldern aufgerufen und verwendet werden, die über eine Variablensymbol. Alternativ zur Auswahl einer Jitterbit-Variablen können Sie die Variablenreferenz manuell mithilfe der standardmäßigen eckigen Klammersyntax des Jitterbit Script eingeben.

Festlegen von Jitterbit-Variablen in Scripts oder Transformations

Jitterbit-Variablen werden am häufigsten zum Lesen von Informationen verwendet. Es gibt jedoch auch Jitterbit-Variablen, die Sie setzen können, um einem Agenten etwas mitzuteilen. In Integration Studio können Jitterbit-Variablen entweder mit Jitterbit Script gesetzt werden oder JavaScript, auf die gleiche Weise wie jede globale Variable kann eingestellt werden.

Tipp

Informationen dazu, welche Variablen gesetzt werden können und worauf sie eingestellt werden können, finden Sie in der Dokumentation der einzelnen Jitterbit-Variablen.

Jitterbit Script

Im Jitterbit Script, das innerhalb von Scripts verwendet wird und Transformations, kann der Wert einer Jitterbit-Variablen 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 anfragenden 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 gewünschten Bewerbung.

Hinweis

Für Jitterbit-Variablen mit einem Bindestrich im Namen verwenden Sie die Get Und Set Funktionen zum Abrufen und Festlegen ihrer Werte. Beispiel: Set("jitterbit.target.http.response.header.X-Jitterbit-Authorization", $authorization).

In Scripts und Transformations, Jitterbit-Variablen werden auch im Tab Variablen der Skriptkomponentenpalette im Untertab Jitterbit-Variablen angezeigt. Siehe Jitterbit-Variable zu einem Script hinzufügen unten.

JavaScript

In JavaScript, das innerhalb von Scripts verwendet wird als Projektkomponente erstellt, 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 gewünschten Bewerbung.

Warnung

Das JavaScript Jitterbit.SetVar Und Jitterbit.GetVar Funktionen sind speziell für den Zugriff auf vordefinierte Jitterbit-Variablen konzipiert. Sie dürfen nicht für den Zugriff auf benutzerdefinierte globale Variablen verwendet werden.

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

In Scripts und Transformations, Jitterbit-Variablen werden auch im Tab Variablen der Skriptkomponentenpalette im Untertab Jitterbit-Variablen angezeigt. Siehe Jitterbit-Variable zu einem Script hinzufügen unten.

Abrufen von Jitterbit-Variablen in einem Script oder einer Transformation

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

Jitterbit Script

In Scripts und Transformations, können Sie mit einem Dollarzeichen beginnen $ oder verwenden Sie die Get Funktion zum Abrufen des Werts 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.

Hinweis

Für Jitterbit-Variablen mit einem Bindestrich im Namen verwenden Sie die Get Und Set Funktionen zum Abrufen und Festlegen ihrer Werte. Beispiel: Get("jitterbit.target.http.response.header.X-Jitterbit-Authorization").

In Scripts und Transformations, Jitterbit-Variablen werden auch im Tab Variablen der Skriptkomponentenpalette im Untertab Jitterbit-Variablen angezeigt. Siehe Jitterbit-Variable zu einem Script hinzufügen unten.

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-Variablen namens "jitterbit.operation.error". Beachten Sie, dass ein führendes Dollarzeichen $ ist optional vor dem Namen beim Abrufen von Werten. Die Namen jitterbit.operation.name Und $jitterbit.operation.name sind beim Abrufen von Werten gleichwertig.

In Scripts und Transformations, Jitterbit-Variablen werden auch im Tab Variablen der Skriptkomponentenpalette im Untertab Jitterbit-Variablen angezeigt. Siehe Jitterbit-Variable zu einem Script hinzufügen unten.

Warnung

Das JavaScript Jitterbit.SetVar Und Jitterbit.GetVar Funktionen sind speziell für den Zugriff auf vordefinierte Jitterbit-Variablen konzipiert. Sie dürfen nicht für den Zugriff auf benutzerdefinierte globale Variablen verwendet werden.

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

Eine Jitterbit-Variable zu einem Script hinzufügen

Entweder in Jitterbit Script oder in JavaScript, das in Scripts verwendet wird im Rahmen einer Operation erstellt wurden, werden Jitterbit-Variablen auf der Tab Variablen der Komponentenpalette innerhalb der Unterregisterkarte Jitterbit-Variablen angezeigt:

So fügen Sie die Variablensyntax zu einem Script hinzu (Jitterbit Script oder JavaScript), verwenden Sie eine dieser Methoden:

• Ziehen Sie die Variable aus der Palette in das Script, um die Variablensyntax einzufügen.
• Doppelklicken Sie auf die Variable in der Palette, um die Variablensyntax an der Cursorposition im Script einzufügen.
• Beginnen Sie mit der Eingabe des Variablennamens und drücken Sie dann Control+Space Um eine Liste mit Autovervollständigungsvorschlägen anzuzeigen. Wählen Sie eine Variable aus, um die Variablensyntax einzufügen.
• Geben Sie die Variablensyntax manuell ein.

Verwenden Sie Jitterbit-Variablen in Konfigurationsbildschirmen

Während der Konfiguration verschiedener Projektkomponenten, einschließlich der Endpoint mithilfe von Konnektoren, können Sie Jitterbit-Variablen in allen Feldern verwenden, die über eine Variablensymbol. Variablen können in Feldern zusammen mit anderen Eingaben, einschließlich anderer Variablen oder Schlüsselwörter, verwendet werden. Diese Aktionen werden unten beschrieben:

• Jitterbit-Variable auswählen
• Formate zwischen Pille und Text umschalten
• Variable entfernen

Wählen Sie eine Jitterbit-Variable

Um auf Jitterbit-Variablen zuzugreifen, klicken Sie entweder auf das Variablensymbol oder geben Sie eine öffnende eckige Klammer ein [, um eine Liste mit Variablen und Schlüsselwörtern anzuzeigen (sofern für das aktuelle Feld verfügbar).

In der Liste wird der Variablen- oder Schlüsselworttyp durch das Symbol neben dem Namen gekennzeichnet:

• für Dateinamen-Schlüsselwort
• für globale Variable
• für Projektvariable
• für Jitterbit-Variable

Bewegen Sie den Mauszeiger in der Liste über den Variablennamen, um eine Vorschau der entsprechenden Informationen anzuzeigen:

Die Felder Wert und Beschreibung im Informations-Popup sind für eine Jitterbit-Variable immer leer. Eine Beschreibung der Verwendung der einzelnen Variablen finden Sie auf den Seiten unter diesem Thema.

Ein Standardwert für eine Jitterbit-Variable kann nicht in einem Konfigurationsfeld definiert werden. Stattdessen können Sie in einem Script Werte für bestimmte Jitterbit-Variablen festlegen, die zur Laufzeit ausgewertet werden.

Wählen Sie eine Variable aus, die dem Feld an der Cursorposition an einer beliebigen Stelle in der Zeichenfolge hinzugefügt werden soll. Die Variable wird in einem Pillenformat ähnlich dem unten gezeigten angezeigt:

Um Informationen zur Variable anzuzeigen, bewegen Sie den Mauszeiger über die Variablen-Pille:

Formate zwischen Pille und Text umschalten

Um das Standardformat der Variablenpillen in Textformat zu ändern, klicken Sie auf das Symbol zum Minimieren:

Dadurch wird die Anzeige des Pillenformats auf ein Textformat umgeschaltet, wobei der Variablenname in eckige Klammern eingeschlossen ist. [ ]:

Um vom Textformat zurück zum Pillenformat zu wechseln, verschieben Sie den Fokus vom Feld, z. B. indem Sie in ein anderes konfigurierbares Feld klicken. Die Feldeingabe kehrt automatisch zum Standard-Pillenformat zurück.

Entfernen einer Variable

Um die Variable zu entfernen, klicken Sie auf das Symbol „Entfernen“:

Anleitungen für Jitterbit-Variablen

Dieser Abschnitt enthält Details zur Verwendung von Jitterbit-Variablen in Projekten.

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

Nutzer privater Agenten können das Standardverhalten von Jitterbit-Variablen programmgesteuert ändern und über die Konfigurationsdatei des privaten Agenten neue Jitterbit-Variablen 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 Erstellen einer Projektvariablen behandelt werden anstelle einer Jitterbit-Variable.

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

• [PredefinedGlobalVariables]
  Standardwerte für Jitterbit-Variablen prüfen oder ändern.

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

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

Hinweis

Beim Upgrade eines privaten Agenten bleibt die Konfigurationsdatei erhalten und wird nicht mit der neuesten Version überschrieben.

Warnung

Beim Erstellen neuer Jitterbit-Variablen wird die Verwendung von Punkten im Variablennamen nicht empfohlen, wenn Sie mit JavaScript darauf zugreifen möchten. Stattdessen wird empfohlen, Jitterbit-Variablen zu erstellen, die keine Punkte enthalten und stattdessen Unterstriche verwenden. Weitere Informationen finden Sie unter globale Variablen, was auch für Jitterbit-Variablen gilt.

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