Projektvariablen im Jitterbit Design Studio

Einführung

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

Projektvariablen werden zunächst über Design Studio erstellt. Nachdem eine Projektvariable erstellt wurde, können Sie Werte entweder über Design Studio, die Management Console oder Citizen Integrator festlegen. Dies bietet die Flexibilität, Parameter und Anmeldeinformationen festzulegen und zu ändern, ohne das Projekt erneut bereitstellen zu müssen.

Projektvariablen werden vor der Laufzeit der Operation festgelegt und können für alle Projektelemente verwendet werden, einschließlich Quellen und Zielen, Scripts und Transformations. Wenn Sie den Wert einer Projektvariablen während der Laufzeit der Operation ändern, wird die Variable als globale Variable behandelt, wobei der geänderte Wert nur für die Dauer der Operation bestehen bleibt. Das heißt, wenn der Wert einer Projektvariablen zur Laufzeit geändert wird, wird ihr Wert nicht für das gesamte Projekt aktualisiert.

Zu den üblichen Verwendungszwecken von Projektvariablen gehören Endpoint, Dateinamen oder Variablen, die sich von Umfeld zu Umfeld ändern können. Dies umfasst alle Variablen, die Sie über die Management Console bearbeiten möchten oder Citizen Integrator.

Erstellen und Aktualisieren von Projektvariablen

Sie erstellen und aktualisieren Projektvariablen in Design Studio. Nach der Erstellung in Design Studio können Projektvariablen in der Management Console und im Citizen Integrator aktualisiert werden.

Design Studio

In Ihrem Projekt in Design Studio haben Sie folgende Möglichkeiten, eine neue Projektvariable zu erstellen:

• Gehen Sie zu Datei > Neu > Neue Projektvariable; oder
• Klicken Sie im Baum links mit der rechten Maustaste auf den Abschnitt Projektvariablen und wählen Sie Neue Projektvariable; oder
• Klicken Sie in der oberen Symbolleiste auf das Formelsymbol .

In der Hauptansicht von Design Studio wird ein Konfigurationsbildschirm geöffnet, in dem Sie Ihre Projektvariable bearbeiten können. Sie können über den Baum links unter Projektvariablen: zu einer vorhandenen Projektvariablenkonfiguration zurückkehren.

Der Bildschirm zur Konfiguration der Projektvariablen sieht ungefähr wie dieses Beispiel aus:

• Name: Das Namensfeld ist der Variablenname, den Sie deklarieren. Das Namensfeld darf nicht leer bleiben und keine Leerzeichen enthalten. Der Name ersetzt den Standardplatzhalter „NewProjectVariable“, wie im Baum links zu sehen. Sie können den Namen der Projektvariable nicht als Standardplatzhalter belassen. Namen 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.) Projektvariablennamen berücksichtigen nicht die Groß-/Kleinschreibung; eine Variable namens GlobalVar wird gleich behandelt wie globalvar.

  Notiz

  Es kann sinnvoll sein, 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 nach Domänen organisiert wird, wenn es sich in einer Liste zwischen anderen ähnlich konstruierten globalen Variablen befindet. Beachten Sie, dass wir für in JavaScript erstellte globale Variablen (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 in JavaScript verursacht zur Laufzeit Probleme. Weitere Informationen finden Sie im Unterabschnitt JavaScript unten.

  Warnung

  Wenn Sie Ihre Projektvariablen später in JavaScript verwenden möchten, wird empfohlen, Unterstriche anstelle von Punkten zu verwenden. Weitere Informationen finden Sie weiter unten unter Projektvariablen in Scripts oder Transformations verwenden.

• Standardwert: Geben Sie ggf. einen Standardwert für die Projektvariable ein. Wenn Sie keinen Standardwert wünschen, lassen Sie dieses Feld leer. Der Standardwert, sofern angegeben, wird als Anfangswert verwendet und kann durch Skripting geändert werden.

• Wert ausblenden: Aktivieren Sie das Kontrollkästchen, um den Wert der Projektvariable auszublenden, indem Sie ihn bei der Anzeige in der Benutzeroberfläche durch Sternchen ersetzen. Sie können dies verwenden, wenn der Wert vertrauliche Informationen enthält, die in der Benutzeroberfläche nicht sichtbar sein sollen. Wenn Sie das Kontrollkästchen Wert ausblenden deaktivieren, werden alle vorhandenen Werte entfernt, die als Standardwert eingegeben wurden.

  Vorsicht

  Das Ausblenden des Wertes verhindert nicht, dass auf den Wert in einem Script zugegriffen werden kann. Es blendet lediglich die Anzeige des Wertes aus.

• Bezeichnung: Geben Sie bei Bedarf eine Bezeichnung zur Beschreibung des Variablennamens ein. Diese Bezeichnung wird angezeigt, wenn Sie in Scripts mit dem Cursor über den Variablennamen fahren.

• Beschreibung: Geben Sie bei Bedarf eine Beschreibung ein, um weitere Details zur Variable bereitzustellen.

Management Console

Sobald eine Projektvariable erstellt wurde, können Sie sie in der Management Console bearbeiten unter Projekte der Tab Projektvariablen.

Um die Projektvariable zum Bearbeiten zu öffnen, wählen Sie im Dropdown-Menü Aktion Bearbeiten: aus

Im Popup können Sie den Wert bearbeiten, den Wert anzeigen oder ausblenden oder die Beschreibung bearbeiten.

Citizen Integrator

Sobald eine Projektvariable erstellt wurde, kann sie in Citizen Integrator-Rezepten verwendet werden. Siehe Citizen Integrator - Rezept konfigurieren für weitere Informationen.

Abrufen von Projektvariablen in Scripts oder Transformations

In Design Studio kann der Wert einer Projektvariable entweder mit Jitterbit Script zurückgegeben werden oder JavaScript.

Jitterbit Script

In Scripts und Transformations können Sie mit einem Dollarzeichen beginnen $ gefolgt vom Namen der Projektvariable oder verwenden Sie das Get() Funktion zum Abrufen des Wertes einer Projektvariable:

• $: Beginnt mit einem Dollarzeichen $, das Beispiel von $org.netsuite.auth.username gibt denselben Wert (oder dasselbe Feld in einer Transformation) zurück.
• Get: Mit der Funktion Get() Funktion, das Beispiel von Get("org.netsuite.auth.username") erhält den Wert (oder das Feld in einer Transformation) der Projektvariable namens org.netsuite.auth.username.

JavaScript

In JavaScript, das in Scripts verwendet wird, die innerhalb einer Operation erstellt werden, hängt die zum Abrufen des Werts einer Projektvariablen verwendete Syntax davon ab, ob der Name der Projektvariablen einen Punkt enthält.

• Name enthält keinen Punkt (empfohlen): Der Wert einer Projektvariablen, die keinen Punkt im Namen enthält, kann abgerufen werden, indem sie mit einem Dollarzeichen beginnt $.

  • $: Beginnt mit einem Dollarzeichen $, das Beispiel von $org_netsuite_auth_username gibt den Wert der Projektvariable zurück namens org_netsuite_auth_username.

• Namen 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 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 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 Variablen außerhalb des Script verfügbar.

Projektvariablen in Definitionsbildschirmen verwenden

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

Wenn Sie beispielsweise die Projektvariable als Teil eines Dateinamens oder als Eigenschaft eines anderen Objekts verwenden, das sich nicht in einem Script befindet, können Sie sie mit Klammern referenzieren, wie etwa [org.netsuite.auth.username].