Informationen zu den unterstützten Connectors für die Anwendungsintegration.

Cloud Pub/Sub-Trigger

Mit dem Cloud Pub/Sub-Trigger können Sie Ihre Integration basierend auf den Ereignissen in Ihrer Pub/Sub-Middleware ausführen.

Mit diesem Trigger können Sie eine Integration ausführen, wenn ein Publisher eine Nachricht an das von Ihnen gewählte Thema schreibt. Das Thema kann sich im selben Google Cloud-Projekt wie die Integration oder in einem anderen Google Cloud-Projekt befinden. Wenn dieser Trigger ausgeführt wird, schreibt er auch die veröffentlichte Nachricht in die CloudPubSubMessage-Ausgabevariable. Sie können diese Variable basierend auf Ihren Anforderungen in Ihren nachgelagerten Triggern oder Aufgaben verwenden.

Informationen zum Erstellen einer Beispielintegration mit Application Integration und dem Cloud Pub/Sub-Trigger finden Sie unter Cloud Pub/Sub-Thema überwachen und eine E-Mail senden.

Hinweis

Führen Sie die folgenden Aufgaben in Ihrem Google Cloud-Projekt aus, bevor Sie den Cloud Pub/Sub-Trigger konfigurieren.

• Weisen Sie dem Nutzer, der diesen Trigger erstellt, die Rolle Projekt-IAM-Administrator (roles/resourcemanager.projectIamAdmin) zu.
• Aktivieren Sie die Pub/Sub API für das Google Cloud-Projekt, in dem sich Ihre Integration befindet.
• Prüfen Sie, ob ein Pub/Sub-Thema vorhanden ist. So erstellen Sie ein neues Pub/Sub-Thema:
  1. Rufen Sie in der Cloud Console die Seite "Pub/Sub-Themen" auf.

     Zur Seite "Pub/Sub-Themen"

  2. Klicken Sie auf Thema erstellen.
  3. Geben Sie im Feld Themen-ID einen eindeutigen Themennamen ein.
  4. Klicken Sie auf Speichern.
  Hinweis:Sie müssen kein Abo erstellen, damit der Trigger funktioniert. Wenn Sie Ihre Integration veröffentlichen, wird automatisch ein Abo für ein Thema erstellt. Sie können sich alle Ihre Abos auf der Pub/Sub-Aboseite ansehen.

  Ab der Veröffentlichung der Anwendungsintegration am 01. Dezember 2023 werden Ihnen Ihre Abos gemäß den Pub/Sub-Abrechnungspreisen in Rechnung gestellt. Abos für Ihren vorhandenen Cloud Pub/Sub-Trigger funktionieren weiterhin wie gewohnt und werden nicht in Rechnung gestellt. Wenn Sie jedoch das Thema eines vorhandenen Cloud Pub/Sub-Triggers aktualisieren, wird die Pub/Sub-Abrechnung auf den aktualisierten Cloud Pub/Sub-Trigger angewendet.

Weitere Informationen zur Zugriffsverwaltung mit IAM-Rollen finden Sie unter Zugriffssteuerung.

Informationen zum Zuweisen von Rollen für Hauptkonten finden Sie unter Zugriff auf Ressourcen erteilen, ändern und entziehen.

Cloud Pub/Sub-Trigger hinzufügen

So fügen Sie einen Cloud Pub/Sub-Trigger zu einer neuen oder vorhandenen Integration hinzu:

1. Rufen Sie in der Google Cloud Console die Seite Application Integration auf.

   Zu Application Integration

2. Klicken Sie im Navigationsmenü auf Integrations (Integrationen).

   Die Seite Liste der Integrationen wird angezeigt. Dort sind alle Integrationen aufgeführt, die im Google Cloud-Projekt verfügbar sind.

3. Wählen Sie eine vorhandene Integration aus oder klicken Sie auf Integration 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 Dienstkontodetails einer Integration jederzeit in der Symbolleiste der Verknüpfung im Bereich Integrationsübersicht ä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.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie auf das Element Cloud Pub/Sub-Trigger und platzieren Sie es im Designer.

Cloud Pub/Sub-Trigger konfigurieren

Klicken Sie im Integrationseditor auf das Element Cloud Pub/Sub-Trigger, um die Triggerkonfiguration aufzurufen. und führen Sie dann die folgenden Aufgaben aus:

1. Geben Sie im Feld Pub/Sub-Thema das Thema, das der Trigger überwachen soll, in folgendem Format an:

   projects/PROJECT_ID/topics/TOPIC_ID

   Alle verfügbaren Themen in Ihrem Google Cloud-Projekt finden Sie in der Spalte Themenname unter Themen. Sie können auch ein Thema aus einem anderen Google Cloud-Projekt auswählen.

   Ersetzen Sie Folgendes:
   • PROJECT_ID: das Google Cloud-Projekt, in dem das Thema erstellt wurde.
   • TOPIC_ID: die ID Ihres Pub/Sub-Themas. Das Thema kann sich im selben Google Cloud-Projekt befinden wie oder in einem anderen Google Cloud-Projekt vorhanden sein können.
2. Wählen Sie das Dienstkonto aus, mit dem Sie die Integration aufrufen möchten. Sie können auch eine Konfigurationsvariable auswählen, die Sie in der Integration erstellt haben. Der Wert der Konfigurationsvariable muss eine E-Mail-Adresse eines Dienstkontos im folgenden Format sein: [e-mail]. Beispiel: [e-mail]

   Informationen zum Erstellen einer Konfigurationsvariable finden Sie unter Variable erstellen und zum Erstellen eines Dienstkontos finden Sie unter Dienstkonto erstellen.

   Wenn Sie eine Konfigurationsvariable auswählen, müssen Sie dem Dienstkonto, auf das die Konfigurationsvariable verweist, die erforderlichen Rollen zuweisen. Weitere Informationen zum Zuweisen von Rollen finden Sie unter Erforderliche IAM-Rollen.

   Wenn keine Dienstkonten vorhanden sind, erstellen Sie ein Dienstkonto, indem Sie auf Neu erstellen klicken. in der Liste Dienstkonto.

   Hinweis : Beginnend mit der Anwendungsintegration Version vom 1. Dezember 2023, Beim Konfigurieren des Cloud Pub/Sub-Triggers müssen Sie ein Dienstkonto angeben für den Trigger aus. Ihre vorhandenen Pub/Sub-Trigger, die keinen Dienst haben verknüpft sind, funktioniert weiterhin wie gewohnt. Wenn Sie jedoch einen der vorhandenen Pub/Sub-Trigger ändern möchten, müssen Sie Dienstkonto, um diese Trigger weiterhin zu verwenden.

Die Option für den Ablaufzeitraum für Abos ist standardmäßig auf never expire festgelegt. Wenn Sie einen anderen Wert für das Abo festlegen möchten, rufen Sie in der Google Cloud Console die Seite „Pub/Sub-Abo“ auf und bearbeiten Sie das Abo.

Für Dienstkonten erforderliche IAM-Rollen

Wenn Sie bei der Auswahl eines Dienstkontos auf Erteilen klicken, werden den verschiedenen Dienstkonten automatisch die folgenden Rollen zugewiesen.

Dienstkonto	IAM-Rolle gewährt
Standarddienstkonto der Anwendungsintegration: [e-mail]	Pub/Sub-Bearbeiter (roles/pubsub.editor) Dienstkontonutzer (roles/iam.serviceAccountUser) Wenn sich das Google Cloud-Projekt des Pub/Sub-Themas vom Google Cloud-Projekt der Integration unterscheidet, benötigt das Standarddienstkonto die Rolle „Pub/Sub-Bearbeiter“ im Google Cloud-Projekt des Themas.
Dienstkonto, das Sie für diesen Trigger auswählen	Aufrufer von Application Integration (roles/integrations.integrationInvoker)

Trigger-Ausgabe

Für jedes Ereignis generiert der Cloud Pub/Sub-Trigger eine CloudPubSubMessage-Ausgabevariable, die Sie in nachgelagerten Aufgaben verwenden können. Die Variable hat das JSON-Format und die Struktur PubsubMessage.

Hinweise

• Die maximale Größe einer Pub/Sub-Nachricht beträgt 10 MB. Informationen zu allen Einschränkungen von Pub/Sub finden Sie unter Pub/Sub-Kontingente und -Limits.
• Es ist möglich, dass Pub/Sub dieselbe Nachricht mehrmals in ein Thema schreibt. Informationen zum Verhalten von Pub/Sub finden Sie unter Mindestens einmalige Zustellung. Daher müssen Sie Ihre Integration so idempotent gestalten, dass eine Nachricht nicht mehr als einmal in ein Thema geschrieben werden kann.

  Hinweis: Das Feld message_id im Nachrichtenheader identifiziert eine Pub/Sub-Nachricht eindeutig.

• Wenn Sie die Veröffentlichung einer Integration aufheben, wird das Pub/Sub-Abo nicht gelöscht, um den Verlust von Nachrichten zu vermeiden. Wenn Sie jedoch die veröffentlichte Version oder alle Integrationsversionen einer Integration löschen, wird auch das Pub/Sub-Abo gelöscht.

Abo mit Filter für Ihre Integration erstellen

Wenn Sie einen Filter für das Pub/Sub-Abo festlegen möchten, um bestimmte Ereignisse in Ihrer Integration zu verarbeiten, gehen Sie so vor:

1. Veröffentlichen Sie die Integration mit dem konfigurierten Cloud Pub/Sub-Trigger. Mit diesem Schritt wird das Abo im Integrationsprojekt erstellt.
2. Öffnen Sie in der Google Cloud Console die Seite Abos.

   Zu den Abos

3. Öffnen Sie das Abo und kopieren Sie alle Details, einschließlich des Abonamens.
4. Löschen Sie das vorhandene Abo.
5. Erstellen Sie ein neues Abo mit allen Details des gelöschten Abos, einschließlich des Abonamens, die Sie in Schritt 3 kopiert haben, und fügen Sie dem neuen Abo einen Filter hinzu.

   Das neu erstellte Abo löst die Integration mit gefilterten Nachrichten aus.

SLA-Ausschlüsse

Der Cloud Pub/Sub-Trigger ist abhängig vom Pub/Sub Produkt. Da diese Abhängigkeit extern zur Anwendungsintegration ist, gelten die Nutzungsbedingungen des Service Level Agreements (SLA) für die Anwendungsintegration nur, wenn der Cloud Pub/Sub-Trigger die Ausführung einer active-Integration erfolgreich startet.

Preise

Für den Cloud Pub/Sub-Trigger und den Salesforce-Trigger müssen Sie keinen Connector erstellen. Wenn Sie jedoch die Connectors-Aufgabe verwenden, um eine Verbindung zu Pub/Sub oder Salesforce herzustellen, wird Ihnen die Connector-Nutzung in Rechnung gestellt. Informationen zu Preisen finden Sie unter Application Integration – Preise.

Kontingente und Limits

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

Nächste Schritte

• Alle Aufgaben und Trigger.
• Hier erfahren Sie, wie Sie eine Integration testen und veröffentlichen.
• Weitere Informationen zur Fehlerbehandlung.
• Weitere Informationen zu Ausführungslogs der Integration.