Variableverbindung

Einführung

Eine Variableverbindung, die mit dem Variablenconnector erstellt wurde, ermöglicht den Zugriff auf entweder eine Projektvariable oder eine im Speicher befindliche globale Variable. Sobald eine Verbindung hergestellt ist, können Instanzen von Variablenaktivitäten erstellt werden, die mit dieser Verbindung verknüpft sind, um entweder als Quellen (um Daten in einem Vorgang bereitzustellen) oder als Ziele (um Daten in einem Vorgang zu konsumieren) verwendet zu werden.

Für weitere Informationen zur Verwendung von Variablen in Skripten, Transformationen und Konfigurationsbildschirmen für Verbindungen/Aktivitäten siehe Variablen.

Erstellen oder Bearbeiten einer Variableverbindung

Eine neue Variableverbindung wird mit dem Variablenconnector aus einem dieser Standorte erstellt:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Seite Globale Endpunkte (siehe Erstellen eines globalen Endpunkts in Globalen Endpunkten).

Eine vorhandene Variableverbindung kann von diesen Standorten bearbeitet werden:

• Der Registerkarte Projektendpunkte und -connectoren in der Designkomponentenpalette (siehe Designkomponentenpalette).
• Der Registerkarte Komponenten im Projektbereich (siehe Aktionsmenü für Komponenten in Projektbereich Komponentenregister).
• Der Seite Globale Endpunkte (siehe Bearbeiten eines globalen Endpunkts in Globalen Endpunkten).

Konfigurieren einer Variableverbindung

Jedes Benutzeroberflächenelement des Bildschirms zur Konfiguration der Variablenverbindung wird im Folgenden beschrieben.

• Verbindungsname: Geben Sie einen Namen ein, um die Variablenverbindung zu identifizieren. Der Name muss für jede Variablenverbindung eindeutig sein und darf keine Schrägstriche (/) oder Doppelpunkte (:) enthalten. Dieser Name wird auch verwendet, um den Variablenendpunkt zu identifizieren, der sich sowohl auf eine bestimmte Verbindung als auch auf deren Aktivitäten bezieht.

• Variablenname: Geben Sie den Namen ein, den Sie für eine neue im Speicher befindliche globale Variable verwenden möchten, oder geben Sie den Namen einer vorhandenen globalen Variable oder Projektvariablen ein. Um eine Liste der vorhandenen globalen und Projektvariablen anzuzeigen, beginnen Sie entweder damit, ein offenes Quadratklammernzeichen [ in das Feld einzugeben, oder klicken Sie auf das Symbol für Variablen, um ein Menü mit vorhandenen Variablen anzuzeigen, aus dem Sie auswählen können.

  Variablenname können 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. Es ist eine gute Idee, Punkte oder Unterstriche zu verwenden, um Variablen voranzustellen, damit sie später leicht nachgeschlagen werden können. Zum Beispiel wird eine Variable mit dem Namen org.account.filename zuerst mit org, dann account usw. vorangestellt, um sie effektiv in einer Liste unter anderen Variablen zu organisieren. Beachten Sie jedoch, dass für Variablen, die später möglicherweise in JavaScript verwendet werden, empfohlen wird, Unterstriche anstelle von Punkten zu verwenden. Weitere Informationen finden Sie unter Globale Variablen und Projektvariablen.

• Änderungen speichern: Klicken Sie, um die Konfiguration der Verbindung zu speichern und zu schließen. Wenn Sie eine vorhandene Variablenverbindung bearbeiten, um einen anderen Namen im Variablenname zu verwenden, wird ein Bestätigungsdialog angezeigt, der Sie fragt, ob der Variablenname in allen Instanzen, in denen er im Projekt verwendet wird, aktualisiert werden soll:

  Dialogtext

  Aktualisierung bestätigen
  Möchten Sie alle Verwendungen dieser Variablen im Projekt aktualisieren:

  • Ja
  • Nein
  • Abbrechen

  • Ja: Klicken Sie, um den Namen der Variablen zu ändern, auf die der Endpunkt zugreift, und auch alle anderen Verwendungen dieser Variablen im Projekt zu ändern.

  • Nein: Klicken Sie, um den Namen der Variablen zu ändern, auf die der Endpunkt zugreift, und lassen Sie alle anderen Verwendungen dieser Variablen im Projekt unverändert.

  • Abbrechen: Klicken Sie, um keine Änderungen vorzunehmen und zur Konfiguration der Variablenverbindung zurückzukehren.

• Änderungen verwerfen: Nachdem Sie Änderungen an einer neuen oder bestehenden Konfiguration vorgenommen haben, klicken Sie, um die Konfiguration zu schließen, ohne zu speichern. Ein Dialog fragt Sie, ob Sie die Änderungen verwerfen möchten.

• Löschen: Nachdem Sie eine bestehende Verbindungs-Konfiguration geöffnet haben, klicken Sie, um die Verbindung dauerhaft aus dem Projekt zu löschen und die Konfiguration zu schließen (siehe Komponentenabhängigkeiten, Löschung und Entfernung). Ein Dialog fragt Sie, ob Sie die Verbindung löschen möchten.

Nächste Schritte

Menüaktionen für eine Verbindung und deren Aktivitätstypen sind im Projektbereich und in der Design-Komponentenpalette zugänglich. Für Details siehe Aktionsmenüs in Connector-Grundlagen.

Nachdem Sie eine Variablenverbindung konfiguriert haben, können Sie eine oder mehrere Variablenaktivitäten konfigurieren, die mit dieser Verbindung verbunden sind, um sie entweder als Quelle zur Bereitstellung von Daten für einen Vorgang oder als Ziel zur Verwendung von Daten in einem Vorgang zu nutzen.

Aktivitäten konfigurieren

Diese Aktivitätstypen sind verfügbar:

• Lesen: Liest Daten von einem Variablenendpunkt und ist als Quelle in einem Vorgang vorgesehen.

• Schreiben: Schreibt Daten in einen Variablenendpunkt und ist als Ziel in einem Vorgang vorgesehen.