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

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 E-Mail senden.

Hinweise

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 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 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 zum Auswählen eines Dienstkontos wird nur angezeigt, wenn Sie die Integrationsverwaltung 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 eine 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 den Trigger-Konfigurationsbereich aufzurufen. Führen Sie dann die folgenden Schritte 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 wie das Ihrer Integration befinden oder in einem anderen Google Cloud -Projekt.
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 Variablen „config“ muss eine E-Mail-Adresse eines Dienstkontos im folgenden Format sein: [e-mail]. Beispiel: [e-mail]

   Informationen zum Erstellen einer Konfigurationsvariablen finden Sie unter Variable erstellen. Informationen 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 Gewähren von Rollen finden Sie unter Erforderliche IAM-Rollen.

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

   Hinweis : Ab der Veröffentlichung der Anwendungsintegration am 1. Dezember 2023 müssen Sie beim Konfigurieren des Cloud Pub/Sub-Triggers ein Dienstkonto für den Trigger angeben. Ihre vorhandenen Pub/Sub-Trigger, die mit keinem Dienstkonto verknüpft sind, funktionieren weiterhin wie gewohnt. Wenn Sie jedoch einen der vorhandenen Pub/Sub-Trigger ändern möchten, müssen Sie ein Dienstkonto konfigurieren, um diese Trigger weiterhin verwenden zu können.

Standardmäßig ist die Option für den Ablaufzeitraum für Abos auf never expire festgelegt. Wenn Sie das Ablaufdatum auf einen anderen Wert 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 Zuweisen 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 von dem Google Cloud-Projekt der Integration unterscheidet, benötigt das Standarddienstkonto die Rolle „Pub/Sub-Bearbeiter“ im Google Cloud -Projekt des Themas.
Das Dienstkonto, das Sie für diesen Trigger auswählen	Application Integration Invoker (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. In diesem Schritt wird das Abo im Integrationsprojekt erstellt.
2. Rufen Sie in der Google Cloud -Console die Seite Abos auf.

   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, den 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 hängt vom Pub/Sub-Produkt ab. Da diese Abhängigkeit extern zur Application Integration ist, gelten die Nutzungsbedingungen des Service Level Agreements (SLA) für Application Integration 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 Connector-Aufgabe verwenden, um eine Verbindung zu Pub/Sub oder Salesforce herzustellen, wird Ihnen die Connector-Nutzung in Rechnung gestellt. Informationen zu den Preisen finden Sie unter Preise für Application Integration.

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.