Variablen

Eine Variable ist ein Integrationselement, das Daten zwischen den Aufgaben, Triggern, und Edges einer Integration enthält und überträgt.

• Variablen können statisch bei der Entwicklung definiert oder zur Laufzeit dynamisch an die Integration übergeben werden.
• Variablen können auf andere Variablen in einer Integration verweisen.
• Variablen können global für alle Aufgaben oder lokal für eine bestimmte Aufgabe zugänglich sein.

Variablen

In Application Integration werden Variablen an verschiedenen Stellen festgelegt oder initialisiert:

• Konfigurationsvariablen: Bei der Entwicklung festgelegt, um die Konfigurationsdaten der Integration zu speichern. Sie können damit beispielsweise eine Ziel-E-Mail-Adresse für Benachrichtigungen festlegen, anstatt diese E-Mail-Adresse fest in die Integration zu codieren.
• Systemvariablen: Automatisch vom System generiert, um die Konfigurationsdaten der Integration zu speichern. In der Variablen ExecutionId wird beispielsweise die Ausführungs-ID der Integration gespeichert.
• Integrationsvariablen: Explizit in Ihrer Integration festgelegt, um Daten während der gesamten Integrationsausführung zu verfolgen. Sie können beispielsweise eine Variable festlegen, um das Ergebnis einer Aufgabe zu speichern und in einer nachfolgenden Aufgabe zu verwenden.
• Aufgabenvariablen: Implizit durch Ausführen bestimmter Aufgaben festgelegt, um die Ausgabe der Aufgabe zu speichern. Bei der Aufgabe REST-Endpunkt aufrufen wird beispielsweise die Variable responseBody festgelegt, um den Antworttext des REST-Endpunkts zu speichern. Aufgabenvariablen werden auch als automatisch generierte Variablen bezeichnet. Automatisch generierte Variablen haben eine spezielle Benennungskonvention, bei der der Variablenname in Backticks gesetzt wird.

Integrationsvariablen

Integrationsvariablen, einschließlich Eingabe- und Ausgabevariablen, ähneln Variablen, die in einer Programmiersprache verwendet werden. Daten in den Variablen können während der Ausführung der Integration gelesen und geschrieben werden.

Integrationsvariablen können auf folgende Arten verwendet werden:

• Als Eingabe in die Integration, auch Eingabevariablen genannt.
• Als Ausgabe der Integration, auch Ausgabevariablen genannt.
• Zur Beibehaltung des temporären Status während der Ausführung einer Integration.

Hinweis: Die oben aufgeführten Variablenrollen schließen sich nicht gegenseitig aus. Jede gegebene Variable kann eine Eingabevariable, eine Ausgabevariable oder beides sein.

Wenn Sie eine Variable als Eingabevariable kennzeichnen, geben Sie an, dass der Wert der Variablen bereitgestellt werden muss, wenn die Integration ausgelöst wird. Der Wert einer Eingabevariablen kann geändert werden während der Ausführung der Integration.

Wenn Sie eine Variable als Ausgabevariable kennzeichnen, geben Sie an, dass der endgültige Wert der Variablen als Teil der Antwort der Integration zurückgegeben werden soll.

Der Wert einer Variablen muss in der Integration nicht statisch definiert werden. Variablenwerte können über die Verwendung eines Triggers an eine Integration übergeben werden. Wenn eine Variable jedoch in der Integration statisch definiert ist und dieselbe Variable dynamisch per Trigger bereitgestellt wird, überschreibt die dynamische Wertzuweisung die statische Zuweisung.

Unterstützte Datentypen

Die folgenden Datentypen werden für Integrationsvariablen unterstützt:

• String und String-Array
• Ganzzahl und Ganzzahl-Array
• Double und Double-Array
• Boolesch und boolesches Array
• JSON

Aufgabenvariablen

Aufgabenvariablen sind vordefinierte, automatisch generierte Variablen einer Aufgabe. Wenn eine Aufgabe eine Ausgabe hat, sind alle diese Ausgaben in einer Aufgabenvariablen verfügbar. Sie können eine Aufgabenvariable nicht löschen oder bearbeiten. Aufgabenvariablen werden auch als automatisch generierte Variablen bezeichnet.

Der eindeutige Name einer Aufgabenvariablen folgt einer speziellen Benennungskonvention: Der Variablenname wird in Backticks gesetzt und die Aufgaben-ID ist enthalten. Das Format ist `<Task ID>_<Variable Name>`.

Die Aufgabe REST-Endpunkt aufrufen hat beispielsweise eine Ausgabe für den Antworttext. Wenn diese Aufgabe die ID Task_5 hat, lautet der eindeutige Name der Aufgabenvariablen für den Antworttext `Task_5_responseBody`.

Im Bereich Variablen werden Aufgabenvariablen möglicherweise mit einem gemeinsamen Ausgabenamen aufgeführt, z. B. responseBody, ohne die Aufgaben-ID oder Backticks. Wenn Sie den vollständigen, eindeutigen Variablennamen sehen möchten, der für die Referenz erforderlich ist, klicken Sie im Bereich auf die Variable und sehen Sie sich die Details im rechten Bereich an.

Konfigurationsvariablen

Vorschau – BigQuery Connector

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Mit Konfigurationsvariablen können Sie die Konfiguration für die Integration externalisieren. Mit Konfigurationsvariablen können Sie Aspekte Ihrer Integration konfigurieren, z. B. Verbindungsnamen, Endpunkt-URLs oder andere umgebungsspezifische Werte, die auf der Entwicklungsumgebung basieren, z. B. QA, Staging oder Produktion. Sie müssen Ihre Integration nicht manuell aktualisieren, bevor Sie sie in eine neue Umgebung hochladen. Mit Application Integration können Sie Werte für die Konfigurationsvariablen eingeben, wenn Sie die Integration veröffentlichen.

Achtung:Konfigurationsvariablen sind kein Secret-Speicher. Ihre Werte werden als Nur-Text gespeichert und exportiert, auch wenn Sie eine Integration herunterladen oder als Vorlage freigeben. Wenn Sie eine Variable maskieren, wird sie beim Export nicht entfernt. Speichern Sie keine Passwörter, API-Schlüssel, Tokens oder andere Anmeldedaten in Konfigurationsvariablen. Verwenden Sie stattdessen ein Authentifizierungsprofil oder die Aufgabe „Secret Manager – Zugriff“.

Wenn Sie die in Ihrer Integration definierten Konfigurationsvariablen aufrufen und bearbeiten möchten, klicken Sie im Bereich Variablen auf variable_add Konfigurationsvariable für die Integration. Informationen zum Erstellen und Verwenden von Konfigurationsvariablen finden Sie in der Anleitung CICD für Ihre Integration erstellen.

Systemvariablen

Systemvariablen werden automatisch generiert, wenn Sie eine Integration erstellen. Sie können diese Variablen in Ihren Integrationsaufgaben und zur Fehlerbehebung verwenden. Die Integration enthält die folgenden vom System generierten Variablen:

• ErrorInfo: Wenn die Ausführung fehlschlägt, können Sie mit der Variablen ErrorInfo auf die Fehlerdetails zugreifen:

  {
    "ErrorInfo": {
    "message": String,
    "code": Number
    }
  }
  

  Sie können auf die Fehlermeldungen zugreifen, indem Sie eine Integrationsvariable mit dem Namen ErrorMessage erstellen. Wir empfehlen jedoch, die vom System generierte Variable ErrorInfo.message zu verwenden, um auf Fehlermeldungen zuzugreifen.

• ExecutionMode: Der Ausführungsmodus basierend auf dem Trigger. Gültige Werte sind SYNC und ASYNC.
• ExecutionId: Die Ausführungs-ID der Integration.
• IntegrationName: Der Name der Integration.
• Region: Die Region der Integration.
• ProjectId: Die Projekt-ID, die die Integration enthält.

Variablen anzeigen

Im Bereich Variablen können Sie Variablen in Ihrer Integration erstellen, bearbeiten, ansehen, duplizieren und löschen. Außerdem wird die Anzahl der Variablenreferenzen insgesamt innerhalb der Integration angezeigt.

Klicken Sie in der Navigationsleiste des Designers auf , um den Bereich Variablen aufzurufen.

Die folgende Abbildung zeigt ein Beispiellayout für den Bereich Variablen:

Konfigurationsvariablen ansehen und bearbeiten

Vorschau – BigQuery Connector

Diese Funktion unterliegt den „Bedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Dienstbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA‑Funktionen stehen in der vorliegenden Form zur Verfügung und bieten möglicherweise nur eingeschränkten Support. Weitere Informationen finden Sie unter den Beschreibungen der Startphase.

Wenn Sie die in Ihrer Integration definierten Konfigurationsvariablen aufrufen möchten, klicken Sie im Bereich Variablen auf variable_add Konfigurationsvariable für die Integration. Dadurch wird der Bereich Konfigurationsvariablen mit allen in Ihrer Integration definierten Konfigurationsvariablen aufgerufen. Sie können einfach auf das Feld Wert klicken, um den Wert der Konfigurationsvariablen zu bearbeiten.

Die folgende Abbildung zeigt ein Beispiellayout für den Bereich Konfigurationsvariablen:

Erstellen Sie eine Variable

Führen Sie die folgenden Schritte aus, um einen Cluster zu erstellen:

1. Klicken Sie in der Navigationsleiste des Integrationseditors auf , um den Bereich Variablen aufzurufen.
2. Klicken Sie auf +Erstellen.
3. Führen Sie im Bereich Variable erstellen folgende Schritte aus:
   1. Name:Geben Sie den Namen der Variablen ein.
   2. Variablentyp: Wählen Sie den Typ der Variablen aus.

   Datentyp	Beschreibung
   –	Eine lokale Variable in einer Integration.
   Konfigurationsvariable für die Integration	Eine Konfigurationsvariable in einer Integration.
   Eingabe in Integration	Während der Ausführung wird die Variable als Eingabe für den ausgeführten Trigger bereitgestellt.
   Ausgabe der Integration	Der endgültige Wert der Variable am Ende der Ausführung sollte an den Aufrufer der Integration ausgegeben werden.
   Eingabe und Ausgabe der Integration	Bei der Ausführung wird die Variable als Eingabe für den ausgeführten Trigger bereitgestellt und der endgültige Wert wird an den Aufrufer der Integration ausgegeben.

   3. Datentyp:Wählen Sie den Datentyp der Variablen aus. Sie können den Datentyp einer Variablen mit dem Symbol neben dem Variablennamen identifizieren.

      Datentyp	Beispiel
      String	Alex
      Ganzzahl	30
      Double	30.5
      Boolesch	true
      JSON	{ "employee":{"name":"Alex", "age":30, "city":"Mountain View"} }
      String-Array	Alex, Kai, Raha
      Ganzzahl-Array	30, 25, 22
      Double-Array	30.5, 25.34, 22.134
      Boolesches Array	true, false, false

      Informationen zu den unterstützten Datentypen finden Sie unter Unterstützte Datentypen.

   4. Standardwert: Geben Sie den Standardwert für die Variable ein. Dieses Feld ist optional.
   5. Schema: Wählen Sie das JSON-Schema für die Variable aus.
      • Aus einer JSON-Beispielnutzlast ableiten:Generiert ein JSON-Schema aus einer JSON-Beispielnutzlast. Die Beispielnutzlast wird nach dem Generieren des Schemas verworfen. Nur das generierte Schema wird gespeichert.
      • JSON-Schema eingeben: Geben Sie ein ganzes JSON-Schema manuell ein.
      • Aus dem Standardwert ableiten:Generiert ein JSON-Schema mit dem angegebenen Standardwert.
      • –:Kein JSON-Schema.
      Hinweis: Dieses Feld wird nur für JSON-Datentypvariablen angezeigt.
   6. Variable in Logs maskieren (Vorschau): Wählen Sie diese Option aus, um die Maskierung für die Variable in den Ausführungslogs der Integration zu aktivieren. Damit die Variable maskiert werden kann, müssen Sie die Maskierung von Variablen für Ihre Integration und Region aktivieren. Informationen zum Aktivieren der Maskierung für die Integration und die Region finden Sie unter Integration bearbeiten und Regionen bearbeiten.

      Die Maskierung gilt nur für Ausführungslogs. Werte werden nicht entfernt, wenn Sie die Integration herunterladen oder exportieren. Weitere Informationen finden Sie unter Vertrauliche Daten in Logs maskieren.

4. Klicken Sie auf Erstellen.

Funktionsweise von Variablen in Integrationen

Während der Ausführung einer Integration werden Ausführungsdaten als Variablen übergeben, die für die Integration oder Aufgabe deklariert werden. Sobald die Ausführung beginnt, werden Eingabedaten in ein speicherinternes Objekt namens ein Event umgewandelt.

Nachdem das Ereignisobjekt erstellt wurde, wird eine speicherinterne Grafik von Aufgaben mithilfe der Integrationsdefinition erstellt. Eingehende Variablenwerte werden basierend auf Ihrer Konfiguration an Aufgaben übergeben. Beim Ausführen der Integration lesen und schreiben die Aufgaben Daten in das Ereignisobjekt, um sie für nachfolgende Aufgaben zu verwenden oder die Ausgabedaten der Integration zu bilden.

In der folgenden Tabelle werden die verschiedenen Arten von Variablen und ihr Verhalten zusammengefasst:

Variablentyp	Beschreibung	Verhalten	Beispiel
Konfigurationsvariable	Speichert die Konfigurationsdaten der Integration.	Bei der Entwicklung festgelegt und kann beim Veröffentlichen der Integration bearbeitet werden.	Eine Ziel-E-Mail-Adresse für Benachrichtigungen.
System variable	Automatisch vom System generiert.	Schreibgeschützt und kann nicht bearbeitet werden.	Die Variable ExecutionId.
Integrationsvariable	Behält den Überblick über die Daten während der gesamten Integrationsausführung.	Explizit in Ihrer Integration festgelegt und kann während der Ausführung der Integration bearbeitet werden.	Eine Variable zum Speichern des Ergebnisses einer Aufgabe.
Aufgabenvariable	Speichert die Ausgabe einer bestimmten Aufgabe.	Wird implizit durch Ausführen einer Aufgabe festgelegt und kann nicht bearbeitet werden.	Die Variable responseBody der Aufgabe REST-Endpunkt aufrufen.

Variablenreferenzen

Die Aufgaben, Trigger und Edges in einer Integration werden mithilfe von Variablenreferenzen gelesen und in Variablen geschrieben. Eine Variablenreferenz hat das Format $paramKey$, wobei paramKey der Name der Variablen ist.

$isNameUnique$ = true AND $numAccounts$ >= 1

Beispiel:

• Eine Edge-Bedingung könnte so aussehen:

  $isNameUnique$ = true AND $numAccounts$ >= 1

  In diesem Beispiel ist isNameUnique eine Variable vom Datentyp Boolesch und numAccounts ist ein Parameter des Datentyps Ganzzahl.

• Sie können eine E-Mail-Benachrichtigung für eine neue Nutzerregistrierung in einem Application Integration-Workflow erstellen. Angenommen, Sie haben zwei Variablen:
  • $userName$: Enthält den Namen des neuen Nutzers (z.B. „Alex“).
  • $orderID$: Enthält eine eindeutige Bestell-ID (z.B. „ORD-12345“).

  Die Vorlage für den E-Mail-Text könnte so aussehen:

  Hello $userName$, thank you for your order! Your order ID is $orderID$.

  Wenn diese Nachricht gesendet wird, ersetzt das System die Variablenreferenzen durch die entsprechenden Werte. Die endgültige Nachricht lautet:

  Hello Alex, thank you for your order! Your order ID is ORD-12345.

Sie können Variablenreferenzen an den folgenden Stellen verwenden:

• Aufgabenparameter
• Triggerparameter
• Edge-Bedingungen

Wenn Sie auf eine automatisch generierte Variable oder eine Aufgabenvariable verweisen, müssen Sie ihren vollständigen, eindeutigen Namen verwenden, der Backticks und die Aufgaben-ID enthält, und ihn in die Dollarzeichen setzen. Wenn Sie beispielsweise auf die responseBody-Ausgabe einer REST-Endpunkt aufrufen-Aufgabe mit der ID Task_5 verweisen möchten, müssen Sie $`Task_5_responseBody`$ verwenden.

Kontingente und Limits

Weitere Informationen zu allen Kontingenten und Limits finden Sie unter Kontingente und Limits.

Nächste Schritte

• Informationen zum Erstellen von CI/CD für Ihre Integration.
• Informationen zum Maskieren vertraulicher Daten in Logs
• Aufgabe „Datenzuordnung“ hinzufügen und konfigurieren