Globale Variablen im Jitterbit Integration Studio

Einführung

Globale Variablen sind einer der in Harmony verfügbaren Typen globaler Datenelemente. Die anderen Typen globaler Datenelemente - Projektvariablen, Jitterbit-Variablen und Dateinamen-Schlüsselwörter - sind ebenfalls 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 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 stehen sie zur Referenzierung in derselben oder in nachlegende Operationen zur Verfügung und Scripts. Downstream-Operationen oder Scripts sind solche, die verknüpft innerhalb einer Operation mithilfe von Operation oder die RunOperation oder RunScript Funktionen. Nachgelagerte Vorgänge können innerhalb desselben oder 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 die gemeinsame Nutzung von Informationen mit nachfolgenden Teilen einer Operation beinhaltet, wie in den folgenden 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 sie die Operation „bei Erfolg“ oder „bei Fehler“ verwenden, sowie diejenigen, die durch die 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 im Tab Komponenten in der Kategorie Globale Variablen. Hier 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 auf der Tab Variablen im Unterregister Globale Variablen. Von hier aus können Sie globale Scripts einfach in Scripts einfügen, auch in Transformation im Script.
• Im Transformation Mapping-Modus werden globale Variablen auf der Tab Variablen links in der Kategorie Globale Variablen angezeigt. Von hier aus können Sie während der Transformation im Zuordnungsmodus einfach auf globale Variablenreferenzen zugreifen.
• In Endpoint, können globale Variablen in allen Feldern aufgerufen und verwendet werden, die über eine Variablensymbol. Alternativ zur Auswahl einer globalen Variable können Sie die Variablenreferenz manuell mit der Standard-Jitterbit Script-Syntax mit eckigen Klammern 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 sowie den Ziffern 0–9), Punkten (.) und Unterstrichen (_) bestehen. (Andere Zeichen, wie z. B. Bindestriche, werden nicht empfohlen und können Probleme verursachen.) Globale Variablennamen berücksichtigen die Groß- und Kleinschreibung nicht. Eine Variable namens GlobalVar wird genauso 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., um sie in einer Liste mit ähnlich aufgebauten globalen Variablen effektiv zu organisieren. Beachten Sie, dass wir für in JavaScript erstellte globale Variablen (oder für Jitterbit Script Globalvariablen, 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 führt zur Laufzeit zu Problemen. Weitere Informationen finden Sie im JavaScript Unterabschnitt weiter unten.

Jitterbit Script

Im Jitterbit Script, das innerhalb von Scripts verwendet wird 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 wurde, hängt die Syntax zum Setzen einer globalen Variable davon ab, ob der Name der globalen Variable einen Punkt enthält:

• Name enthält keinen Punkt (empfohlen): Eine globale Variable, deren Name keinen Punkt enthält, kann mit erstellt oder aktualisiert werden. var $<name>oder einfach aktualisiert werden, indem Sie $<name> ohne var:

  • var $: Der Ausdruck var $ServerURL="https://www.example.com/"erstellt oder aktualisiert eine globale Variable ServerURL mit einem Zeichenfolgenwert 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 bereits vorhandene globale Variablen.

• Name enthält einen Punkt (empfohlen nur für Jitterbit-Variablen und JavaScript-Objektwerte): Eine Variable, die Punkte in ihrem 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 für den 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 noch nicht vorhandenen Variable angeben, wird automatisch eine globale Variable erstellt. Wenn Sie den Namen einer bereits vorhandenen globalen Variable angeben, wird diese 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 Werts einer globalen Variable:

• $: Mit einem Dollarzeichen als Präfix $, das Codebeispiel $serverURL ruft den Wert (oder das Feld in einer Transformation) der globalen Variable mit dem Namen "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, vorhandene globale Variablen werden auch im 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 namens ServerURL.

• Name mit Punkten (empfohlen nur für Jitterbit-Variablen und JavaScript-Objektwerte): Eine Variable, deren Name einen Punkt 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 für den Zugriff auf benutzerdefinierte globale Variablen verwendet werden.

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

  Wenn ein JavaScript fehlschlägt, gehen alle am Wert einer globalen Variable vorgenommenen Änderungen 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 im Tab Variablen der Skriptkomponentenpalette im Untertab Globale Variablen angezeigt. Siehe 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 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 globale 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, einschließlich anderer Variablen oder Schlüsselwörter, verwendet werden. Diese Aktionen werden unten beschrieben:

• Globale Variable auswählen
• Formate zwischen Pille und Text umschalten
• Standardwert festlegen
• Variable entfernen

Auswählen einer globalen Variable

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

• 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 Informationen dazu anzuzeigen:

Die Beschreibung im Informations-Popup lautet für eine globale Variable [Keine]. Ein Wert wird nur dann eingetragen, wenn die globale Variable einen Standardwert hat in diesem Konfigurationsfeld angegeben.

Der Symbolhintergrund ist einfarbig, wenn für die globale Variable in diesem Konfigurationsfeld ein Standardwert angegeben ist, andernfalls leer. Der Symbolhintergrund bleibt unverändert, wenn für dieselbe globale Variable in einem anderen Konfigurationsfeld ein Wert angegeben ist, da nur der im aktuellen Feld angegebene Standardwert verwendet wird.

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. [ ]:

Im Textformat können Sie einen Standardwert definieren.

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.

Definieren eines Standardwerts

Zur Laufzeit eines Operation wird ein in einem Konfigurationsfeld definierter Standardwert (siehe unten) nur verwendet, wenn der Variablenwert zur Laufzeit nicht festgelegt wurde. Anders verhält es sich beim Script, wobei - da noch keine davorlegende Script instanziiert wurden - stattdessen jeder in einem Konfigurationsfeld definierte Standardwert verwendet wird.

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

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

Bei der Angabe von Standardwerten wird der globale Variablenwert verwendet, sofern dieser 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 [ ].

Beispielsweise wird im Folgenden der Wert von nicht 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 unterhalb der vorhandenen Such- und Filterfunktionen angezeigt. Dem 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 zusätzlich 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:

• Globale Variable in Projektvariable konvertieren
• 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 Projektvariablen den Namen einer vorhandenen globalen Variable in das Namensfeld ein. Beim Speichern werden Sie aufgefordert, die Konvertierung der globalen Variable in eine Projektvariable zu bestätigen:

Wenn Sie auf Weiter klicken, werden alle Referenzen und Abhängigkeiten der globalen Variable in die Projektvariable übertragen. Dies gilt auch für Referenzen auf die ehemalige globale Variable innerhalb von Scripts, die nun auf die Projektvariable verweisen. (Beachten Sie, dass ein in einem Script während der Ausführung der Operation 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 nicht definierte globale Variable hat einen Nullwert.

Beispiel: IsNull(Get("GlobalVariableName"))gibt true zurück, wenn eine globale Variable mit dem Namen GlobalVariableName wurde noch nicht definiert. Hiermit lässt sich prüfen, ob eine globale Variable definiert wurde oder nicht.

Festlegen und Zugreifen auf Arrayvariablen

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