Projektvariablen in Jitterbit Studio

Einführung

Projektvariablen sind eine der Arten von globalen Datenelementen, die in Harmony verfügbar sind. Die anderen Arten von globalen Datenelementen — globale Variablen, Jitterbit-Variablen und Dateinamen-Schlüsselwörter — sind ebenfalls global in einem Projekt verfügbar. Sie werden unterschiedlich gesetzt, wie in Globalen Variablen, Jitterbit-Variablen und Dateinamen-Schlüsselwörtern beschrieben. Da jedoch alle globalen Datenelemente denselben Namensraum teilen, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

Projektvariablen werden vor der Laufzeit einer Operation gesetzt und sind in allen Komponenten eines Projekts verfügbar, einschließlich Skripten, Transformationen und Endpunkten, die mit Konnektoren erstellt wurden. 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 Operationenkette erhalten bleibt. Das bedeutet, dass eine Änderung des Wertes einer Projektvariablen zur Laufzeit ihren Wert für das gesamte Projekt nicht aktualisiert.

Häufige Verwendungen von Projektvariablen umfassen Endpunktanmeldeinformationen, Dateinamen oder Variablen, die von Umgebung zu Umgebung variieren können, oder jede Variable, die Sie über die Management-Konsole oder den Citizen Integrator bearbeiten möchten.

Projektvariablen erstellen und aktualisieren

Sie erstellen und aktualisieren Projektvariablen innerhalb von Studio sowie aktualisieren vorhandene Projektvariablen eines bereitgestellten Projekts über die Management-Konsole und den Citizen Integrator.

Diese nächsten Abschnitte beschreiben, wie man eine neue Projektvariable aus verschiedenen Orten im Studio erstellt:

• Projektordners Projektvariablen-Registerkarte
• Projektbereich
• Skripteditor
• Transformationszuordnung
• Endpunktkonfigurationen

Neue Projektvariablen werden mit dem Standardnamen New_Project_Variable erstellt. Nachfolgende neue Projektvariablen mit dem Standardnamen werden mit einer inkrementierten Zahl ergänzt.

Sobald eine neue Projektvariable erstellt wurde, wird sie konfiguriert – abhängig davon, wie sie erstellt wurde – entweder im Ordnersicht oder einzeln, wie im Folgenden in Eine Projektvariable konfigurieren beschrieben.

Projektordners Projektvariablen-Registerkarte

Die Projektvariablen-Registerkarte des Projektordners enthält eine Liste der für ein Projekt erstellten Projektvariablen. Sie umfasst Steuerungen zum Erstellen neuer Projektvariablen sowie zum Bearbeiten und Löschen vorhandener Projektvariablen.

Es ist nicht notwendig, ein Projekt zu öffnen, um auf seine Projektvariablen zuzugreifen. Die Projektvariablen-Registerkarte des Projektordners ist sowohl von außerhalb als auch innerhalb eines Projekts von diesen Orten aus zugänglich:

• Die Projekte-Seite (siehe Kachelansicht oder Listenansicht in Projekte).
• Die Projektwerkzeugleiste (siehe Projektaktionsmenü in Projektwerkzeugleiste).

Beim Auswählen von Projektvariablen öffnet sich der Projektordner am unteren Bildschirmrand:

• Registerkarten: Beim Zugriff auf Protokolle für Operationen oder Workflows sind zusätzliche Registerkarten oben im Ordner vorhanden. Diese Registerkarten sind mit Protokollierung beschriftet, gefolgt vom Namen einer Operation oder eines Workflows. Um Registerkarten neu anzuordnen, ziehen Sie eine Registerkarte und lassen Sie sie fallen. Um eine Registerkarte zu schließen, klicken Sie auf ihr Schließen-Symbol. Das Schließen der letzten Registerkarte oder die Verwendung des rechts außen befindlichen Schließen-Symbols schließt den Ordner.
• Größe ändern: Die Leiste oben im Ordner kann verwendet werden, um den Ordner zu vergrößern oder zu verkleinern. Fahren Sie mit der Maus über die Leiste und ziehen Sie das Größenänderungssymbol nach oben oder unten.
• Einklappen: Klappt den Ordner ein. Nach dem Einklappen klicken Sie auf das Rückkehrsymbol, um zur vorherigen Ansicht zurückzukehren.
• Erweitern: Erweitert den Ordner auf den Vollbildmodus. Nach dem Erweitern klicken Sie auf das Rückkehrsymbol , um zur vorherigen Ansicht zurückzukehren.
• Schließen: Schließt den Ordner.

Um eine vorhandene Projektvariable zu bearbeiten, klicken Sie in die Felder der Projektvariablen-Tabelle und bearbeiten Sie die Werte inline.

Zusätzliche Informationen zum Suchen, Löschen und Konfigurieren von Projektvariablen aus dieser Ansicht finden Sie unter Projektvariablen im Drawer-View konfigurieren weiter unten auf dieser Seite.

Projektbereich

Eine neue Projektvariable kann im Komponenten-Tab des Projektbereichs mit der Option Neu erstellen in der Kategorie Projektvariablen erstellt werden (siehe Aktionenmenü des Komponenten-Tabs im Projektbereich Komponenten-Tab).

Eine vorhandene Projektvariable kann im Komponenten-Tab des Projektbereichs mit der Option Anzeigen/Bearbeiten auf einem Projektvariablenkomponenten bearbeitet werden (siehe Aktionenmenü der Komponente im Projektbereich Komponenten-Tab).

Beide Menüoptionen öffnen den individuellen Konfigurationsbildschirm der Projektvariable, wie unter Eine Projektvariable individuell konfigurieren weiter unten auf dieser Seite behandelt.

Skripteditor

Öffnen Sie im Skripteditor den Variablen-Tab der Komponentenpalette und gehen Sie dann zum Unter-Tab Projektvariablen:

• Neu hinzufügen: Klicken Sie, um eine neue Projektvariable zu erstellen.

• Bearbeiten: Klicken Sie, um den Namen, den Wert, das Label oder die Beschreibung der Variable zu ändern.

• Information: Klicken Sie, um detaillierte Informationen zur Variable anzuzeigen. Dazu gehören das Label, der aktuelle Wert (wenn Wert maskieren deaktiviert ist) und die Beschreibung (sofern angegeben).

• Erweitern/Reduzieren: Diese Option ist nur für Variablen sichtbar, die derzeit verwendet werden. Klicken Sie, um die Nutzungsdetails anzuzeigen oder auszublenden, einschließlich der Komponenten, die von der Variable lesen oder in die Variable schreiben:

  

  Sie können auf den Namen eines beliebigen Komponenten klicken, um den Konfigurationsbildschirm zu öffnen.

Beide Aktionen öffnen den Konfigurationsbildschirm für die einzelnen Projektvariablen, wie im Abschnitt Konfigurieren einer Projektvariablen einzeln weiter unten auf dieser Seite behandelt.

Um eine Projektvariable umzubenennen, klicken Sie mit der rechten Maustaste auf ihren Namen im Skriptbereich eines Skripts und wählen Sie Variable umbenennen aus dem Kontextmenü. Dies aktualisiert automatisch alle Verweise im aktuell geöffneten Skript und in den Komponenten, die im Bestätigungsdialog für die Umbenennung aufgeführt sind.

Transformation Mapping

Öffnen Sie vom Konfigurationsbildschirm einer Transformation den Tab Variablen auf der linken Seite und erweitern Sie die Kategorie Projektvariablen:

• Neue Projektvariable erstellen: Klicken Sie, um eine neue Projektvariable zu erstellen.

• Suchen: Um nach einer bestimmten Variable nach Namen zu suchen, klicken Sie auf das Suchsymbol und geben Sie ein Schlüsselwort oder mehrere durch Kommas getrennte Schlüsselwörter in das Suchfeld ein. Die Suche gibt eine Liste von Variablen zurück, die eines der Schlüsselwörter enthalten.

• Bearbeiten: Um eine vorhandene Projektvariable zu bearbeiten, fahren Sie mit der Maus über den Variablennamen und klicken Sie auf das Bearbeitungssymbol:

Sowohl die Aktionen zum Erstellen einer neuen Projektvariable als auch zum Bearbeiten einer vorhandenen Projektvariable öffnen den Konfigurationsbildschirm für die einzelnen Projektvariablen, wie im Abschnitt Konfigurieren einer Projektvariablen einzeln weiter unten auf dieser Seite behandelt.

Endpunktkonfigurationen

Während Sie einen Connector verwenden, um einen Endpunkt zu konfigurieren, klicken Sie in Feldern mit einem Variablen-Symbol auf das Symbol, um eine Liste der vorhandenen Variablen anzuzeigen. Um eine neue Projektvariable zu erstellen, klicken Sie auf Variable hinzufügen in der unteren linken Ecke:

• Um eine vorhandene Projektvariable aus dieser Liste zu bearbeiten, fahren Sie mit der Maus über die Zeile der Projektvariable und klicken Sie auf das Bearbeitungssymbol ganz rechts.

• Wenn eine vorhandene Projektvariable bereits in einem Konfigurationsfeld verwendet wurde, fahren Sie mit der Maus über die Variable, um Informationen über die Variable anzuzeigen, und klicken Sie dann auf Bearbeiten in der unteren linken Ecke:

  

All diese Aktionen öffnen den individuellen Konfigurationsbildschirm der Projektvariable, wie später auf dieser Seite unter Eine Projektvariable individuell konfigurieren behandelt.

Aktionenmenü für Projektvariablen

Nachdem eine Projektvariable erstellt wurde, sind die Menüaktionen für diese Projektvariable über die Registerkarte Komponenten im Projektbereich zugänglich (siehe Aktionenmenü für Komponenten in Projektbereich Komponenten-Registerkarte).

Jede dieser Menüaktionen ist verfügbar:

Menüelement	Beschreibung
	Anzeigen/Bearbeiten öffnet den individuellen Konfigurationsbildschirm der Projektvariable, um die Projektvariable zu konfigurieren. Weitere Details finden Sie unter Eine Projektvariable individuell konfigurieren später auf dieser Seite.
	Ausschneiden platziert eine Kopie der Projektvariable in Ihrer Zwischenablage und löscht die ursprüngliche Projektvariable aus dem Projekt (siehe Komponentenwiederverwendung).
	Kopieren platziert eine Kopie der Projektvariable in Ihrer Zwischenablage (siehe Komponentenwiederverwendung).
	Duplizieren erstellt eine neue, nicht referenzierte Projektvariable mit der gleichen Konfiguration wie die ursprüngliche Projektvariable (siehe Komponentenwiederverwendung).
	Umbenennen positioniert den Cursor auf dem Namen der Projektvariable, damit Sie bei Bedarf Änderungen vornehmen können.
	Abhängigkeiten anzeigen ändert die Ansicht im Projektbereich, um andere Teile des Projekts anzuzeigen, von denen die Projektvariable abhängt (siehe Komponentenabhängigkeiten, -löschung und -entfernung).
	Zu Gruppe hinzufügen öffnet einen Dialog, um eine neue benutzerdefinierte Gruppe zu erstellen oder die Projektvariable einer bestehenden Gruppe hinzuzufügen (siehe Komponentengruppen).
	Löschen löscht die Projektvariable dauerhaft (siehe Komponentenabhängigkeiten, -löschung und -entfernung).
	Entfernen ist derzeit nicht funktionsfähig.

Ansicht der Abhängigkeiten von Projektvariablen

Die Abhängigkeiten einer Projektvariablen sind die anderen Komponenten, die auf diese Variable verweisen, indem sie von ihr lesen oder in sie schreiben. Nachdem Sie eine Projektvariable in einem Projekt erstellt und verwendet haben, können Sie diese Abhängigkeiten einsehen.

Nachdem Sie eine Projektvariable erstellt haben, wird die Option Abhängigkeiten anzeigen im Tab Komponenten im Projektbereich verfügbar. Weitere Informationen zum Tab Komponenten finden Sie im Aktionsmenü der Komponenten im Tab Komponenten des Projektbereichs.

Die Option Abhängigkeiten anzeigen ändert die Ansicht im Projektbereich, um andere Komponenten des Projekts anzuzeigen, die auf die Projektvariable verweisen.

Alternativ können Sie die Abhängigkeiten von Projektvariablen direkt im Variablen-Tab der Palette der Skriptkomponenten einsehen.

Ansicht der Abhängigkeiten von Projektvariablen

In der Ansicht der Abhängigkeiten erscheint der Name der ausgewählten Projektvariable oben, unter den vorhandenen Such- und Filteroptionen. Der Name der Projektvariable wird gefolgt von einer Liste von Abhängigkeiten, die auf die Variable verweisen.

Die Abhängigkeiten sind nach Kategorien wie Aktivität und Skript organisiert. Innerhalb jeder Kategorie werden die Komponenten als Lesen oder Schreiben klassifiziert, um zu zeigen, wie auf die Variable zugegriffen wird.

Sie können auf den Namen einer beliebigen Komponente klicken, um ihren Konfigurationsbildschirm zu öffnen:

Konfigurieren einer Projektvariable

Sobald eine Projektvariable erstellt wurde, wird sie auf eine von zwei Arten konfiguriert:

• Projektvariablen im Drawer-View konfigurieren: Der Drawer-View öffnet sich, wenn Sie Projektvariablen außerhalb des Projekts auf der Seite Projekte erstellen oder bearbeiten oder wenn Sie Projektvariablen aus dem Aktionsmenü des Projekts auswählen.

• Projektvariable einzeln konfigurieren: Der Dialog für einzelne Projektvariablen öffnet sich, wenn eine Projektvariable direkt aus dem Projektbereich, innerhalb eines Skripts oder einer Transformation oder innerhalb eines Endpunktkonfigurationsbildschirms bearbeitet oder erstellt wird (wie in Projektvariablen erstellen und aktualisieren weiter oben auf dieser Seite beschrieben).

Projektvariable im Drawer-Ansicht konfigurieren

Die Konfiguration einer Projektvariable im Projekt-Drawer ist eine von zwei Ansichten, die zur Konfiguration von Projektvariablen verwendet werden. (Die andere Ansicht wird verwendet, wenn eine einzelne Projektvariable konfiguriert wird.)

Der Projektvariablen-Drawer ist sowohl von außerhalb als auch innerhalb eines Projekts zugänglich. Es ist nicht notwendig, ein Projekt zu öffnen, um auf den Drawer zuzugreifen. Die Option Projektvariablen kann von diesen Standorten aus aufgerufen werden:

• Die Projekte-Seite (siehe Kachelansicht oder Listenansicht in Projekte).
• Die Projekt-Toolbar (siehe Projektaktionsmenü in Projekt-Toolbar).

Beim Zugriff auf den Projektvariablen-Drawer stehen folgende Aktionen zur Verfügung:

• Variable(n) löschen: Nur aktiviert, wenn mindestens eine Projektvariable ausgewählt ist. Klicken Sie, um die Projektvariable dauerhaft zu löschen (siehe Komponentenabhängigkeiten, Löschung und Entfernung).

• Neue Variable: Fügt eine neue Zeile für die Projektvariable am Ende der Tabelle für Projektvariablen hinzu. Alternativ können Sie eine neue Zeile für die Projektvariable hinzufügen, indem Sie den Cursor in das Feld Beschreibung der letzten Zeile setzen und dann die Tab-Taste drücken. Bei beiden Methoden zur Erstellung einer neuen Projektvariable wird der Cursor im Feld Name platziert, damit Sie die Projektvariable umbenennen können:

  

  Vorsicht

  Da alle globalen Datenelemente (globale Variablen, Projektvariablen und Jitterbit-Variablen) denselben Namensraum teilen, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

  Sobald Sie die Felder der neuen Projektvariablen verlassen, wird die Projektvariable gespeichert. Die Sortierreihenfolge kann geändert werden, indem Sie auf die Spaltenüberschrift für Name, Standardwert, Bezeichnung oder Beschreibung klicken.

  Projektvariablen können konfiguriert werden, indem Sie auf jedes Feld innerhalb der Tabelle klicken oder mit der Tabulatortaste dorthin navigieren und es inline bearbeiten.

  Bei neuen Projektvariablen wird die Konfiguration gespeichert, wenn Sie den Fokus aus der Zeile der neuen Projektvariablen verschieben. Bei bestehenden Projektvariablen wird die Konfiguration jedes Mal gespeichert, wenn Sie den Fokus auf ein anderes Feld ändern, selbst innerhalb derselben Zeile der Projektvariablen.

• Suche: Geben Sie ein einzelnes Schlüsselwort oder eine Schlüsselwortzeichenfolge in das Suchfeld ein, um nach einer Projektvariablen anhand ihres Namens oder ihrer Beschreibung zu suchen.

Projektvariablen-Tabellenspalten

Jede Spalte der Projektvariablen-Tabelle wird im Folgenden beschrieben:

• Auswählen: Die Spalte ganz links kann verwendet werden, um eine, mehrere oder alle Projektvariablen zur Löschung auszuwählen. Nachdem mindestens eine Projektvariable ausgewählt wurde, steht die Schaltfläche Variable(n) löschen oben in der Tabelle zur Verfügung, um die Projektvariable dauerhaft zu löschen (siehe Komponentenabhängigkeiten, Löschung und Entfernung).

• Name: Geben Sie den Namen der Projektvariablen ein. Der Name der Projektvariablen muss innerhalb des Projekts eindeutig sein, darf keine Leerzeichen enthalten und kann aus diesen Zeichen bestehen: Buchstaben (a-z, A-Z), Zahlen (0-9), Punkten und Unterstrichen. Andere Zeichen werden nicht empfohlen und können Probleme verursachen. Die Namen der Projektvariablen sind nicht groß-/kleinschreibungssensitiv; zum Beispiel wird eine Variable namens ProjectVar gleich behandelt wie projectvar. Da alle globalen Datenelemente (globale Variablen, Projektvariablen und Jitterbit-Variablen) denselben Namensraum teilen, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

  Bei der Erstellung neuer Projektvariablen ist es eine bewährte Praxis, Projektvariablen mit einem Präfix zu versehen, damit sie später leicht nachgeschlagen werden können. Zum Beispiel wird eine Projektvariable org.netsuite.auth.username zunächst mit org, dann netsuite usw. vorangestellt, um sie effektiv in einer Liste zusammen mit anderen Projektvariablen zu organisieren. Wenn Sie jedoch planen, die Projektvariablen später in JavaScript zu verwenden, empfehlen wir, Unterstriche anstelle von Punkten zu verwenden. Weitere Informationen finden Sie weiter unten in Projektvariablen in Skripten oder Transformationen abrufen.

  Eine vorhandene globale Variable kann in eine Projektvariable umgewandelt werden, indem ihr Name in das Feld Name eingegeben wird. Siehe Eine globale Variable in eine Projektvariable umwandeln für Details.

• Standardwert: Geben Sie einen optionalen Standardwert ein, der als Anfangswert für die Projektvariable verwendet werden soll. Dieser Wert kann später durch Skripting geändert werden. Wenn Sie nicht möchten, dass die Projektvariable einen Standardwert hat, lassen Sie dieses Feld leer.

• Wert maskieren: Verwenden Sie den Schieberegler, um die Option Wert maskieren zu aktivieren. Durch Aktivieren dieser Option wird der Standardwert durch schwarze Punkte an verschiedenen Stellen der Benutzeroberfläche ersetzt. Sie möchten dies möglicherweise verwenden, wenn der Wert sensible Informationen enthält, die nicht auf dem Bildschirm sichtbar sein sollen.

  Vorsicht

  Das Maskieren des Wertes verhindert nicht, dass der Wert in einem Skript zugänglich ist.

• Bezeichnung: Geben Sie eine optionale Bezeichnung ein, um die Variable zu beschreiben. Diese Bezeichnung erscheint, wenn Sie mit der Maus über die Variable in Skripten und in Konfigurationsbildschirmen fahren.

• Beschreibung: Geben Sie eine optionale Beschreibung ein, um weitere Details zur Variable bereitzustellen. Diese Beschreibung erscheint, wenn Sie mit der Maus über die Variable in Skripten und in Konfigurationsbildschirmen fahren.

Eine Projektvariable einzeln konfigurieren

Die Konfiguration einer Projektvariable in einem Dialog ist eine von zwei Ansichten, die zur Konfiguration von Projektvariablen verwendet werden. (Die andere Ansicht ist die Projektvariable Schubladenansicht.)

Diese Ansicht wird verwendet, wenn Sie eine Projektvariable direkt im Projektbereich, innerhalb eines Skripts oder einer Transformation oder im Konfigurationsbildschirm eines Endpunkts erstellen oder bearbeiten.

Wenn Sie eine neue Projektvariable erstellen oder eine vorhandene Projektvariable einzeln bearbeiten, wird der Dialog Projektvariable angezeigt:

• Name der Projektvariable: Geben Sie den Namen der Projektvariable ein, die Sie deklarieren möchten. Der Name der Projektvariable muss innerhalb des Projekts eindeutig sein, darf keine Leerzeichen enthalten und kann aus diesen Zeichen bestehen: Buchstaben (a-z, A-Z), Zahlen (0-9), Punkten und Unterstrichen. Andere Zeichen werden nicht empfohlen und können Probleme verursachen. Die Namen der Projektvariablen sind nicht groß-/kleinschreibungssensitiv; beispielsweise wird eine Variable mit dem Namen ProjectVar gleich behandelt wie projectvar. Da alle globalen Datenelemente (globale Variablen, Projektvariablen und Jitterbit-Variablen) denselben Namensraum teilen, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

  Beim Erstellen neuer Projektvariablen ist es eine bewährte Praxis, Projektvariablen ein Präfix zu geben, damit sie später leicht nachgeschlagen werden können. Zum Beispiel wird eine Projektvariable org.netsuite.auth.username zuerst mit org, dann mit netsuite usw. präfixiert, um sie effektiv in einer Liste unter anderen Projektvariablen zu organisieren. Wenn Sie jedoch planen, die Projektvariablen später in JavaScript zu verwenden, empfehlen wir, Unterstriche anstelle von Punkten zu verwenden. Weitere Informationen finden Sie weiter unten in Projektvariablen in Skripten oder Transformationen abrufen.

  Eine vorhandene globale Variable kann in eine Projektvariable umgewandelt werden, indem ihr Name in das Feld Name eingegeben wird. Siehe Eine globale Variable in eine Projektvariable umwandeln für Details.

• Standardwert: Geben Sie einen optionalen Standardwert ein, der als Anfangswert für die Projektvariable verwendet werden soll. Dieser Wert kann später durch Skripting geändert werden. Wenn Sie nicht möchten, dass die Projektvariable einen Standardwert hat, lassen Sie dieses Feld leer.

• Wert in der Benutzeroberfläche ausblenden: Verwenden Sie den Schieberegler, um die Option Wert maskieren zu aktivieren. Das Aktivieren dieser Option blendet den Standardwert aus, indem er an verschiedenen Stellen in der Benutzeroberfläche durch schwarze Punkte ersetzt wird. Dies kann nützlich sein, wenn der Wert sensible Informationen enthält, die nicht auf dem Bildschirm sichtbar sein sollen. Nach der Aktivierung dieser Option werden Sie aufgefordert zu bestätigen, dass Sie den Wert ausblenden möchten:

  Dialogtext

  Wert maskieren
  Sind Sie sicher? Diese Aktion maskiert den aktuellen Wert und kann nicht rückgängig gemacht werden.

  Vorsicht

  Das Maskieren des Wertes verhindert nicht, dass der Wert in einem Skript zugänglich ist.

  Wenn Sie diese Option nach der Aktivierung deaktivieren, werden Sie aufgefordert zu bestätigen, dass Sie den aktuellen Wert entfernen möchten (da ein zuvor ausgeblendeter Wert nicht wieder eingeblendet werden kann):

  Dialogtext

  Wert wiederherstellen und aktualisieren
  Sind Sie sicher? Diese Aktion aktualisiert den aktuellen Wert und kann nicht rückgängig gemacht werden.

  Nach dem Klicken auf Weiter wird der Cursor in ein leeres Feld für den Standardwert positioniert.

• Bezeichnung: Geben Sie eine optionale Bezeichnung ein, um die Variable zu beschreiben. Diese Bezeichnung erscheint, wenn Sie mit der Maus über die Variable in Skripten und in Konfigurationsbildschirmen fahren.

• Beschreibung: Geben Sie eine optionale Beschreibung ein, um weitere Details zur Variable bereitzustellen. Diese Beschreibung erscheint, wenn Sie mit der Maus über die Variable in Skripten und in Konfigurationsbildschirmen fahren.

• Speichern: Klicken Sie, um die Konfiguration der Projektvariablen zu speichern und zu schließen.

• Speichern & Neu: Klicken Sie, um zu speichern und die Konfiguration der Projektvariablen für eine neue Variable zu öffnen.

• Löschen: Nachdem Sie eine vorhandene Projektvariable geöffnet haben, klicken Sie, um die Projektvariable dauerhaft zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung).

Projektvariablen in Skripten oder Transformationen abrufen

Im Studio kann der Wert einer Projektvariable entweder mit Jitterbit Script in Skripten oder Transformationen oder nur mit JavaScript in als Projektkomponente erstellten Skripten zurückgegeben werden.

Jitterbit-Skript

In Skripten und Transformationen können Sie mit einem Dollarzeichen $ beginnen oder die Funktion Get verwenden, um den Wert einer Projektvariablen abzurufen.

• $: Mit einem Dollarzeichen $ vorangestellt, ruft das Codebeispiel $org.netsuite.auth.username den Wert der Projektvariablen mit dem Namen "org.netsuite.auth.username" ab.
• Get: Mit der Funktion Get gibt das Codebeispiel Get("org.netsuite.auth.username") denselben Wert zurück.

In Skripten und Transformationen werden vorhandene Projektvariablen im Tab Variablen der Skriptkomponenten-Palette im Untertab Projektvariablen angezeigt. Siehe Fügen Sie eine Projektvariable zu einem Skript hinzu unten.

JavaScript

In JavaScript, das innerhalb von Skripten innerhalb einer Operation verwendet wird, hängt die Syntax zum Abrufen des Wertes einer Projektvariablen davon ab, ob der Name der Projektvariablen einen Punkt enthält.

• Name enthält keinen Punkt (empfohlen): Der Wert einer Projektvariablen, die keinen Punkt in ihrem Namen enthält, kann abgerufen werden, indem man mit einem Dollarzeichen $ voranstellt.

  • $: Mit einem Dollarzeichen $ vorangestellt, ruft das Codebeispiel $org_netsuite_auth_username den Wert der Projektvariablen mit dem Namen "org_netsuite_auth_username" ab.

• Name mit Punkten (nur für Jitterbit-Variablen und JavaScript-Objektwerte empfohlen): Eine Variable, die einen Punkt in ihrem Namen enthält, kann in JavaScript nur mit den Funktionen Jitterbit.SetVar und Jitterbit.GetVar aktualisiert oder abgerufen werden. Da diese Funktionen nicht für benutzerdefinierte Projektvariablen gedacht sind, siehe den Abschnitt über Jitterbit-Variablen für weitere Informationen.

In Scripts und Transformationen werden vorhandene Projektvariablen im Variablen-Tab der Skriptkomponentenpalette im Projektvariablen-Untertab angezeigt. Siehe Fügen Sie eine Projektvariable zu einem Skript hinzu unten.

Fügen Sie eine Projektvariable zu einem Skript hinzu

In Jitterbit Script oder JavaScript, das innerhalb von Scripts erstellt wurde, werden vorhandene Projektvariablen im Variablen-Tab der Komponentenpalette im Projektvariablen-Untertab angezeigt:

Um die Variablen-Syntax zu einem Skript (Jitterbit Script oder JavaScript) hinzuzufügen, verwenden Sie eine dieser Methoden:

• Ziehen Sie die Variable aus der Palette in das Skript, um die Variablen-Syntax einzufügen.
• Doppelklicken Sie auf die Variable in der Palette, um die Variablen-Syntax an der Position des Cursors im Skript einzufügen.
• Beginnen Sie, den Variablennamen einzugeben, und drücken Sie dann Control+Space, um eine Liste von Autocomplete-Vorschlägen anzuzeigen. Wählen Sie eine Variable aus, um die Variablen-Syntax einzufügen.
• Geben Sie die Variablen-Syntax manuell ein.

Projektvariablen in Konfigurationsbildschirmen verwenden

Während der Konfiguration bestimmter Projektkomponenten, einschließlich der Endpunktkonfiguration mit Konnektoren, können Projektvariablen in allen Feldern verwendet werden, die ein Variablen-Icon haben. Variablen können zusammen mit anderen Eingaben in Feldern verwendet werden, einschließlich anderer Variablen oder Schlüsselwörter.

Eine Projektvariable auswählen

Um auf Projektvariablen zuzugreifen, können Sie entweder auf das Variablen-Icon klicken oder eine offene eckige Klammer [ eingeben, um ein Menü anzuzeigen, das Variablen und Schlüsselwörter auflistet (sofern für das aktuelle Feld verfügbar).

Innerhalb der Liste wird der Typ der Variablen oder des Schlüsselworts durch das Icon neben ihrem Namen angezeigt:

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

Der Hintergrund des Icons ist durchgehend, wenn die Projektvariable einen Standardwert hat, der in der Konfiguration der Projektvariable selbst angegeben ist, oder leer, wenn dies nicht der Fall ist.

Wählen Sie eine Variable aus, um sie an der Stelle des Cursors im Feld hinzuzufügen, überall im String. Die Variable wird in einem Pillenformat angezeigt, ähnlich dem unten gezeigten:

Um Informationen über die Variable zu überprüfen, fahren Sie mit der Maus über die Variable-Pille, um ein Informations-Popup anzuzeigen:

Um die Variableneinstellungen zu bearbeiten, klicken Sie auf Bearbeiten, um den Projektvariablen Dialog zu öffnen.

Eine Variable entfernen

Um eine Variable zu entfernen, klicken Sie auf das Entfernen-Icon:

Anleitungen zu Projektvariablen

Dieser Abschnitt bietet Informationen darüber, wie spezifische Aufgaben mit Projektvariablen abgeschlossen werden können.

Konvertieren einer globalen Variable in eine Projektvariable

Um eine vorhandene globale Variable in eine Projektvariable zu konvertieren, geben Sie den Namen der vorhandenen globalen Variable in das Feld Projektvariablenname ein. Beim Speichern (indem der Fokus außerhalb der Zeile verschoben wird, wenn Sie sich im Drawer-Ansicht befinden, oder durch Klicken auf Speichern, wenn Sie sich in der Einzelansicht befinden) werden Sie aufgefordert zu bestätigen, dass Sie die globale Variable in eine Projektvariable konvertieren möchten:

Durch Klicken auf Weiter werden alle Verweise auf und Abhängigkeiten von der globalen Variable auf die Projektvariable übertragen. Dazu gehören Verweise auf die frühere globale Variable innerhalb von Skripten, die jetzt auf die Projektvariable verweisen. Beachten Sie, dass ein Wert für eine Projektvariable, der in einem Skript während der Ausführung der Operationenkette festgelegt wird, den Standardwert überschreibt, der in der Konfiguration der Projektvariable angegeben ist. Ein Klick auf Abbrechen bricht die Konvertierung der globalen Variable ab.

Projektvariablen übertragen

Wenn Sie ein Projekt übertragen, haben Sie die Möglichkeit auszuwählen, welche Projektvariablenwerte im Zielumfeld ausgeschlossen werden sollen.

Dies ermöglicht es Ihnen, die Werte der Projektvariablen in einer Umgebung getrennt zu halten. Zum Beispiel möchten Sie möglicherweise separate Projektvariablenwerte für eine Endpunkt-Host-URL für eine _Produktions-_Umgebung und eine separate Sandbox-Endpunkt-Host-URL für eine _QA-_Umgebung beibehalten.

Sie möchten möglicherweise bestimmte Projektvariablenwerte vom Transfer ausschließen, um zu vermeiden, dass ihre Werte beim ersten Transfer populiert werden, oder um zu vermeiden, dass ihre Werte bei nachfolgenden Transfers überschrieben werden.

Um Projektvariablen vom Transfer auszuschließen, wählen Sie die Option Variablenwerte zum Migrieren auswählen im Bildschirm für den Projekttransfer aus. Wenn diese Option ausgewählt ist, werden standardmäßig keine Projektvariablenwerte für den Transfer ausgewählt. Wenn Sie während des Transfers Projektvariablenwerte einbeziehen möchten, können Sie diese einzeln auswählen. Weitere Informationen finden Sie unter Projekttransfer in Ein Projekt übertragen.