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.
Achten Sie darauf, dass Sie Ihrer Integration ein vom Nutzer verwaltetes Dienstkonto angehängt haben. Wenn für die Integration kein nutzerverwaltetes Dienstkonto konfiguriert ist, wird standardmäßig das Standarddienstkonto (service-PROJECT_NUMBER@gcp-sa-integrations.iam.gserviceaccount.com) zur Authentifizierung verwendet.
Achten Sie darauf, dass Ihrem Dienstkonto die IAM-Rolle Aufrufer der Anwendungsintegrationen zugewiesen ist. 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:

Rufen Sie in der Google Cloud Console die Seite Application Integration auf.
Zu Application Integration
Klicken Sie im Navigationsmenü auf Integrationen.
Auf der Seite Integrationen werden alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.
Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Verknüpfung erstellen, um eine neue zu erstellen.
Wenn Sie eine neue Integration erstellen, gehen Sie so vor:
1. Geben Sie im Bereich Create Integration (Integration erstellen) einen Namen und eine Beschreibung ein.
2. Wählen Sie eine Region für die Integration aus.
  Hinweis: Im Drop-down-Menü Regionen werden nur die in Ihrem Google Cloud-Projekt bereitgestellten Regionen aufgeführt. Klicken Sie zum Bereitstellen einer neuen Region auf Region aktivieren. Weitere Informationen finden Sie unter Neue Region aktivieren.
3. Wählen Sie ein Dienstkonto für die Integration aus. Sie können die Details des Dienstkontos einer Integration jederzeit im Bereich Integrationsübersicht in der Symbolleiste für Integrationen ändern oder aktualisieren.
  Hinweis:Die Option zur Auswahl eines Dienstkontos wird nur angezeigt, wenn Sie die Integration Governance für die ausgewählte Region aktiviert haben.
4. Klicken Sie auf Erstellen.
Dadurch wird die Integration auf der Seite Integrationseditor geöffnet.
Klicken Sie in der Navigationsleiste des Integrationseditors auf Aufgaben, um eine Liste der verfügbaren Aufgaben und Verbindungen aufzurufen.
Klicken Sie auf das Element Aufrufintegration und fügen Sie es in den Integrationseditor ein.
Klicken Sie im Designer auf das Aufgabenelement Integration aufrufen, um den Konfigurationsbereich der Aufgabe Integration aufrufen anzuzeigen.
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.
  
  Hinweis: Wenn Sie diese Option auswählen, ist die Antwort der Subintegrationen in der Hauptintegration nicht verfügbar. Wenn Sie auf die Antwort der Subintegrationen zugreifen möchten, wählen Sie die Option Einzelne Integration ausführen.
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

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. Hinweis: Dieses Feld wird nur angezeigt, wenn mit der Ausführungsstrategie SYNC die Option Einzelne Integration ausführen ausgewählt ist.

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.

Kontingente und Limits

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