Jitterbit-Variablen in Integration Studio

Übersicht

Jitterbit-Variablen sind einer der Typen globaler Datenelemente, die in Harmony verfügbar sind. Die anderen Typen globaler Datenelemente - Projektvariablen, globale Variablen und Dateinamen-Schlüsselwörter - sind auch 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 jedoch denselben Namespace verwenden, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

Der häufigste Anwendungsfall für Jitterbit-Variablen ist das Lesen einer Variable, damit Sie Informationen darüber sammeln können, was während eines Operation passiert ist, oder um globale Informationen wie den Namen der aktuellen Quelldatei abzurufen. Ein weiterer häufiger Anwendungsfall ist die Verwendung von Jitterbit-Variablen zum Ändern der Standardeinstellungen, 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 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 Wertes 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-Variable ändern oder Ihre eigene Jitterbit-Variable erstellen und vordefinieren.

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

• 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 auf der Tab Variablen auf der Unterregisterkarte Jitterbit-Variablen angezeigt. Dieser Speicherort bietet einfachen Zugriff zum Einfügen von Jitterbit-Variablenverweisen in Scripts, einschließlich in Transformation im Script.
• Im Transformation Mapping-Modus, Jitterbit-Variablen werden auf der Tab Variablen links in der Kategorie Jitterbit-Variablen angezeigt. Dieser Speicherort bietet einfachen Zugriff zum Einfügen von Jitterbit-Variablenverweisen während der Transformation im Zuordnungsmodus.
• In Endpoint, können Jitterbit-Variablen in allen Feldern aufgerufen und verwendet werden, die eine Variablensymbol. Alternativ zur Auswahl einer Jitterbit-Variable können Sie die Variablenreferenz manuell mit der standardmäßigen eckigen Klammersyntax des Jitterbit Script eingeben.

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, genauso wie jede globale Variable kann eingestellt werden.

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 anfragenden Bewerbung.

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

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 anfragenden Bewerbung.

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

Abrufen von Jitterbit-Variablen in einem Script oder einer Transformation

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 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, Jitterbit-Variablen werden auch auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Jitterbit-Variablen angezeigt. Siehe Eine 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-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 Scripts und Transformations, Jitterbit-Variablen werden auch auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Jitterbit-Variablen angezeigt. Siehe Eine Jitterbit-Variable zu einem Script hinzufügen unten.

Einem Script eine Jitterbit-Variable hinzufügen

Entweder in Jitterbit Script oder in JavaScript, das in Scripts verwendet wird die 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 der folgenden 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 verwendet werden, einschließlich mit anderen Variablen oder Schlüsselwörtern. Diese Aktionen werden unten beschrieben:

• Wählen Sie eine Jitterbit-Variable aus
• Formate zwischen Pille und Text umschalten
• Eine Variable entfernen

Wählen Sie eine Jitterbit-Variable aus

Um auf Jitterbit-Variablen zuzugreifen, können 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).

Innerhalb der Liste wird der Variablen- oder Schlüsselworttyp durch das Symbol neben seinem Namen angezeigt:

• für Dateiname-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 im Informations-Popup angezeigten Felder Wert und Beschreibung 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 sollen.

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

Um Informationen zur Variable zu überprüfen, bewegen Sie den Mauszeiger über das Variablenfeld:

Umschalten der Formate zwischen Pille und Text

Um das standardmäßige variable Pillenformat in das Textformat zu ändern, klicken Sie auf das Symbol zum Minimieren:

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

Um von einem Textformat zurück zum Pillenformat zu wechseln, ändern Sie den Fokus vom Feld weg, indem Sie beispielsweise in ein anderes konfigurierbares Feld klicken. Die Feldeingabe kehrt automatisch zum standardmäßigen 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 Einzelheiten zur Verwendung von Jitterbit-Variablen in Projekten.

Erstellen Sie neue Variablen oder setzen Sie Standardwerte für private Agenten

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 Projektvariablen 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).