Globale Variablen im Jitterbit Integration Studio

Einführung

Globale Variablen sind einer der Typen globaler Datenelemente, die in Harmony verfügbar sind. Die anderen Typen globaler Datenelemente - Projektvariablen, Jitterbit-Variablen und Dateinamen-Schlüsselwörter - sind auch global im gesamten Projekt verfügbar. Sie werden unterschiedlich festgelegt, wie in Projektvariablen beschrieben, Jitterbit-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.

Globale Variablen werden zuerst in einer Operation deklariert. Danach können sie in derselben oder in nachlegende Operationen referenziert werden. und Scripts. Downstream-Operationen oder Scripts sind solche, die verknüpft innerhalb einer Operation unter Verwendung von Operation oder die RunOperation oder RunScript Funktionen. Nachgelagerte Vorgänge können innerhalb desselben oder eines nachlegende Workflows erfolgen.

Globale Variablen können auch als Quelle oder Ziel innerhalb der Operation verwendet werden, wie in Variable lesen beschrieben und Variable schreiben.

Sie möchten möglicherweise globale Variablen verwenden, wenn Ihr Anwendungsfall das Teilen von Informationen mit nachfolgenden Teilen einer Operation beinhaltet, wie in diesen Beispielen:

• Verwenden von Werten, die in einer Transformation erstellt wurden, in einer späteren Transformation. Beispielsweise kann eine Sitzungs-ID (die von einem Anmelde-Webdienst zurückgegeben wird) erforderlich sein, wenn nachfolgende Webdienste zur Authentifizierung aufgerufen werden.
• Verwenden eines in einem Teil einer Transformation erstellten Werts in einem späteren Stadium derselben Transformation. Beispielsweise kann eine Datensatznummer für jeden in ein Ziel eingefügten Datensatz initialisiert und erhöht werden, um dessen Artikelnummer zu identifizieren.
• Verwenden eines in einer Transformation zurückgegebenen Werts in der Konfiguration von Komponenten in nachfolgenden Vorgängen. Beispielsweise kann die von einer Transformation zurückgegebene URL Einstellung verwendet werden, um die Webdienst-URL eines nachfolgenden Webdienstaufrufs festzulegen.

Globale Variablen durchlaufen verkettete Operationen. Dazu gehören Operationen, die mit einer vorherigen Operation innerhalb der Operation verknüpft sind, indem die Operation „bei Erfolg“ oder „bei Fehler“ verwendet werden. sowie diejenigen, die über das RunOperation Funktion. Innerhalb derselben Transformation können auch globale Variablen verwendet werden.

Anzeige globaler Variablen

Definierte globale Variablen werden an mehreren Stellen angezeigt:

• Im Projektbereich werden globale Variablen auf der TabKomponenten in der Kategorie Globale Variablen. Von hier aus können Sie sehen, ob an anderer Stelle im Projekt auf die globale Variable verwiesen wird, und Abhängigkeiten anzeigen.
• Im Script Editor, werden globale Variablen in der Skriptkomponentenpalette angezeigt innerhalb der Tab Variablen in der Unterregisterkarte Globale Variablen. Dieser Speicherort bietet einfachen Zugriff zum Einfügen globaler Variablenverweise in Scripts, einschließlich in Transformation im Script.
• Im Transformation Mapping-Modus, werden globale Variablen auf der Tab Variablen links in der Kategorie Globale Variablen angezeigt. Dieser Speicherort bietet einfachen Zugriff zum Einfügen globaler Variablenreferenzen während der Transformation im Zuordnungsmodus.
• In Endpoint, können globale Variablen in allen Feldern aufgerufen und verwendet werden, die eine Variablensymbol. Alternativ zur Auswahl einer globalen Variable können Sie die Variablenreferenz manuell mit der standardmäßigen eckigen Klammersyntax des Jitterbit Script eingeben.

Erstellen und Aktualisieren globaler Variablen

Globale Variablen werden entweder mit Jitterbit Script erstellt oder aktualisiert (in Scripts und Transformations) oder JavaScript (nur in Scripts, die als Projektkomponente erstellt wurden). Siehe Script und -erstellung für Informationen zum Erstellen der verschiedenen Scripts. Globale Variablen, die in einer Variablenverbindung konfiguriert sind, werden automatisch erstellt oder aktualisiert (siehe Variablenverbindung).

Globale Variablennamen

Globale Variablennamen können aus alphanumerischen Zeichen (den Buchstaben a-z und A-Z und den Ziffern 0-9), Punkten (.) und Unterstrichen (_) bestehen. (Andere Zeichen, wie Bindestriche, werden nicht empfohlen und können Probleme verursachen.) Globale Variablennamen berücksichtigen nicht die Groß-/Kleinschreibung. Eine Variable namens GlobalVar wird gleich behandelt wie globalvar.

Es empfiehlt sich, bei der Definition globaler Variablen Punkte oder Unterstriche zu verwenden, damit diese leicht zu finden sind. Beispielsweise kann eine globale Variable, die in einem Jitterbit Script erstellt wurde, den Namen org.account.filename beginnt mit org, gefolgt von account, usw., wodurch es effektiv organisiert wird, wenn es sich in einer Liste zwischen anderen ähnlich konstruierten globalen Variablen befindet. Beachten Sie, dass wir für globale Variablen, die in JavaScript erstellt wurden (oder für globale Variablen in Jitterbit Script, die später in JavaScript verwendet werden könnten), die Verwendung von Unterstrichen anstelle von Punkten empfehlen. Die Verwendung von Punkten in benutzerdefinierten globalen Variablen verursacht zur Laufzeit Probleme. Weitere Informationen finden Sie im JavaScript Unterabschnitt weiter unten.

Jitterbit Script

In Jitterbit Script, die innerhalb von Scripts verwendet werden und Transformations, kann eine globale Variable definiert werden, indem man mit einem Dollarzeichen beginnt $ oder telefonisch unter Set Funktion:

• $: Verwendung des Dollarzeichens $ Syntax, $ServerURL=URL erstellt oder aktualisiert eine globale Variable namens ServerURL mit dem Wert von URL (der Name einer anderen Variable oder der Name eines Felds in einer Transformation).
• Set: Mit dem Set Funktion, Set("ServerURL", URL)erstellt oder aktualisiert eine globale Variable namens ServerURL mit dem Wert von URL (der Name einer anderen Variable oder der Name eines Felds in einer Transformation).

JavaScript

In JavaScript, das innerhalb von Scripts verwendet wird als Projektkomponente erstellt wird, hängt die zum Festlegen einer globalen Variable verwendete Syntax davon ab, ob der Name der globalen Variable einen Punkt enthält:

• Name enthält keinen Punkt (empfohlen): Eine globale Variable, die keinen Punkt im Namen enthält, kann mit erstellt oder aktualisiert werden var $<name> oder einfach aktualisiert werden durch $<name> ohne var:

  • var $: Der Ausdruck var $ServerURL="https://www.example.com/"erstellt oder aktualisiert eine globale Variable ServerURL mit einem Stringwert von https://www.example.com/ Eine neue globale Variable muss vor dem $ mit var.
  • $: Der Ausdruck $ServerURL="https://www.example.com/" aktualisiert die gleiche globale Variable ServerURL mit der gleichen Zeichenfolge URL. Dies funktioniert nur für globale Variablen, die bereits vorhanden sind.

• Name enthält einen Punkt (empfohlen nur für Jitterbit-Variablen und JavaScript-Objektwerte): Eine Variable, die Punkte im Namen enthält, kann in JavaScript nur mit dem Jitterbit.SetVar Und Jitterbit.GetVar Funktionen. Da diese Funktionen nicht für benutzerdefinierte globale Variablen vorgesehen sind, siehe Jitterbit-Variablen für weitere Informationen.

  Warnung

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

Variabler Endpoint

Bei der Konfiguration einer Variablen Verbindung kann eine globale Variable automatisch erstellt oder aktualisiert werden.

Das heißt, wenn Sie während der Konfiguration den Namen einer Variablen angeben, die noch nicht existiert, wird automatisch eine globale Variable erstellt. Wenn Sie den Namen einer globalen Variable angeben, die bereits existiert, wird sie dem Endpoint zugeordnet.

Einzelheiten zum Erstellen oder Aktualisieren einer globalen Variable mit dieser Methode finden Sie unter Variablenverbindung.

Abrufen globaler Variablen in Scripts oder Transformations

Der Wert einer globalen 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).

Jitterbit Script

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

• $: Mit einem Dollarzeichen als Präfix $, das Codebeispiel $serverURL ruft den Wert (oder das Feld in einer Transformation) der globalen Variable namens " ab.serverURL".
• Get: Mit dem Get Funktion, das Codebeispiel Get("serverURL") gibt denselben Wert (oder dasselbe Feld in einer Transformation) zurück.

In Scripts und Transformations werden vorhandene globale Variablen auch auf der Tab Variablen der Skriptkomponentenpalette angezeigt im Unterregister Globale Variablen. Siehe Eine globale Variable zu einem Script hinzufügen unten.

JavaScript

In JavaScript Scripts innerhalb einer Operation hängt die zum Abrufen des Werts einer globalen Variablen verwendete Syntax davon ab, ob der Name der globalen Variablen einen Punkt enthält.

• Name enthält keinen Punkt (empfohlen): Der Wert einer globalen Variable, die keinen Punkt im Namen enthält, kann abgerufen werden, indem sie mit einem Dollarzeichen beginnt $. Mit einem Dollarzeichen als Präfix $, der Ausdruck $ServerURL ruft den Wert der globalen Variable ab, die aufgerufen wird ServerURL.

• Name mit Punkten (nur für Jitterbit-Variablen und JavaScript-Objektwerte empfohlen): Eine Variable, die einen Punkt im Namen enthält, kann in JavaScript nur mit dem Jitterbit.SetVar Und Jitterbit.GetVar Funktionen. Da diese Funktionen nicht für benutzerdefinierte globale Variablen vorgesehen sind, siehe den Abschnitt über Jitterbit-Variablen für weitere Informationen.

  Warnung

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

  In JavaScript sollten Sie nicht die Verwendung von SetVar (Und GetVar) mit $-Präfixierung 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.

  Wenn ein JavaScript fehlschlägt, gehen alle Änderungen am Wert einer globalen Variable verloren. Nur wenn das JavaScript erfolgreich abgeschlossen wird, sind geänderte globale Variablenwerte außerhalb des Script verfügbar.

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

Einem Script eine globale Variable hinzufügen

Entweder in Jitterbit Script oder in JavaScript, das in Scripts verwendet wird im Rahmen einer Operation erstellt wurden, werden vorhandene globale Variablen auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Globale 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 globaler Variablen in Konfigurationsbildschirmen

Während der Konfiguration verschiedener Projektkomponenten, einschließlich der Endpoint mithilfe von Konnektoren können Sie globale 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:

• Eine globale Variable auswählen
• Formate zwischen Pille und Text umschalten
• Einen Standardwert festlegen
• Eine Variable entfernen

Auswählen einer globalen Variable

Um auf globale 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 jeder Variablen- oder Schlüsselworttyp durch das Symbol neben seinem Namen angezeigt:

• für Dateinamenschlü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 Beschreibung im Informations-Popup lautet für eine globale Variable [Keine]. Ein Wert wird nur dann ausgefüllt, wenn die globale Variable einen Standardwert hat in diesem Konfigurationsfeld angegeben.

Der Hintergrund des Symbols ist durchgehend, wenn die globale Variable einen in diesem Konfigurationsfeld angegebenen Standardwert hat, oder leer, wenn dies nicht der Fall ist. Der Hintergrund des Symbols bleibt unberührt, wenn für dieselbe globale Variable ein in einem anderen Konfigurationsfeld angegebener Wert angegeben ist, da nur ein im aktuellen Feld angegebener Standardwert verwendet wird.

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 Standardformat für variable Pillen 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 [ ]:

Im Textformat können Sie einen Standardwert definieren.

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.

Definieren eines Standardwertes

Zur Laufzeit eines Operation wird ein in einem Konfigurationsfeld definierter Standardwert (siehe unten) nur dann verwendet, wenn der Variablenwert während der Laufzeit nicht festgelegt wurde. Dies ist beim Script anders., wobei - da noch keine davorlegende Script instanziiert wurden - stattdessen jeder in einem Konfigurationsfeld definierte Standardwert verwendet wird.

Um einen Standardwert innerhalb eines Konfigurationsfelds zu definieren, schalten Sie zuerst auf Textformat um.

Direkt nach dem globalen Variablennamen in den eckigen Klammern [ ], geben Sie den Standardwert in geschweiften Klammern an { }:

Wenn Standardwerte angegeben werden, wird der globale Variablenwert verwendet, sofern er definiert ist, andernfalls wird der Standardwert verwendet.

Wenn Sie nicht möchten, dass die globale Variable interpretiert wird, verwenden Sie einen Backslash \ um der eckigen Klammer zu entkommen [ ].

Im Folgenden wird beispielsweise nicht der Wert von verwendet serverURL auch wenn es definiert ist, sondern verwendet immer http://server/index.asp:

\[serverURL{http://server/index.asp}]

Entfernen einer Variable

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

Anzeigen globaler Variablenabhängigkeiten

Die Abhängigkeiten einer globalen Variable sind andere Komponenten, die von der Variable abhängen, weil sie entweder aus der globalen Variable lesen oder in sie schreiben. Sobald eine globale Variable erstellt und in einem Projekt verwendet wurde, können Sie diese Abhängigkeiten anzeigen.

Nachdem eine globale Variable erstellt wurde, ist die Option Abhängigkeiten anzeigen auf der Tab Komponenten des Projektbereichs verfügbar (siehe Aktionsmenü im Projektbereich Tab Komponenten). Die Option Abhängigkeiten anzeigen ändert die Ansicht im Projektbereich, um andere Teile des Projekts anzuzeigen, von denen die globale Variable abhängig ist.

In der Abhängigkeitsansicht wird der Name der ausgewählten globalen Variable oben unter den vorhandenen Such- und Filterfunktionen angezeigt. Auf den Namen der globalen Variable folgt eine Liste der Abhängigkeiten, von denen die Variable abhängig ist. Diese Liste ist nach Kategorien wie Aktivität und Script organisiert und weiter unter Lesen oder Schreiben klassifiziert, um den Zugriffstyp einer bestimmten Variablenreferenz anzugeben:

Zum Beispiel:

• Wenn ein Script enthält $myVar1='abc', es schreibt einen Wert in die Variable und referenziert myVar1 für Schreibzugriff.
• Wenn ein Script enthält $myVar2=$myVar1, es verweist myVar2 für Schreibzugriffe und myVar1 für Lesezugriff.
• Wenn ein Script enthält If(myVar1=='abc', TRUE, FALSE), es verweist myVar1 für Lesezugriff.

Anleitungen für globale Variablen

Weitere Informationen zur Verwendung globaler Variablen in Projekten finden Sie in diesen Abschnitten:

• Eine globale Variable in eine Projektvariable umwandeln
• Auf Nullwerte oder undefinierte Werte prüfen
• Array-Variablen festlegen und darauf zugreifen

Konvertieren einer globalen Variable in eine Projektvariable

Sie können eine bereits vorhandene globale Variable in eine Projektvariable umwandeln.

Globale Variablen können während der Projektvariablenkonfiguration in Projektvariablen umgewandelt werden. Geben Sie beim Konfigurieren einer Projektvariable den Namen einer vorhandenen globalen Variable in das Namensfeld ein. Beim Versuch zu speichern werden Sie aufgefordert zu bestätigen, dass Sie die globale Variable in eine Projektvariable umwandeln möchten:

Beim Klicken auf Weiter werden sämtliche Verweise und Abhängigkeiten der globalen Variable auf die Projektvariable übertragen. Dies schließt Verweise auf die ehemalige globale Variable innerhalb von Scripts ein, die nun auf die Projektvariable verweisen. (Beachten Sie, dass ein während der Ausführung der Operation in einem Script festgelegter Wert für eine Projektvariable den in der Projektvariablenkonfiguration angegebenen Standardwert überschreibt.)

Weitere Einzelheiten zu Projektvariablen finden Sie unter Projektvariablen.

Auf Nullwerte oder undefinierte Werte prüfen

Eine globale Variable, die nicht definiert wurde, hat einen Nullwert.

Beispiel: IsNull(Get("GlobalVariableName"))gibt true zurück, wenn eine globale Variable mit dem Namen GlobalVariableName wurde noch nicht definiert. Damit kann geprüft werden, ob eine globale Variable definiert wurde oder nicht.

Festlegen und Zugreifen auf Arrayvariablen

Sie können Arrays globaler Variablen erstellen, auch bekannt als Arrayvariablen. Siehe Arrays für Informationen zum Festlegen und Abrufen von Werten aus Arrayvariablen.