Variablen in Apigee-Integration verwenden

Mitteilung: Application Integration ist jetzt für Ihr Google Cloud-Projekt verfügbar. Sie können jetzt Apigee Integration und Application Integration im selben Google Cloud-Projekt verwenden. Weitere Informationen

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.

Es gibt drei Arten von Variablen:

• Mit Integrationsvariablen behalten Sie den Überblick über die Daten während der gesamten Integrationsausführung.
• Aufgabenvariablen erfassen Daten für die Dauer einer einzelnen Aufgabe.
• Konfigurationsvariablen: Speichern Sie die Konfigurationsdaten der Integration.

Integrationsvariablen

Integrationsvariablen ä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 (Eingabevariablen).
• Als Ausgabe der Integration (Ausgabevariablen).
• 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 Variable kann eine Eingabevariable, eine Ausgabevariable oder beides sein.

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 für Integrationsvariablen

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. Bei der Aufgabe Call REST Endpoint wird der Antworttext beispielsweise in der Variable responseBody gespeichert.

Konfigurationsvariablen

Vorschau

Dieses Produkt oder diese Funktion unterliegt den „Nutzungsbedingungen für Pre-GA-Angebote“ im Abschnitt „Allgemeine Nutzungsbedingungen“ der dienstspezifischen Nutzungsbedingungen. Pre-GA-Produkte und -Funktionen sind unverändert verfügbar und werden möglicherweise nur eingeschränkt unterstützt. Weitere Informationen finden Sie in 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. Connector-Details, Authentifizierungsdetails oder URL-Endpunkte, die auf der Entwicklungsumgebung (QA, Staging oder Produktion) basieren. Sie müssen die 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.

Informationen zum Erstellen und Verwenden von Konfigurationsvariablen finden Sie in der Anleitung CICD für Ihre Integration erstellen.

Variablen anzeigen

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

Klicken Sie zum Aufrufen des Bereichs Variablen in der Navigationsleiste des Designers auf (Steuerfeld ein-/ausblenden).

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

Variable erstellen

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

1. Klicken Sie in der Navigationsleiste des Integrationseditors auf (Steuerfeld ein-/ausblenden), 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
      Doppelt	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 Beispiel-JSON-Nutzlast ableiten: Generiert ein JSON-Schema aus einer Beispiel-JSON-Nutzlast. Die Beispielnutzlast wird verworfen, nachdem das Schema generiert wurde. 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.
      • Keine: 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. Zum Aktivieren der Maskierung für die Variable müssen Sie Maskierungsvariablen 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.

      Informationen zur Maskierung finden Sie unter Vertrauliche Daten in Logs maskieren.

4. Klicken Sie auf Erstellen.

Variablendaten in Integrationen verwenden

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