Projektvariablen im Jitterbit Integration Studio

Einführung

Projektvariablen sind einer der Typen globaler Datenelemente, die in Harmony verfügbar sind. Die anderen Typen globaler Datenelemente - globale Variablen, Jitterbit-Variablen und Dateinamen-Schlüsselwörter - sind auch 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 jedoch 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 können in allen Komponenten eines Projekts verwendet werden, einschließlich Scripts, Transformations und mit Konnektoren erstellte Endpoints. Wenn Sie den Wert einer Projektvariablen während der Laufzeit eines 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, oder alle Variablen, die Sie über die Management Console bearbeiten möchten oder Citizen Integrator.

Wenn Sie eine Projektvariable bereitstellen, die bereits in der Harmony-Cloud bereitgestellt wurde, werden Ihnen Optionen zur Auswahl der zu verwendenden Projektvariablenwerte angezeigt. Dies wird unter Zeitpläne und Projektvariablen auswählen beschrieben in Projektbereitstellung.

Erstellen und Aktualisieren von Projektvariablen

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

In den nächsten Abschnitten wird beschrieben, wie Sie eine neue Projektvariable aus verschiedenen Speicherorten in erstellen. Integration Studio:

• Projektvariablen-Schublade
• Projektbereich
• Script
• Transformation
• Endpoint
• Vorhandene Projektvariablenkonfigurationen

Neue Projektvariablen werden mit dem Standardnamen erstellt New_Project_Variable. Nachfolgende neue Projektvariablen mit dem Standardnamen werden mit einer erhöhten Nummer versehen.

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

Schublade für Projektvariablen

Die Schublade für Projektvariablen 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.

Die Schublade für Projektvariablen ist sowohl von außerhalb als auch innerhalb eines Projekts zugänglich. Es ist nicht erforderlich, ein Projekt zu öffnen, um auf die Schublade für Projektvariablen zuzugreifen. Auf die Option Projektvariablen kann von diesen Orten aus zugegriffen werden:

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

Wenn Sie Projektvariablen auswählen, wird die Projektvariablen-Schublade am unteren Bildschirmrand geöffnet:

• 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 gekennzeichnet. Um die Registerkarten neu anzuordnen, ziehen Sie eine Tab per Drag & Drop. Um eine Tab zu schließen, klicken Sie auf deren Schließen-Symbol. Durch Schließen der letzten Tab oder über das Symbol ganz rechts 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 Größe des Symbols nach oben oder unten ändern.
• 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 inline.

Weitere Informationen zum Suchen, Löschen und Konfigurieren von Projektvariablen aus dieser Ansicht finden Sie unter Projektvariablen in der Schubladenansicht konfigurieren 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 Eine Projektvariable individuell konfigurieren beschrieben 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 vorhandene Projektvariable zu bearbeiten, bewegen Sie den Mauszeiger ü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 Konfigurationsbildschirm für individuelle Projektvariablen, wie unter Eine Projektvariable individuell konfigurieren beschrieben 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 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, bewegen Sie den Mauszeiger über den Variablennamen und klicken Sie auf das Symbol „Bearbeiten“:

Sowohl das Erstellen einer neuen Projektvariable als auch das Bearbeiten einer vorhandenen Projektvariable öffnen den individuellen Konfigurationsbildschirm für Projektvariablen, wie unter Eine Projektvariable individuell konfigurieren beschrieben weiter unten auf dieser Seite.

Endpoint

Bei Verwendung eines Connectors, um einen Endpoint zu konfigurieren, in Feldern, die eine Variablensymbol. Klicken Sie auf das Symbol, um eine Liste vorhandener 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 das Variablenfeld, um Informationen zur Variable anzuzeigen, und klicken Sie dann unten links auf das Bearbeitungssymbol oder Bearbeiten:

  

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

Vorhandene Projektvariablenkonfigurationen

In einem individuellen Projektvariablen-Konfigurationsbildschirm, können Sie die aktuelle Projektvariable speichern und dann einen neuen Konfigurationsbildschirm aufrufen, um eine neue Projektvariable zu erstellen. Diese Funktion ist nützlich, wenn Sie Projektvariablen in großen Mengen erstellen.

Konfigurieren Sie die Variable in einem neuen Konfigurationsbildschirm für Projektvariablen wie unter Eine Projektvariable einzeln konfigurieren beschrieben weiter unten auf dieser Seite und klicken Sie dann auf Speichern & Neu:

Dadurch wird die aktuelle Projektvariable gespeichert und ein weiterer individueller Projektvariablen-Konfigurationsbildschirm zum Erstellen einer neuen Projektvariable geöffnet.

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

Jede dieser Menüaktionen ist verfügbar:

Menüelement	Beschreibung
	Anzeigen/Bearbeiten öffnet den individuellen Konfigurationsbildschirm für Projektvariablen, damit Sie die Projektvariable konfigurieren können. Weitere Informationen finden Sie unter Eine 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).
	Duplicate erstellt eine neue, nicht referenzierte Projektvariable mit der gleichen 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 Projektvariable

Sobald eine Projektvariable erstellt wurde, wird sie auf eine der beiden Arten konfiguriert:

• 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 öffnet sich beim Bearbeiten oder Erstellen einer Projektvariable direkt aus dem Projektbereich, innerhalb eines Script oder einer Transformation oder innerhalb eines Endpoint (wie unter Projektvariablen erstellen und aktualisieren beschrieben) weiter oben auf dieser Seite).

Konfigurieren einer Projektvariablen in der Schubladenansicht

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

Die Schublade für Projektvariablen ist sowohl von außerhalb als auch innerhalb eines Projekts zugänglich. Es ist nicht notwendig, ein Projekt zu öffnen, um auf die Schublade zuzugreifen. Die Option Projektvariablen kann von diesen Orten aus aufgerufen werden:

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

Beim Zugriff auf die Schublade „Projektvariablen“ sind diese Aktionen verfügbar:

• 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ö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 Variablenfeld Beschreibung der letzten Zeile setzen und dann die Taste drücken Tab Schlüssel. Bei beiden Methoden zum Erstellen einer neuen Projektvariable wird der Cursor in das Feld Name gesetzt, 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 herausklicken, wird die Projektvariable 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, sogar innerhalb derselben Projektvariablenzeile.

• Suchen: 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 Projektvariablentabelle

Jede Spalte der Projektvariablentabelle wird unten beschrieben:

• Auswählen: In der Spalte ganz links können Sie eine, mehrere oder alle Projektvariablen zum Löschen auswählen. Nachdem mindestens eine Projektvariable ausgewählt wurde, steht Ihnen 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ö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 den folgenden Zeichen bestehen: Buchstaben (a-z, A-Z), Zahlen (0-9), Punkte und Unterstriche. Andere Zeichen werden nicht empfohlen und können Probleme verursachen. Bei Projektvariablennamen wird nicht zwischen Groß- und Kleinschreibung unterschieden. Eine Variable mit dem Namen ProjectVar wird gleich 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 ein Präfix zuzuweisen, 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 es effektiv in einer Liste unter anderen Projektvariablen zu organisieren. Wenn Sie jedoch planen, die Projektvariablen später in JavaScript zu verwenden, 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 ihr Name in das Feld Name eingegeben wird. Siehe Konvertieren einer globalen Variable in eine Projektvariable für weitere Einzelheiten.

• 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.

  • Versteckten Wert anzeigen: Wenn Wert ausblenden aktiviert ist, können Sie auf das Symbol anzeigen, um den ausgeblendeten Wert anzuzeigen. Der Wert wird wieder ausgeblendet, wenn das Symbol losgelassen wird.

• Wert ausblenden: Verwenden Sie den Schieberegler, um die Option Wert ausblenden einzuschalten. Wenn Sie diese Option aktivieren, wird der Standardwert ausgeblendet, indem er an verschiedenen Stellen in der Benutzeroberfläche durch Sternchen ersetzt wird. Sie können diese Option verwenden, wenn der Wert vertrauliche Informationen enthält, die nicht auf dem Bildschirm angezeigt werden sollen.

  Vorsicht

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

• Bezeichnung: 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.

Projektvariable individuell konfigurieren

Das Konfigurieren einer Projektvariablen in einem Dialog ist eine von zwei Ansichten, die zum Konfigurieren von Projektvariablen verwendet werden. (Die andere Ansicht ist die Projektvariablen-Schubladenansicht.)

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

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

• Projektvariablenname: Geben Sie den Namen der Projektvariablen ein, die Sie deklarieren möchten. Der Projektvariablenname muss innerhalb des Projekts eindeutig sein, darf keine Leerzeichen enthalten und kann aus den folgenden Zeichen bestehen: Buchstaben (a-z, A-Z), Zahlen (0-9), Punkte und Unterstriche. Andere Zeichen werden nicht empfohlen und können Probleme verursachen. Projektvariablennamen berücksichtigen nicht die Groß-/Kleinschreibung. Eine Variable mit dem Namen ProjectVar wird gleich 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 ein Präfix zuzuweisen, 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 es effektiv in einer Liste unter anderen Projektvariablen zu organisieren. Wenn Sie jedoch planen, die Projektvariablen später in JavaScript zu verwenden, 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 ihr Name in das Feld Name eingegeben wird. Siehe Konvertieren einer globalen Variable in eine Projektvariable für weitere Einzelheiten.

• 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 Benutzeroberfläche ausblenden: Aktivieren Sie die Option Wert ausblenden mit dem Schieberegler. Durch Aktivieren dieser Option wird der Standardwert ausgeblendet, indem er an verschiedenen Stellen in der Benutzeroberfläche durch Sternchen ersetzt wird. Sie können diese Option verwenden, wenn der Wert vertrauliche Informationen enthält, die nicht auf dem Bildschirm angezeigt werden sollen. Nachdem Sie diese Option aktiviert haben, werden Sie aufgefordert, zu bestätigen, dass Sie den Wert ausblenden möchten:

  

  Vorsicht

  Das Ausblenden 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.

• Bezeichnung: 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.

• Speichern & Neu: Diese Schaltfläche ist nur beim Erstellen einer neuen Projektvariable vorhanden. Sie kann jedoch beim Erstellen von Projektvariablen in großen Mengen nützlich sein. Klicken Sie auf diese Schaltfläche, um die aktuelle Projektvariable zu speichern und einen weiteren Projektvariablenkonfigurationsbildschirm zum Erstellen einer neuen Projektvariable zu öffnen.

• 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, der Wert einer Projektvariable kann entweder mit Jitterbit Script zurückgegeben werden in Scripts oder Transformations oder mithilfe von JavaScript nur in Scripts, die als Projektkomponente erstellt wurden.

Jitterbit Script

In Scripts und Transformations, können Sie mit einem Dollarzeichen beginnen $ oder verwenden Sie die Get Funktion zum Abrufen des Wertes einer Projektvariable.

• $: Mit einem Dollarzeichen als Präfix $, das Codebeispiel $org.netsuite.auth.username ruft den Wert der Projektvariable 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, vorhandene Projektvariablen werden auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Projektvariablen angezeigt. Siehe Eine 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 Projektvariable mit dem Namen "org_netsuite_auth_username".

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

In Scripts und Transformations, vorhandene Projektvariablen werden auf der Tab Variablen der Skriptkomponentenpalette innerhalb der Unterregisterkarte Projektvariablen angezeigt. Siehe Eine Projektvariable zu einem Script hinzufügen unten.

Hinzufügen einer Projektvariablen zu einem Script

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 der folgenden 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.

Projektvariablen in Konfigurationsbildschirmen verwenden

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 Projektvariable

Um auf Projektvariablen zuzugreifen, können 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).

Innerhalb der Liste wird der Variablen- oder Schlüsselworttyp durch das Symbol neben seinem Namen angezeigt:

• 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, irgendwo in der Zeichenfolge, hinzugefügt werden soll. Die Variable wird in einem Pillenformat ähnlich dem unten gezeigten angezeigt:

Um Informationen zur Variable zu überprüfen, bewegen Sie den Mauszeiger über das Variablenfeld:

Steuerelemente anzeigen

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

• Collapse: Um das standardmäßige variable Pillenformat in das Textformat zu ändern, klicken Sie auf das Symbol zum Minimieren:

  

  Um von einem Textformat zurück zum Pillenformat zu wechseln, ändern Sie den Fokus vom Feld weg, z. B. indem Sie in ein anderes konfigurierbares Feld klicken. Die Feldeingabe kehrt automatisch zum standardmäßigen Pillenformat zurück.

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

Anleitungen für Projektvariablen

Dieser Abschnitt enthält Informationen zum Erledigen bestimmter Aufgaben mit Projektvariablen.

Konvertieren einer globalen Variable in eine Projektvariable

Um eine vorhandene globale Variable zu konvertieren zu einer Projektvariable hinzufügen, geben Sie den Namen der vorhandenen globalen Variable in ein Feld Projektvariablenname ein. Beim Speichern (durch Verschieben des Fokus außerhalb der Zeile, wenn Sie sich in der Listenansicht 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 umwandeln möchten:

Beim Klicken auf Weiter werden sämtliche 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 die Projektvariable referenzieren. Beachten Sie, dass ein während der Ausführung der Operation in einem Script gesetzter Wert für eine Projektvariable den in der Projektvariablenkonfiguration angegebenen Standardwert überschreibt. Beim Klicken auf Abbrechen wird die Konvertierung der globalen Variable abgebrochen.

Migrieren von Projektvariablen

Wenn Sie ein Projekt migrieren können Sie auswählen, welche Projektvariablen ihre Werte in der Umfeld ausgeschlossen haben.

Auf diese Weise können Sie Projektvariablenwerte getrennt von einer Umfeld 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 QA- Umfeld verwalten.

Möglicherweise möchten Sie bestimmte Projektvariablenwerte von der Migration ausschließen, um zu verhindern, dass deren Werte bei der ersten Migration eingetragen werden oder 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 ausgewählt ist, werden standardmäßig keine Projektvariablenwerte für die Migration ausgewählt. Wenn Sie während der Migration Projektvariablenwerte einschließen möchten, können Sie diese einzeln auswählen. Weitere Informationen finden Sie unter Ein Projekt migrieren in Projektmigration.