Anrufintegrationsaufgabe

Mit der Aufgabe Anrufintegration können Sie andere in Ihrem Google Cloud-Projekt erstellte Integrationen aufrufen oder aufrufen.

Die Aufgabe Anrufintegration ist nützlich in Szenarien, in denen Sie mehrere kleine Integrationen (Subintegrationen) definieren müssen, die mit einer Hauptintegration (übergeordnete Integration) gesteuert werden. Nach dem Ausführen einer Subintegration können Sie auch die Antwort der Subintegration in Ihrer Hauptintegration lesen.

Hinweise

  • Die Aufgabe Anrufintegration verwendet den API-Trigger, um andere Integrationen und Teilintegrationen zu identifizieren und aufzurufen. Daher müssen Sie sicherstellen, dass die Integrationen, die Sie aufrufen möchten, mit dem API-Trigger konfiguriert sind. Informationen zum Konfigurieren eines API-Triggers finden Sie unter API-Trigger.
  • Sie müssen ein nutzerverwaltetes Dienstkonto an Ihre Integration angehängt haben. Wenn für die Integration kein nutzerverwaltetes Dienstkonto konfiguriert ist, wird standardmäßig das Standarddienstkonto (service-PROJECT_NUMBER@gcp-sa-apigee.iam.gserviceaccount.com) zur Authentifizierung verwendet.
  • Achten Sie darauf, dass Ihr Dienstkonto die IAM-Rolle Aufrufer der Anwendungsintegration hat. Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

Aufgabe für die Anrufintegration konfigurieren

So konfigurieren Sie die Aufgabe Call Integration:

  1. Wählen Sie in der Apigee-Benutzeroberfläche Ihre Apigee-Organisation aus.
  2. Klicken Sie auf Entwickeln > Integrationen.
  3. Wählen Sie eine vorhandene Integration aus oder erstellen Sie eine neue Integration, indem Sie auf Integration erstellen klicken.

    Wenn Sie eine neue Integration erstellen, gehen Sie so vor:

    1. Geben Sie im Dialogfeld Integration erstellen einen Namen und eine Beschreibung ein.
    2. Wählen Sie eine Region für die Integration aus der Liste der unterstützten Regionen aus.
    3. Klicken Sie auf Erstellen.

    Dadurch wird die Integration auf der Seite Integrationsdesigner geöffnet.

  4. Klicken Sie in der Navigationsleiste Integrationsdesigner auf + Aufgabe/Trigger hinzufügen > Aufgaben, um die Liste der verfügbaren Aufgaben aufzurufen.
  5. Klicken Sie auf das Element Aufrufintegration und fügen Sie es in den Integrationseditor ein.
  6. Klicken Sie im Designer auf das Aufgabenelement Integration aufrufen, um den Konfigurationsbereich der Aufgabe Integration aufrufen anzuzeigen.
  7. Konfigurieren Sie die folgenden Details der Subintegration:
    1. API-Trigger-ID: Geben Sie die API-Trigger-ID der Integration ein, die Sie aufrufen möchten. Sie können eine oder mehrere Integrationen mit derselben Trigger-ID aufrufen.
    2. Alle Integrationen mit dieser API-Trigger-ID ausführen: Wählen Sie diese Option aus, um alle Integrationen mit derselben API-Trigger-ID aufzurufen.

      Beispiel: Wenn die Integration A und die Integration B dieselbe API-Trigger-ID haben, werden beide Integrationen, A und B, ausgeführt.

    3. Einzelne Integration ausführen: Wählen Sie diese Option aus, um nur die im Feld Integrationsname angegebene Integration aufzurufen. Sie können auf die Antwort der Subintegration zugreifen und sie zuordnen. Konfigurieren Sie dazu die Felder, die unter Antwortvariablen der Subintegration zuordnen beschrieben werden.

    4. Ausführungsstrategie: Wählen Sie die Ausführungsmodi für die Subintegrationen aus, die Sie aufrufen möchten.
      • SYNC: Führt die Subintegration im synchronen Modus aus. In diesem Modus wartet die Hauptintegration, bis die Subintegrationen abgeschlossen sind, bevor sie mit den nachgelagerten Aufgaben fortfährt.

      • ASYNC: Führt die Subintegration im asynchronen Modus aus. In diesem Modus wartet die Hauptintegration nicht, bis die Subintegrationen abgeschlossen sind. Direkt nach dem Aufrufen der Subintegrationen führt die Hauptintegration die nachgelagerten Aufgaben aus.

        Wenn diese Option ausgewählt ist, legen Sie die Ausführungsverzögerung (in Millisekunden) fest. Wenn festgelegt, gibt dies die Zeitverzögerung an, bis die Integration ausgeführt wird.

      Ihre Änderungen an den Attributen werden automatisch gespeichert.

Antwortvariablen der Subintegration zuordnen

In der folgenden Tabelle werden die Konfigurationsattribute beschrieben, mit denen Variablen zwischen der Hauptintegration und den Subintegrationen zugeordnet werden können:
Attribut Beschreibung
Map to sub-integration input(s)

Ordnet Werte der Hauptintegration der Subintegration zu. Dieses Feld nimmt Werte in Form von Schlüssel/Wert-Paaren an, wobei der Schlüssel eine Variable in der Hauptintegration ist und der Wert die entsprechende Eingabevariable in der Subintegration ist.

Wenn Sie beispielsweise die Variable productID der Hauptintegration der Variable subIntProductID der Subintegration zuordnen möchten, wählen Sie productID aus der Integrationsvariablen aus, aus der zugeordnet werden soll aus und geben Sie subIntProductID in das Feld Subintegrationseingabe, zu der zugeordnet werden soll ein.
Map values to sub-integration output(s) Ordnet die Subintegrationsausgabevariablen zu den Hauptintegrationsvariablen zu.

Klicken Sie auf Subintegrationsausgabe, aus der zugeordnet werden soll, und wählen Sie die Subintegration aus. Klicken Sie auf Integrationsvariable, in die zugeordnet werden soll, und wählen Sie die entsprechende Hauptintegrationsvariable aus.

Best Practices

Informationen zu den Nutzungslimits für die Aufgabe Anrufintegration finden Sie unter Nutzungslimits.

Fehlerbehebungsstrategie

Eine Strategie zur Fehlerbehandlung für eine Aufgabe legt die Aktion fest, die ausgeführt werden soll, wenn die Aufgabe aufgrund eines temporären Fehlers fehlschlägt. Informationen zur Verwendung einer Fehlerbehandlungsstrategie und zu den verschiedenen Arten von Fehlerbehandlungsstrategien finden Sie unter Strategien zur Fehlerbehebung.