Informationen zu den unterstützten Connectors für Application Integration.

Aufgabe „Für alle parallel”

Mit der Aufgabe Für alle parallel können Sie andere Integrationen (Subintegrationen) von Ihrer Hauptintegration ausführen. Wie der Name der Aufgabe schon sagt, laufen die Subintegrationen parallel.

Bei dieser Aufgabe wird die Trigger-ID der API als Ziehpunkt verwendet, um die auszuführenden Integrationen zu identifizieren. Wenn Sie beispielsweise die Trigger-ID der API als api_trigger/APITriggerX angeben, werden für die Aufgabe alle Subintegrationen ausgeführt, die die Trigger-ID api_trigger/APITriggerX haben.

Nach dem Ausführen einer Subintegration können Sie auch die Antwort der Subintegration in Ihrer Hauptintegration lesen. Verwenden Sie diese Aufgabe, um Subintegrationen als Abhängigkeiten der Hauptintegration auszuführen.

Hinweise

Prüfen Sie, ob Sie ein vom Nutzer verwaltetes 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-integrations.iam.gserviceaccount.com) zur Authentifizierung verwendet.
Achten Sie darauf, dass Ihr Dienstkonto die IAM-Rolle Application Integration Invoker hat. Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

Aufgabe „Für alle parallel” konfigurieren

So konfigurieren Sie die Aufgabe Für alle parallel:

Rufen Sie in der Google Cloud Console die Seite Anwendungsintegration auf.
Zur Seite „Application Integration“
Klicken Sie im Navigationsmenü auf Integrations (Integrationen).
Die Seite Integrationen wird angezeigt. Dort sind alle im Google Cloud-Projekt verfügbaren Integrationen aufgeführt.
Wähle eine vorhandene Integration aus oder klicke auf Verknüpfung erstellen, um eine neue zu erstellen.
Wenn Sie eine neue Integration erstellen:
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 Dienstkontodetails einer Integration jederzeit in der Integrationsübersicht in der Integrationssymbolleiste ä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 Tasks, um die Liste der verfügbaren Aufgaben aufzurufen.
Klicken Sie auf das Aufgabenelement Für alle parallel und platzieren Sie es im Integrationseditor.
Klicken Sie im Designer auf das Aufgabenelement Für alle parallel, um den Konfigurationsbereich Für alle parallel zu öffnen.
Konfigurieren Sie die übrigen Felder mit den Konfigurationsattributen für die Aufgabe, wie in folgenden Tabellen beschrieben.
Alle Änderungen an den Eigenschaften werden automatisch gespeichert.

Konfigurationsattribute

In diesem Abschnitt werden die Konfigurationsattribute der Aufgabe Für alle parallel beschrieben.

Eingabeattribute

Property-Name	Parametername	Datentyp	Beschreibung
Arrayauswahl	`List to iterate`	Ein Array vom Typ String, Integer, Double oder JSON.	Liste der Werte, für die Subintegrationen ausgeführt werden sollen. Für jeden Wert in der Liste wird ein separater Subintegrations-Thread ausgeführt. Alle Threads werden gleichzeitig ausgeführt. Sie können den iterierten Wert an die Subintegration übergeben, indem Sie das Feld Wohin einzelne Arrayelemente zugeordnet werden sollen festlegen. Sie können auch zusätzliche Werte von der Hauptintegration an die Subintegrationen im Feld Zusätzlichen Subintegrat ionseingabe(n) zuordnen übergeben.
Details zur Teilintegration	`API Trigger ID`	String	Trigger-ID der veröffentlichten Unterintegration, die ausgeführt werden soll. Dieser Wert ist im Feld Trigger-ID des API-Triggers in der Subintegration verfügbar.
	`Execution strategy`	–	SYNC – Führt die Subintegrationen 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 Subintegrationen 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.
	`Run all integrations with this API Trigger ID`	–	Führt alle Integrationen mit derselben API-Trigger-ID aus. Wenn beispielsweise die Integration `A` und die Integration `B` dieselbe API-Trigger-ID haben, werden für jedes Element in Liste zum Interieren 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 die Antwort der Subintegrationen verwenden möchten, wählen Sie die Option Einzelne Integration ausführen aus.
	`Run a single integration`	–	Führt nur die Integration aus, die im Feld Integrationsname angegeben ist. Sie können auf die Antwort der Subintegrationen zugreifen, indem Sie den Abschnitt Werte aus Subintegrationsausgabe(n) erfassen konfigurieren.
Bei jeder Ausführung	`Where to map individual array elements`	String	Der Name der Eingabevariablen der Subintegration, der die Arrayelemente zugeordnet werden sollen. Die Arrayelemente können direkt einer Eingabevariablen der Subintegration zugeordnet werden. Wenn eine einzelne Subintegration ausgewählt wurde, können Sie die Eingabevariable der Subintegration aus einer Drop-down-Liste auswählen.
	`Map to additional sub-integration input(s)`	String	Zusätzliche Zuordnungsoption für Subintegrationen. Integrationsvariable, aus der zugeordnet werden soll: Der Name der Variablen in der aktuellen Integration, die an die Eingabevariable der Subintegration übergeben werden soll. Subintegrationseingabe, zu der zugeordnet werden soll: Der Name der Eingabevariablen der Subintegration, zu der zugeordnet werden soll. 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. Angenommen, Ihre Hauptintegration hat die Variable `productID`, die Sie der Unterintegrationsvariable `subIntProductID` zuordnen möchten. Sie müssen `productID` aus dem Feld Integrationsvariable für die Zuordnung aus auswählen und `subIntProductID` in das Feld Eingabe der Unterintegration, die zugeordnet werden soll eingeben.
	`Collect values from sub-integration output(s)`	String	Wenn die Ausführungsstrategie synchron (SYNC) ist und eine einzelne Teilintegration (Einzelne Integration ausführen) ausgewählt ist, können die Ausgaben der Teilintegration in Arrayvariablen in der aktuellen Integration erfasst werden. Subintegrationsausgabe, aus der erfasst werden soll: Der Name der Ausgabevariablen der Subintegration, die aggregiert werden soll. Integrationsvariable, in die erfasst werden soll: Der Name der Variablen in der aktuellen Integration für die Erfassung der aggregierten Ausgaben.
Ausführungseinstellungen	`Integrations to execute at a time (parallel)`	Integer	Maximal zulässige Anzahl paralleler Ausführungen für Subintegrationen. Der Standardwert ist `50` (maximal `10000`). Alle Subintegrationen in einer Kohorte werden vollständig ausgeführt, bevor die nächste Kohorte von Subintegrationen ausgeführt wird.
Ausführungseinstellungen	`Ignore failures`	Boolesch	Sie können einen der folgenden Werte angeben: True: Die Aufgabe ignoriert Fehler bei der Subintegration und führt alle Ausführungen aus. False: Die Aufgabe schlägt bei Fehlern bei der Subintegration fehl und beendet alle Ausführungen.

Best Practices

Wir empfehlen die folgenden Best Practices bei der Verwendung der Aufgabe Für alle parallel:

Legen Sie die Kohortengröße basierend auf den Kontingentbeschränkungen fest, die durch die Subintegrationen festgelegt werden.
Verwenden Sie eine SYNC-Ausführungsstrategie, wenn Sie die Ausgabe der Subintegration zur späteren Verwendung erfassen möchten.
Verwenden Sie eine ASYNC-Ausführungsstrategie, wenn Ihre Subintegration mehr als 2 Minuten dauert.

Informationen zu den Nutzungslimits für die Aufgabe Für alle parallel finden Sie unter Nutzungslimits.

Hinweise

Verwenden Sie im Allgemeinen keine SYNC-Ausführungsstrategie, wenn die Ausführung Ihrer Subintegration länger als 2 Minuten dauert oder Sie planen, diese Aufgabe in Verbindung mit natürlich asynchronen Aufgaben wie der Aufgabe „Genehmigung” zu verwenden.

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.