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

ServiceNow-Trigger

Der ServiceNow-Trigger ist ein Trigger für Connector-Ereignisse, mit dem Sie eine Integration basierend auf den benutzerdefinierten ServiceNow-Ereignissen aufrufen können, die Sie in der Geschäftsregel Ihrer ServiceNow-Instanz definiert haben.

Wichtig:Integration Connectors ist eine kostenpflichtige Komponente von Google Cloud. Informationen zu den Kosten und Gebühren für die Verwendung von Integrations-Connectors finden Sie unter Preise für Integrations-Connectors.

Hinweise

Wenn Sie eine neue Verbindung für den ServiceNow-Trigger erstellen oder konfigurieren möchten, benötigen Sie die folgende IAM-Rolle für das Projekt:

• Connector-Administrator (roles/connectors.admin)

Weitere Informationen zum Zuweisen von Rollen finden Sie unter Zugriff verwalten.

Weisen Sie dem Dienstkonto, das Sie für den ServiceNow-Trigger verwenden möchten, die folgenden IAM-Rollen zu:

• Application Integration Invoker (roles/integrations.integrationInvoker)

Informationen zum Zuweisen von Rollen zu einem Dienstkonto finden Sie unter Zugriff auf Dienstkonten verwalten.

ServiceNow-Trigger hinzufügen

Führen Sie die folgenden Schritte aus, um der Integration einen ServiceNow-Trigger hinzuzufügen:

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 ServiceNow-Trigger und platzieren Sie es im Integrationseditor.

Sie können den ServiceNow-Trigger entweder mit einer vorhandenen ServiceNow-Verbindung konfigurieren, die in Integration Connectors verfügbar ist, oder eine neue ServiceNow-Verbindung mithilfe der Option zum Erstellen einer Inline-Verbindung erstellen.

ServiceNow-Trigger mit einer vorhandenen Verbindung konfigurieren

Sie können den ServiceNow-Trigger mit einer vorhandenen ServiceNow-Verbindung in Integration Connectors konfigurieren. Der ServiceNow-Trigger ist ein Connector-Ereignistrigger. Sie können den Trigger daher nur mit einer ServiceNow-Verbindung mit aktiviertem Ereignisabo konfigurieren.

Informationen zum Konfigurieren eines ServiceNow-Triggers mit einer neuen ServiceNow-Verbindung finden Sie unter ServiceNow-Trigger mit einer neuen Verbindung konfigurieren.

So konfigurieren Sie einen ServiceNow-Trigger mit einer vorhandenen ServiceNow-Verbindung:

1. Klicken Sie im Integrationseditor auf das Element ServiceNow-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Geben Sie auf der Seite Connector Event Trigger Editor (Editor für Connector-Ereignistrigger) die folgenden Konfigurationsdetails an:
   1. Region:Wählen Sie die Region Ihrer ServiceNow-Verbindung aus.
   2. Verbindung:Wählen Sie die ServiceNow-Verbindung aus, die Sie verwenden möchten.

      In der Anwendungsintegration werden nur die ServiceNow-Verbindungen angezeigt, die aktiv sind und für die ein Ereignisabo aktiviert ist.

   3. Typ des Ereignis-Abos:Geben Sie den Ereignistyp ein, mit dem Sie die Integration auslösen möchten. Diese Ereignistypen müssen in der Geschäftsregel Ihrer ServiceNow-Instanz definiert sein.
   4. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für den ServiceNow-Trigger aus.
4. Klicken Sie auf Fertig, um die Triggerkonfiguration abzuschließen und die Seite zu schließen.

ServiceNow-Trigger mit einer neuen Verbindung konfigurieren

So konfigurieren Sie den ServiceNow-Trigger mit einer neuen ServiceNow-Verbindung:

1. Klicken Sie im Integrationseditor auf das Element ServiceNow-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Überspringen Sie das Feld Region.
4. Klicken Sie auf Verbindung und wählen Sie im Drop-down-Menü die Option Verbindung erstellen aus.
5. Führen Sie die folgenden Schritte im Bereich Verbindung erstellen aus:
   1. Wählen Sie im Schritt Standort den Standort für die neue ServiceNow-Verbindung aus:
      1. Region:Wählen Sie eine Region aus der Drop-down-Liste aus.
      2. Klicken Sie auf Weiter.
   2. Geben Sie im Schritt Verbindungsdetails Details zur neuen ServiceNow-Verbindung an:
      1. Connector-Version:Wählen Sie eine verfügbare Version des ServiceNow-Connectors aus der Drop-down-Liste aus.
      2. Verbindungsname:Geben Sie einen Namen für die ServiceNow-Verbindung ein.
         Hinweis: Verbindungsnamen müssen die folgenden Kriterien erfüllen:

         • Verbindungsnamen können Buchstaben, Ziffern oder Bindestriche enthalten.
         • Buchstaben müssen Kleinbuchstaben sein.
         • Verbindungsnamen müssen mit einem Buchstaben beginnen und mit einem Buchstaben oder einer Ziffer enden.
         • Verbindungsnamen dürfen maximal 63 Zeichen haben.
      3. Optional: Beschreibung : Geben Sie eine Beschreibung für die Verbindung ein.
      4. Optional: Cloud Logging aktivieren: Klicken Sie dieses Kästchen an, um alle Protokolldaten der Verbindung zu speichern.
      5. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für die ServiceNow-Verbindung aus.
      6. Ereignisanmeldung aktivieren:Wählen Sie diese Option aus, um eine neue Ereignisanmeldung für die ServiceNow-Verbindung zu erstellen und zu aktivieren. Sie können entweder nur Ereignisabonnements aktivieren oder auch Entitäten, Vorgänge und Aktionen für Verbindungen einbeziehen.
         Hinweis:Wenn Sie Entitäten, Vorgänge und Aktionen für die Verbindung aktivieren, sind die folgenden zusätzlichen Schritte zur Verbindungskonfiguration erforderlich:

         • Ziele
         • Authentifizierung
      7. Systemtabellen einschließen:Wählen Sie diese Option aus, um Systemtabellen in der Verbindung zu erfassen oder einzubeziehen.
      8. Optional: Filtertabellen: Geben Sie die Liste der Systemtabellen ein, die Sie einbeziehen möchten (durch Kommas getrennt, beginnend mit „sys_“).
      9. Optional: Maximieren Sie Erweiterte Einstellungen, um die Einstellungen für den Verbindungsknoten zu konfigurieren.

         Weitere Informationen zu den Einstellungen für Verbindungsknoten für ServiceNow finden Sie in der Dokumentation zur ServiceNow-Verbindung.

      10. Optional: Klicken Sie auf + Label hinzufügen, um der Verbindung ein Label in Form eines Schlüssel/Wert-Paars hinzuzufügen.
      11. Klicken Sie auf Weiter.
   3. Geben Sie im Schritt Ziele die Details zur ServiceNow-Instanz an:
      1. Zieltyp:Wählen Sie Hostadresse aus.
      2. Host:Geben Sie den Hostnamen oder die IP-Adresse Ihrer ServiceNow-Instanz ein.
      3. Klicken Sie auf Weiter.
   4. Geben Sie im Schritt Authentifizierung die Authentifizierungsdetails für die ServiceNow-Instanz an:
      1. Nutzername:Geben Sie den Nutzernamen ein, um auf die angegebene Zieladresse zuzugreifen.
      2. Passwort:Wählen Sie das Secret Manager-Secret mit dem Passwort aus, das dem ServiceNow-Nutzernamen zugeordnet ist.
      3. Secret-Version:Wählen Sie eine Secret-Version aus.

      Weitere Informationen zum Konfigurieren der Authentifizierung finden Sie unter Authentifizierung konfigurieren.

      4. Klicken Sie auf Weiter.
   5. Geben Sie im Schritt Details zum Ereignisabo die Authentifizierungsdetails an, die zum Validieren der ServiceNow-Tokennutzlast verwendet werden:
      1. Authentifizierungstoken:Optional. Wählen Sie das Secret Manager-Secret Ihres Authentifizierungstokens und die entsprechende Secret-Version aus dem Drop-down-Menü Secret-Version aus.
      2. HMAC-Algorithmus:Optional. Wählen Sie den HMAC-Algorithmus zum Verschlüsseln der Antwortnutzlast aus.
      3. HMAC-Secret-Schlüssel:Wenn Sie einen HMAC-Algorithmus ausgewählt haben, wählen Sie das Secret Manager-Secret des HMAC-Schlüssels und die entsprechende Secret-Version aus dem Drop-down-Menü Secret-Version aus.
      4. Klicken Sie auf Weiter.
   6. Überprüfen: Prüfen Sie die angegebenen ServiceNow-Verbindungsdetails.
   7. Klicken Sie auf Erstellen, um die neue ServiceNow-Verbindung zu erstellen.
6. Nachdem die ServiceNow-Verbindung erstellt wurde, müssen Sie in Ihrer ServiceNow-Instanz eine Geschäftsregel manuell erstellen.
   Hinweis:In ServiceNow wird keine Geschäftsregel automatisch erstellt. Daher müssen Sie in Ihrer ServiceNow-Instanz manuell eine Geschäftsregel erstellen, um Ereignisabonnements zu aktivieren. Informationen zum Erstellen einer Geschäftsregel finden Sie unter Geschäftsregel erstellen.
7. Typ des Ereignis-Abos:Geben Sie den Ereignistyp ein, mit dem Sie die Integration auslösen möchten. Diese Ereignistypen müssen in der Geschäftsregel Ihrer ServiceNow-Instanz definiert sein.
8. Klicken Sie auf Fertig und schließen Sie die Seite.

Geschäftsregel erstellen

Eine ServiceNow-Geschäftsregel ist eine serverseitige Logik, die ausgeführt wird, wenn ein Datenbankeintrag in Ihrer ServiceNow-Instanz abgefragt, aktualisiert, eingefügt oder gelöscht wird. Bei der Anwendungsintegration werden diese Geschäftsregeln verwendet, um Ereignisse zu identifizieren und zu überwachen, die eine Integration auslösen.

Informationen zum Erstellen einer Geschäftsregel finden Sie in der ServiceNow-Dokumentation.

Wichtige Punkte:

• Verwenden Sie den Wert Ereignis-Listener-Endpunkt aus Ihrer ServiceNow-Verbindung in Integration Connectors, um die request.setEndpoint-URL in Ihrer Geschäftsregel zu definieren.
• Verwenden Sie eventType als Schlüssel, um Werte für benutzerdefinierte Ereignistypen in request.setRequestBody zu definieren.

Die folgende Abbildung zeigt eine Beispielgeschäftsregel für ServiceNow mit dem Ereignistyp update_ticket:

Trigger-Ausgabe

Bei Verwendung des ServiceNow-Triggers dauert es einige Minuten, bis die Konfiguration des Ereignis-Abos abgeschlossen ist. Den Status Ihres Ereignisabonnements finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabonnement.

Der ServiceNow-Trigger gibt den Status eines Ereignis-Abos anhand der folgenden Status an:

• Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
• Active: Gibt an, dass für den Trigger ein Ereignisabo abonniert wurde.
• Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Im Bereich Details zum Ereignisabo werden neben dem Status des Ereignisabos auch weitere Details wie die Verbindungsregion, der Verbindungsname und der Name des Ereignisabos angezeigt.

Die folgende Abbildung zeigt ein Beispiellayout für den Konfigurationsbereich für ServiceNow-Trigger:

Trigger-Ausgabevariable

Für jedes Ereignis generiert der ServiceNow-Trigger eine ConnectorEventPayload-Ausgabevariable, die Sie in nachgelagerten Aufgaben verwenden können. Die Ausgabevariable ist im JSON-Format und enthält das Ausgabe-ServiceNow-Nutzlastschema.

Ereignisabos ansehen

So rufen Sie alle Ereignisabonnements auf, die mit einer Verbindung in Integration Connectors verknüpft sind, und verwalten sie:

1. Rufen Sie die Seite Integration Connectors > Verbindungen auf.

   Zur Seite „Verbindungen“

2. Klicken Sie auf die Verbindung, für die Sie die Abos aufrufen möchten.
3. Klicken Sie auf den Tab Ereignisabos.

   Daraufhin werden alle Ereignisabonnements für die Verbindung angezeigt.

ServiceNow-Trigger bearbeiten

Sie können einen ServiceNow-Trigger bearbeiten, um die Verbindungskonfiguration und die Details zum Ereignisabo zu ändern oder zu aktualisieren.

Wichtig:Wenn Sie einen ServiceNow-Trigger bearbeiten oder ändern, können Sie das zuvor konfigurierte Ereignisabo, das mit dem Trigger verknüpft ist, entweder beibehalten oder löschen. Das Löschen eines Ereignisabos wirkt sich auf alle veröffentlichten Integrationen aus, die dieses Ereignisabo verwenden.

So bearbeiten Sie einen ServiceNow-Trigger:

1. Klicken Sie im Integrationseditor auf das Element ServiceNow-Trigger, um den Bereich für die Triggerkonfiguration zu öffnen.
2. Klicken Sie auf ServiceNow-Trigger konfigurieren.
3. Führen Sie auf der Seite Connector-Ereignistrigger-Editor die folgenden Schritte aus:
   1. Wenn Sie das zuvor konfigurierte Ereignisabo beibehalten möchten, klicken Sie auf Beibehalten. Andernfalls klicken Sie auf Löschen.
      Warnung:Wenn Sie ein Ereignisabo löschen, wirkt sich das auf alle veröffentlichten Integrationen aus, die das Ereignisabo verwenden. Diese Aufgabe kann nicht rückgängig gemacht werden.
   2. Aktualisieren Sie die Verbindungskonfiguration und die Details zum Ereignisabo nach Bedarf.
   3. Klicken Sie auf Fertig.

Die aktualisierten Details zur Verbindung und zum Ereignisabo finden Sie im Bereich „Triggerkonfiguration“ unter Details zum Ereignisabo.

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.