Projektvariablen im Jitterbit Integration 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 einzigartig 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 nicht für das gesamte Projekt 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.

Beim Bereitstellen einer Projektvariablen, die bereits in der Harmony-Cloud bereitgestellt wurde, werden Ihnen Optionen zur Auswahl der zu verwendenden Werte für die Projektvariablen angezeigt. Dies wird unter Zeitpläne und Projektvariablen auswählen in Projektbereitstellung behandelt.

Erstellen und Aktualisieren von Projektvariablen

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

Die nächsten Abschnitte beschreiben, wie Sie eine neue Projektvariable von verschiedenen Orten in Integration Studio erstellen:

• Projektbereichs-Registerkarte Projektvariablen
• Projektbereich
• Skripteditor
• Transformationszuordnungsmodus
• Endpunktkonfigurationen

Neue Projektvariablen werden mit dem Standardnamen New_Project_Variable erstellt. Nachfolgende neue Projektvariablen mit dem Standardnamen werden mit einer inkrementierten Nummer angehängt.

Sobald eine neue Projektvariable erstellt wurde, konfigurieren Sie sie — abhängig davon, wie sie erstellt wurde — entweder im Bereichsmodus oder einzeln, wie im Folgenden in Projektvariable konfigurieren beschrieben.

Projektbereichs-Registerkarte Projektvariablen

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

Es ist nicht erforderlich, ein Projekt zu öffnen, um auf seine Projektvariablen zuzugreifen. Die Projektvariablen-Registerkarte des Projektbereichs 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 die Projektleiste am unteren Bildschirmrand:

• Tabs: Beim Zugriff auf Protokolle für Operationen oder Workflows sind zusätzliche Tabs oben in der Leiste vorhanden. Diese Tabs sind mit Protokollierung gefolgt vom Namen einer Operation oder eines Workflows beschriftet. Um die Tabs neu anzuordnen, ziehen Sie einen Tab und lassen ihn an der gewünschten Stelle los. Um einen Tab zu schließen, klicken Sie auf das Schließen-Symbol. Das Schließen des letzten Tabs oder das Verwenden des rechts außen befindlichen Schließen-Symbols schließt die Leiste.
• Größe ändern: Die Leiste oben in der Leiste kann verwendet werden, um die Leiste 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 die Leiste ein. Nach dem Einklappen klicken Sie auf das Rückkehrsymbol, um zur vorherigen Ansicht zurückzukehren.
• Erweitern: Erweitert die Leiste auf den Vollbildmodus. Nach dem Erweitern klicken Sie auf das Rückkehrsymbol , um zur vorherigen Ansicht zurückzukehren.
• Schließen: Schließt die Leiste.

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 in Projektvariablen im Leistenansicht 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 Komponenten-Tab des Projektbereichs).

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

Beide Menüoptionen öffnen den Bildschirm zur individuellen Konfiguration von Projektvariablen, wie unter Projektvariable individuell konfigurieren weiter unten auf dieser Seite behandelt.

Skripteditor

Öffnen Sie im Skripteditor die Variablen-Registerkarte der Komponentenpalette und gehen Sie dann zur Projektvariablen-Unterregisterkarte:

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

• Bearbeiten: Um eine vorhandene Projektvariable zu bearbeiten, fahren Sie mit der Maus über den Variablennamen, um zusätzliche Informationen anzuzeigen, und klicken Sie irgendwo auf den Namen der Projektvariable oder das Informations-Popup:

  

Beide Aktionen öffnen den Bildschirm zur individuellen Konfiguration von Projektvariablen, wie unter Projektvariable individuell konfigurieren weiter unten auf dieser Seite behandelt.

Transformationszuordnungsmodus

Öffnen Sie im Transformations-Zuordnungsmodus die Variablen-Registerkarte 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 Bildschirm zur individuellen Konfiguration von Projektvariablen, wie unter Projektvariable individuell konfigurieren weiter unten auf dieser Seite behandelt.

Endpoint-Konfigurationen

Während der Verwendung eines Connectors zur Konfiguration eines Endpunkts klicken Sie in Feldern mit einem Variablen-Icon auf das Icon, um eine Liste der vorhandenen Variablen anzuzeigen. Um eine neue Projektvariable zu erstellen, klicken Sie auf Hinzufügen in der unteren rechten 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 Bearbeiten-Icon ganz rechts.

• Wenn eine vorhandene Projektvariable bereits in einem Konfigurationsfeld verwendet wurde, fahren Sie mit der Maus über die Variablen-Pille, um Informationen über die Variable anzuzeigen, und klicken Sie dann auf das Bearbeiten-Icon oder 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.

Aktionen-Menü für Projektvariablen

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

Jede dieser Menüaktionen ist verfügbar:

Menüelement	Beschreibung
	Anzeigen/Bearbeiten öffnet den individuellen Konfigurationsbildschirm der Projektvariable, um die Projektvariable zu konfigurieren. Für Details siehe 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 derselben 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ängig ist (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.

Konfigurieren einer Projektvariablen

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

• Projektvariablen im Drawer-Ansicht konfigurieren: Die Drawer-Ansicht öffnet sich, wenn Projektvariablen von außerhalb des Projekts auf der Projekte-Seite erstellt oder bearbeitet werden oder wenn Sie Projektvariablen im Projektaktionsmenü auswählen.

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

Projektvariable in der Drawer-Ansicht konfigurieren

Das Konfigurieren einer Projektvariable im Projekt-Drawer ist eine der 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 Orten 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 diese Aktionen zur Verfügung:

• Variable(n) löschen: 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 aus den Feldern der neuen Projektvariable klicken, 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 navigieren und es inline bearbeiten.

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

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

Spalten der Projektvariablen-Tabelle

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.

  Beim Erstellen 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 zuerst mit org, dann 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.

• Default Value: 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.

• Mask Value: Verwenden Sie den Schieberegler, um die Option Mask Value zu aktivieren. Das Aktivieren dieser Option verbirgt den Standardwert, indem er an verschiedenen Stellen in der Benutzeroberfläche durch schwarze Punkte ersetzt wird. 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.

• Label: Geben Sie ein optionales Label ein, um die Variable zu beschreiben. Dieses Label 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.

Konfigurieren einer Projektvariable einzeln

Das Konfigurieren 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 aus dem Projektbereich, innerhalb eines Skripts oder einer Transformation oder innerhalb eines Endpunkt-Konfigurationsbildschirms erstellen oder bearbeiten.

Wenn Sie eine neue Projektvariable erstellen oder eine vorhandene Projektvariable einzeln bearbeiten, wird der Dialog Projektvariable anzeigen/bearbeiten 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; 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.

  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. vorangestellt, 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 weitere 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 UI ausblenden: Verwenden Sie den Schieberegler, um die Option Wert maskieren zu aktivieren. Das Aktivieren dieser Option verbirgt den Standardwert, indem er an verschiedenen Stellen in der Benutzeroberfläche durch schwarze Punkte ersetzt wird. Sie möchten dies möglicherweise verwenden, 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.

  Caution

  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 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 Projektvariable zu speichern und zu schließen.

• 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 Integration 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 Script

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

• $: Mit einem Dollarzeichen $ vorangestellt, ruft das Codebeispiel $org.netsuite.auth.username den Wert der Projektvariable 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 Skriptkomponentenpalette 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 Projektvariable davon ab, ob der Name der Projektvariable einen Punkt enthält.

• Name enthält keinen Punkt (empfohlen): Der Wert einer Projektvariable, 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.

• Namen 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 Skripten und Transformationen werden vorhandene Projektvariablen im Variablen-Tab des Skriptkomponenten-Paletten innerhalb des Projektvariablen-Untertabs 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 Skripten verwendet wird, die innerhalb einer Operation erstellt wurden, werden vorhandene Projektvariablen im Variablen-Tab der Komponentenpalette innerhalb des Projektvariablen-Untertabs angezeigt:

Um die Variablen-Syntax in ein Skript (Jitterbit-Skript oder JavaScript) einzufü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 Sie Projektvariablen in allen Feldern verwenden, die ein Variablen-Symbol haben. Variablen können in Feldern zusammen mit anderen Eingaben 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-Symbol klicken oder eine öffnende eckige Klammer [ eingeben, um eine Liste von Variablen und Schlüsselwörtern anzuzeigen (sofern für das aktuelle Feld verfügbar).

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

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

Der Hintergrund des Symbols 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 Position Ihres 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:

Ansichtskontrollen

Sobald eine Projektvariable ausgewählt wurde, können Sie zwischen Formaten umschalten oder die Projektvariable entfernen:

• Zusammenklappen: Um das Standardformat der Variablen-Pille in das Textformat zu ändern, klicken Sie auf das Zusammenklappen-Symbol:

  

  Um vom Textformat zurück zum Pillenformat zu wechseln, ändern Sie den Fokus von dem Feld, indem Sie beispielsweise in ein anderes konfigurierbares Feld klicken. Die Feldeingabe kehrt automatisch zum Standard-Pillenformat zurück.

• Entfernen: Um die Variable zu entfernen, klicken Sie auf das Entfernen-Symbol.

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 ein Feld Projektvariablenname ein. Beim Speichern (indem der Fokus außerhalb der Zeile verschoben wird, wenn Sie sich im Schubladenansicht befinden, oder indem Sie auf Speichern klicken, wenn Sie sich in der Einzelansicht befinden), werden Sie aufgefordert zu bestätigen, dass Sie die globale Variable in eine Projektvariable konvertieren möchten:

Beim 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 nun auf die Projektvariable verweisen. Beachten Sie, dass ein in einem Skript während der Ausführung der Operationenkette festgelegter Wert für eine Projektvariable den Standardwert überschreibt, der in der Konfiguration der Projektvariable angegeben ist. Ein Klick auf Abbrechen bricht die Konvertierung der globalen Variable ab.

Übertragung von Projektvariablen

Wenn Sie ein Projekt übertragen, haben Sie die Möglichkeit auszuwählen, welche Projektvariablenwerte in der Zielumgebung 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 von der Übertragung ausschließen, um zu vermeiden, dass ihre Werte bei der ersten Übertragung populiert werden, oder um zu verhindern, dass ihre Werte bei nachfolgenden Übertragungen überschrieben werden.

Um Projektvariablen von der Übertragung auszuschließen, wählen Sie die Option Variablenwerte zur Migration auswählen im Projektübertragungsbildschirm. Wenn diese Option ausgewählt ist, werden standardmäßig keine Projektvariablenwerte zur Übertragung ausgewählt. Wenn Sie während der Übertragung Projektvariablenwerte einbeziehen möchten, können Sie diese einzeln auswählen. Für weitere Informationen siehe Projektübertragung in Projekt übertragen.