Projektvariablen im Jitterbit Integration Studio

Einführung

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

Projektvariablen werden vor der Laufzeit einer Operation festgelegt und stehen für die Verwendung in allen Komponenten eines Projekts zur Verfügung, einschließlich Scripts, Transformations und Endpoints, die mit Konnektoren erstellt wurden. Wenn Sie den Wert einer Projektvariablen während der Laufzeit Operation, 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, oder alle Variablen, die Sie über die Management Console bearbeiten möchten oder Citizen Integrator.

Beim Bereitstellen einer Projektvariablen, die bereits in der Harmony-Cloud bereitgestellt wurde, stehen Ihnen Optionen zur Auswahl der zu verwendenden Projektvariablenwerte zur Verfügung. Dies wird unter Zeitpläne und Projektvariablen auswählen beschrieben in Projektbereitstellung.

Erstellen und Aktualisieren von Projektvariablen

Sie erstellen und aktualisieren Projektvariablen innerhalb von Integration Studio und aktualisieren vorhandene Projektvariablen eines bereitgestellten Projekts über die Management Console und Citizen Integrator.

In den folgenden Abschnitten wird beschrieben, wie Sie an verschiedenen Stellen in Integration Studio eine neue Projektvariable erstellen:

• Tab „Projektvariablen“ der Projektschublade
• Projektbereich
• Script
• Transformation
• Endpoint

Neue Projektvariablen werden mit dem Standardnamen erstellt New_Project_Variable. Nachfolgende neue Projektvariablen mit dem Standardnamen erhalten eine fortlaufende Nummer.

Sobald eine neue Projektvariable erstellt wurde, konfigurieren Sie sie - je nachdem, wie sie erstellt wurde - entweder in der Schubladenansicht oder einzeln, wie unten unter Projektvariable konfigurieren beschrieben.

Tab „Projektvariablen“ der Projektschublade

Die Tab Projektvariablen der Projektschublade enthält eine Liste der für ein Projekt erstellten Projektvariablen. Sie enthält Steuerelemente 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 Tab Projektvariablen der Projektschublade ist sowohl von außerhalb als auch innerhalb eines Projekts von folgenden Stellen aus zugänglich:

• Die Seite Projekte (siehe Kachel-Ansicht oder Listenansicht in Projekte).
• Die Projektsymbolleiste (siehe Aktionsmenü in der Projektsymbolleiste).

Wenn Sie Projektvariablen auswählen, öffnet sich die Projektleiste am unteren Bildschirmrand:

• Tabs: Beim Zugriff auf Protokolle für Vorgänge oder Workflows, sind zusätzliche Registerkarten am oberen Rand der Schublade vorhanden. Diese Registerkarten sind mit Protokollierung gefolgt vom Namen einer Operation oder eines Workflow beschriftet. Um die Registerkarten neu anzuordnen, ziehen Sie Tab per Drag & Drop. Um eine Tab zu schließen, klicken Sie auf deren Schließen-Symbol. Schließen Sie die letzte Tab oder verwenden Sie das Symbol ganz rechts Das Schließen-Symbol schließt die Schublade.
• Größe ändern: Die Leiste oben in der Schublade kann verwendet werden, um die Größe der Schublade zu ändern. Bewegen Sie den Mauszeiger über die Leiste und ziehen Sie das Vergrößern oder verkleinern Sie das Symbol.
• Reduzieren: Reduziert die Schublade. Klicken Sie nach dem Reduzieren auf das Zurück-Symbol, um zur vorherigen Ansicht zurückzukehren.
• Erweitern: Erweitert die Schublade auf den Vollbildmodus. Klicken Sie nach dem Erweitern auf das Zurück-Symbol um zur vorherigen Ansicht zurückzukehren.
• Schließen: Schließt die Schublade.

Um eine vorhandene Projektvariable zu bearbeiten, klicken Sie in die Felder der Projektvariablentabelle und bearbeiten Sie die Werte direkt.

Weitere Informationen zum Suchen, Löschen und Konfigurieren von Projektvariablen in dieser Ansicht finden Sie unter [Projektvariablen in der Schubladenansicht konfigurieren].#configure-a-project-variable-in-drawer-view) weiter unten auf dieser Seite.

Projektbereich

Eine neue Projektvariable kann über die Tab Komponenten des Projektbereichs mithilfe der Option Neu erstellen in der Kategorie Projektvariablen erstellt werden (siehe Aktionsmenü der Tab Komponenten im Projektbereich Tab Komponenten).

Eine vorhandene Projektvariable kann über die Tab Komponenten des Projektbereichs mithilfe der Option Anzeigen/Bearbeiten einer Projektvariablenkomponente bearbeitet werden (siehe Aktionsmenü im Projektbereich Tab Komponenten).

Beide Menüoptionen öffnen den Konfigurationsbildschirm für individuelle Projektvariablen, wie unter [Projektvariable individuell konfigurieren] beschrieben.#configure-a-project-variable-individually) weiter unten auf dieser Seite.

Script Editor

Aus dem Script Editor, öffnen Sie die Tab Variablen der Komponentenpalette und gehen Sie dann zur Unterregisterkarte Projektvariablen:

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

• Bearbeiten: Um eine bestehende Projektvariable zu bearbeiten, bewegen Sie den Mauszeiger über den Variablennamen, um weitere Informationen anzuzeigen, und klicken Sie anschließend auf eine beliebige Stelle im Namen der Projektvariable oder im Informations-Popup:

  

Beide Aktionen öffnen den Konfigurationsbildschirm für individuelle Projektvariablen, wie unter [Projektvariable individuell konfigurieren] beschrieben.#configure-a-project-variable-individually) weiter unten auf dieser Seite.

Transformation

Von der Transformation Mapping-Modus, öffnen Sie links die Tab Variablen und erweitern Sie die Kategorie Projektvariablen:

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

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

• Bearbeiten: Um eine vorhandene Projektvariable zu bearbeiten, bewegen Sie den Mauszeiger über den Variablennamen und klicken Sie auf das Bearbeiten-Symbol:

Sowohl das Erstellen einer neuen Projektvariable als auch das Bearbeiten einer bestehenden Projektvariable öffnet den Konfigurationsbildschirm für individuelle Projektvariablen, wie unter [Projektvariable individuell konfigurieren] beschrieben.#configure-a-project-variable-individually) weiter unten auf dieser Seite.

Endpoint

Bei Verwendung eines Connectors, um einen Endpoint zu konfigurieren, in Feldern, die eine Klicken Sie auf das Variablensymbol, um eine Liste der vorhandenen Variablen anzuzeigen. Um eine neue Projektvariable zu erstellen, klicken Sie unten rechts auf Hinzufügen:

• Um eine vorhandene Projektvariable aus dieser Liste zu bearbeiten, bewegen Sie den Mauszeiger über die Zeile der Projektvariable und klicken Sie auf Bearbeiten-Symbol ganz rechts.

• Wenn eine vorhandene Projektvariable bereits in einem Konfigurationsfeld verwendet wurde, bewegen Sie den Mauszeiger über die Variablen-Pille, um Informationen zur Variable anzuzeigen, und klicken Sie dann unten links auf das Bearbeitungssymbol oder Bearbeiten:

  

Alle diese Aktionen öffnen den Konfigurationsbildschirm für individuelle Projektvariablen, wie unter Projektvariable individuell konfigurieren beschrieben weiter unten auf dieser Seite.

Aktionsmenü“

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

Die folgenden Menüaktionen sind verfügbar:

Menüpunkt	Beschreibung
	Anzeigen/Bearbeiten öffnet den Konfigurationsbildschirm für individuelle Projektvariablen, in dem Sie die Projektvariable konfigurieren können. Weitere Informationen finden Sie unter Projektvariable individuell konfigurieren weiter unten auf dieser Seite.
	Ausschneiden legt eine Kopie der Projektvariable in Ihre Zwischenablage und löscht die ursprüngliche Projektvariable aus dem Projekt (siehe Komponentenwiederverwendung).
	Kopieren legt eine Kopie der Projektvariable in Ihre Zwischenablage (siehe Komponentenwiederverwendung).
	Duplikat erstellt eine neue, nicht referenzierte Projektvariable mit derselben Konfiguration wie die ursprüngliche Projektvariable (siehe Komponentenwiederverwendung).
	Umbenennen positioniert den Cursor auf den Namen der Projektvariablen, damit Sie bei Bedarf Änderungen vornehmen können.
	Abhängigkeiten anzeigen ändert die Ansicht im Projektbereich, um alle anderen Teile des Projekts anzuzeigen, von denen die Projektvariable abhängig ist (siehe Komponentenabhängigkeiten, Löschen und Entfernen).
	Zur Gruppe hinzufügen öffnet einen Dialog zum Erstellen einer neuen benutzerdefinierten Gruppe oder zum Hinzufügen der Projektvariable zu einer vorhandenen Gruppe (siehe Komponentengruppen).
	Löschen löscht die Projektvariable dauerhaft (siehe Komponentenabhängigkeiten, Löschen und Entfernen).
	Entfernen ist derzeit nicht funktionsfähig.

Konfigurieren einer Projektvariablen

Sobald eine Projektvariable erstellt wurde, kann sie auf eine der folgenden Arten konfiguriert werden:

• Projektvariablen in der Schubladenansicht konfigurieren: Die Schubladenansicht wird geöffnet, wenn Sie Projektvariablen außerhalb des Projekts auf der Seite Projekte erstellen oder bearbeiten oder wenn Sie Projektvariablen aus dem Aktionsmenü auswählen.

• Projektvariable individuell konfigurieren: Der Dialog für einzelne Projektvariablen wird geöffnet, wenn Sie eine Projektvariable direkt im Projektbereich, in einem Script oder einer Transformation oder in einem Endpoint bearbeiten oder erstellen (wie unter [Projektvariablen erstellen und aktualisieren] beschrieben).#create-and-update-project-variables) weiter oben auf dieser Seite).

Konfigurieren einer Projektvariablen in der Schubladenansicht

Konfigurieren einer Projektvariablen in der Projektleiste ist eine von zwei Ansichten zum Konfigurieren von Projektvariablen. (Die andere Ansicht wird zum Konfigurieren einer einzelnen Projektvariablen verwendet.)

Die Projektvariablen-Schublade ist sowohl von außerhalb als auch innerhalb eines Projekts zugänglich. Es ist nicht erforderlich, ein Projekt zu öffnen, um auf die Schublade zuzugreifen. Die Option Projektvariablen kann von folgenden Stellen aus aufgerufen werden:

• Die Seite Projekte (siehe Kachelansicht oder Listenansicht in Projekte).
• Die Projektsymbolleiste (siehe Aktionsmenü in der Projektsymbolleiste).

Beim Zugriff auf die Projektvariablen-Schublade stehen folgende Aktionen zur Verfügung:

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

• Neue Variable: Fügt eine neue Projektvariablenzeile am Ende der Projektvariablentabelle hinzu. Alternativ können Sie eine neue Projektvariablenzeile hinzufügen, indem Sie den Cursor in das Feld Beschreibung der letzten Zeile setzen und dann auf die Schaltfläche Tab Schlüssel. Bei beiden Methoden zum Erstellen 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 Namespace verwenden, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

  Sobald Sie aus den Feldern der neuen Projektvariable klicken, wird diese gespeichert. Sie können die Sortierreihenfolge ändern, indem Sie auf die Header für Name, Standardwert, Beschriftung oder Beschreibung klicken.

  Projektvariablen können konfiguriert werden, indem Sie auf die einzelnen Felder in der Tabelle klicken oder mit der Tabulatortaste navigieren und diese direkt bearbeiten.

  Bei neuen Projektvariablen wird die Konfiguration gespeichert, wenn Sie den Fokus aus der neuen Projektvariablenzeile verschieben. Bei vorhandenen Projektvariablen wird die Konfiguration jedes Mal gespeichert, wenn Sie den Fokus auf ein anderes Feld verschieben, auch innerhalb derselben Projektvariablenzeile.

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

Spalten der Projektvariablentabelle

Die einzelnen Spalten der Projektvariablentabelle werden im Folgenden beschrieben:

• Auswählen: In der Spalte ganz links können Sie eine, mehrere oder alle Projektvariablen zum Löschen auswählen. Nachdem Sie mindestens eine Projektvariable ausgewählt haben, können Sie diese über die Schaltfläche Variable(n) löschen oben in der Tabelle dauerhaft löschen (siehe Komponentenabhängigkeiten, Löschen und Entfernen).

• Name: Geben Sie den Namen der Projektvariable ein. Der Name der Projektvariable muss innerhalb des Projekts eindeutig sein, darf keine Leerzeichen enthalten und kann aus folgenden Zeichen bestehen: Buchstaben (a–z, A–Z), Zahlen (0–9), Punkten und Unterstrichen. Andere Zeichen werden nicht empfohlen und können Probleme verursachen. Bei Projektvariablennamen wird die Groß- und Kleinschreibung nicht berücksichtigt. Beispielsweise lautet eine Variable namens ProjectVar wird genauso behandelt wie projectvar Da alle globalen Datenelemente (globale Variablen, Projektvariablen und Jitterbit-Variablen) denselben Namespace verwenden, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

  Beim Erstellen neuer Projektvariablen empfiehlt es sich, Projektvariablen mit einem Präfix zu versehen, damit sie später leicht nachgeschlagen werden können. Beispielsweise kann eine Projektvariable org.netsuite.auth.username wird zuerst vorangestellt mit org, Dann netsuite usw., um sie effektiv in einer Liste mit anderen Projektvariablen zu organisieren. Wenn Sie die Projektvariablen später jedoch in JavaScript verwenden möchten, empfehlen wir die Verwendung von Unterstrichen anstelle von Punkten. Weitere Informationen finden Sie weiter unten unter Abrufen von Projektvariablen in Scripts oder Transformations.

  Eine vorhandene globale Variable kann in eine Projektvariable umgewandelt werden, indem der Name in das Feld Name eingegeben wird. Siehe Konvertieren einer globalen Variable in eine Projektvariable für Details.

• Standardwert: Geben Sie einen optionalen Standardwert als Anfangswert für die Projektvariable ein. Dieser Wert kann später per Skript geändert werden. Wenn die Projektvariable keinen Standardwert haben soll, lassen Sie dieses Feld leer.

• Maskenwert: Aktivieren Sie die Option Maskenwert mit dem Schieberegler. Durch Aktivieren dieser Option wird der Standardwert ausgeblendet, indem er an verschiedenen Stellen in der Benutzeroberfläche durch schwarze Punkte ersetzt wird. Diese Option empfiehlt sich, wenn der Wert vertrauliche Informationen enthält, die nicht auf dem Bildschirm angezeigt werden sollen.

  Vorsicht

  Das Maskieren des Werts verhindert nicht, dass auf den Wert in einem Script zugegriffen werden kann.

• Beschriftung: Geben Sie eine optionale Bezeichnung zur Beschreibung der Variable ein. Diese Bezeichnung wird angezeigt, wenn Sie in Scripts und Konfigurationsbildschirmen mit der Maus über die Variable fahren.

• Beschreibung: Geben Sie eine optionale Beschreibung ein, um weitere Details zur Variable anzugeben. Diese Beschreibung wird angezeigt, wenn Sie in Scripts und Konfigurationsbildschirmen mit der Maus über die Variable fahren.

Konfigurieren Sie eine Projektvariable individuell

Die Konfiguration einer Projektvariablen in einem Dialog ist eine von zwei Ansichten zur Konfiguration von Projektvariablen. (Die andere Ansicht ist die Projektvariablen-Schubladenansicht.)#configure-a-project-variable-in-drawer-view).)

Diese Ansicht wird verwendet, wenn Sie eine Projektvariable direkt im Projektbereich, in einem Script oder einer Transformation oder in einem Endpoint erstellen oder bearbeiten.

Wenn Sie eine neue Projektvariable erstellen oder eine vorhandene Projektvariable einzeln bearbeiten, wird das Dialogfeld Projektvariable anzeigen/bearbeiten angezeigt:

• Projektvariablenname: Geben Sie den Namen der zu deklarierenden Projektvariable ein. Der Name der Projektvariable muss innerhalb des Projekts eindeutig sein, darf keine Leerzeichen enthalten und kann aus folgenden Zeichen bestehen: Buchstaben (a–z, A–Z), Zahlen (0–9), Punkten und Unterstrichen. Andere Zeichen werden nicht empfohlen und können Probleme verursachen. Bei Projektvariablennamen wird die Groß- und Kleinschreibung nicht berücksichtigt. Beispielsweise lautet eine Variable namens ProjectVar wird genauso behandelt wie projectvar Da alle globalen Datenelemente (globale Variablen, Projektvariablen und Jitterbit-Variablen) denselben Namespace verwenden, müssen ihre Namen im Vergleich zu allen anderen globalen Datenelementen eindeutig sein.

  Beim Erstellen neuer Projektvariablen empfiehlt es sich, Projektvariablen mit einem Präfix zu versehen, damit sie später leicht nachgeschlagen werden können. Beispielsweise kann eine Projektvariable org.netsuite.auth.username wird zuerst vorangestellt mit org, Dann netsuite usw., um sie effektiv in einer Liste mit anderen Projektvariablen zu organisieren. Wenn Sie die Projektvariablen später jedoch in JavaScript verwenden möchten, empfehlen wir die Verwendung von Unterstrichen anstelle von Punkten. Weitere Informationen finden Sie weiter unten unter Abrufen von Projektvariablen in Scripts oder Transformations.

  Eine vorhandene globale Variable kann in eine Projektvariable umgewandelt werden, indem der Name in das Feld Name eingegeben wird. Siehe Konvertieren einer globalen Variable in eine Projektvariable für Details.

• Standardwert: Geben Sie einen optionalen Standardwert als Anfangswert für die Projektvariable ein. Dieser Wert kann später per Skript geändert werden. Wenn die Projektvariable keinen Standardwert haben soll, lassen Sie dieses Feld leer.

• Wert in der Benutzeroberfläche ausblenden: Aktivieren Sie die Option Wert maskieren mit dem Schieberegler. Durch Aktivieren dieser Option wird der Standardwert ausgeblendet, indem er an verschiedenen Stellen in der Benutzeroberfläche durch schwarze Punkte ersetzt wird. Diese Option empfiehlt sich, wenn der Wert vertrauliche Informationen enthält, die nicht auf dem Bildschirm angezeigt werden sollen. Nach dem Aktivieren dieser Option werden Sie aufgefordert, das Ausblenden des Werts zu bestätigen:

  

  Vorsicht

  Das Maskieren des Werts verhindert nicht, dass auf den Wert in einem Script zugegriffen werden kann.

  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):

  

  Nach dem Klicken auf Weiter wird der Cursor in einem leeren Feld Standardwert positioniert.

• Beschriftung: Geben Sie eine optionale Bezeichnung zur Beschreibung der Variable ein. Diese Bezeichnung wird angezeigt, wenn Sie in Scripts und Konfigurationsbildschirmen mit der Maus über die Variable fahren.

• Beschreibung: Geben Sie eine optionale Beschreibung ein, um weitere Details zur Variable anzugeben. Diese Beschreibung wird angezeigt, wenn Sie in Scripts und Konfigurationsbildschirmen mit der Maus über die Variable fahren.

• Speichern: Klicken Sie hier, um die Projektvariablenkonfiguration zu speichern und zu schließen.

• Löschen: Klicken Sie nach dem Öffnen einer vorhandenen Projektvariable auf, um die Projektvariable dauerhaft zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschen und Entfernen).

Abrufen von Projektvariablen in Scripts oder Transformations

In Integration Studio kann der Wert einer Projektvariablen entweder mit Jitterbit Script 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 Projektvariable.

• $: Mit einem Dollarzeichen als Präfix $, das Codebeispiel $org.netsuite.auth.username ruft den Wert der Projektvariablen mit dem Namen "org.netsuite.auth.username".- Get: Mit dem Get Funktion, das Codebeispiel Get("org.netsuite.auth.username") gibt den gleichen Wert zurück.

In Scripts und Transformations werden vorhandene Projektvariablen im Tab Variablen der Skriptkomponentenpalette im Untertab Projektvariablen angezeigt. Siehe Projektvariable zu einem Script hinzufügen unten.

JavaScript

In JavaScript, das innerhalb von Scripts verwendet wird innerhalb einer Operation 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 durch Voranstellen eines Dollarzeichens abgerufen werden. $.

  • $: Mit einem Dollarzeichen als Präfix $, das Codebeispiel $org_netsuite_auth_username ruft den Wert der Projektvariablen mit dem Namen "org_netsuite_auth_username".

• 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 Projektvariablen vorgesehen sind, siehe den Abschnitt über Jitterbit-Variablen für weitere Informationen.

In Scripts und Transformations werden vorhandene Projektvariablen im Tab Variablen der Skriptkomponentenpalette im Untertab Projektvariablen angezeigt. Siehe Projektvariable zu einem Script hinzufügen unten.

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 Projektvariablen 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 Projektvariablen vorgenommenen Änderungen verloren. Nur wenn das JavaScript erfolgreich abgeschlossen wird, sind geänderte Projektvariablenwerte außerhalb des Script verfügbar.

Einem Script eine Projektvariable hinzufügen

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

Während der Konfiguration bestimmter Projektkomponenten, einschließlich der Endpoint mithilfe von Konnektoren, können Sie Projektvariablen in allen Feldern verwenden, die über eine Variablensymbol. Variablen können in Feldern zusammen mit anderen Eingaben verwendet werden, auch mit anderen Variablen oder Schlüsselwörtern.

Auswählen einer Projektvariablen

Um auf Projektvariablen 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 der Variablen- oder Schlüsselworttyp durch das Symbol neben dem Namen gekennzeichnet:

• für Dateinamenschlüsselwort
• für globale Variable
• für Projektvariable
• für Jitterbit-Variable

Der Hintergrund des Symbols ist einfarbig, wenn für die Projektvariable ein Standardwert in der Projektvariablenkonfiguration selbst angegeben ist, andernfalls ist er leer.

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:

Steuerelemente anzeigen

Sobald eine Projektvariable ausgewählt ist, können Sie zwischen den Formaten wechseln oder die Projektvariable entfernen:

• Reduzieren: Um das Standardformat der Variablen in Textformat zu ändern, klicken Sie auf das Symbol zum Minimieren:

  

  Um vom Textformat zurück zum Pillenformat zu wechseln, verschieben Sie den Fokus vom Feld, z. B. durch Klicken in ein anderes konfigurierbares Feld. Die Feldeingabe kehrt automatisch zum Standard-Pillenformat zurück.

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

Anleitungen zu Projektvariablen

Dieser Abschnitt enthält Informationen zur Durchführung spezifischer Aufgaben mit Projektvariablen.

Konvertieren einer globalen Variable in eine Projektvariable

Um eine bestehende globale Variable zu konvertieren zu einer Projektvariablen hinzufügen, geben Sie den Namen der vorhandenen globalen Variable in das Feld Projektvariablenname ein. Beim Speichern (durch Verschieben des Fokus außerhalb der Zeile, wenn Sie sich in der [Schubladenansicht] befinden)#project-drawers-project-variables-tab) oder durch Klicken auf Speichern, wenn Sie sich in der Einzelansicht befinden) werden Sie aufgefordert, die Konvertierung der globalen Variable in eine Projektvariable zu bestätigen:

Durch Klicken auf Weiter 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. Durch Klicken auf Abbrechen wird die Konvertierung der globalen Variable abgebrochen.

Migrieren von Projektvariablen

Wenn Sie ein Projekt migrieren, können Sie auswählen, bei welchen Projektvariablen die Werte in der Umfeld ausgeschlossen werden.

Auf diese Weise können Sie Projektvariablenwerte von einer Umfeld getrennt halten. Beispielsweise möchten Sie möglicherweise separate Projektvariablenwerte für eine Endpoint Host URL für eine Umfeld und eine separate Sandbox Endpoint Host URL für eine Umfeld verwalten.

Möglicherweise möchten Sie bestimmte Projektvariablenwerte von der Migration ausschließen, um zu vermeiden, dass ihre Werte bei der ersten Migration ausgefüllt werden oder um zu vermeiden, dass ihre Werte bei nachfolgenden Migrationen überschrieben werden.

Um Projektvariablen von der Migration auszuschließen, wählen Sie im Projektmigrationsbildschirm die Option Zu migrierende Variablenwerte auswählen. Wenn diese Option aktiviert ist, werden standardmäßig keine Projektvariablenwerte für die Migration ausgewählt. Wenn Sie Projektvariablenwerte bei der Migration einbeziehen möchten, können Sie diese einzeln auswählen. Weitere Informationen finden Sie unter Projekt migrieren in Projektmigration.