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 Integration Connectors finden Sie unter Preise für Integration 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:

• Connectors-Administrator (roles/connectors.admin)

Informationen zum Gewähren 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:

• Aufrufer von Application Integration (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 Ihrer Integration einen ServiceNow-Trigger hinzuzufügen:

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

   Zur Seite „Application Integration“

2. Klicken Sie im Navigationsmenü auf Integrationen.

   Die Seite Integrationsliste mit allen im Google Cloud-Projekt verfügbaren Integrationen wird angezeigt.

3. 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.

4. Klicken Sie in der Navigationsleiste des Integrationseditors auf Trigger, um die Liste der verfügbaren Trigger aufzurufen.
5. Klicken Sie auf das Element ServiceNow trigger und platzieren Sie es im Integrationseditor.

Zum Konfigurieren des ServiceNow-Triggers können Sie entweder eine vorhandene ServiceNow-Verbindung verwenden, die in Integration Connectors verfügbar ist, oder eine neue ServiceNow-Verbindung mit der Option zum Erstellen von Inline-Verbindungen erstellen.

ServiceNow-Trigger mithilfe einer vorhandenen Verbindung konfigurieren

Sie können den ServiceNow-Trigger mithilfe einer vorhandenen ServiceNow-Verbindung in Integration Connectors konfigurieren. Der ServiceNow-Trigger ist ein Trigger für Connector-Ereignisse. Sie können den Trigger daher nur über eine 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.

Führen Sie die folgenden Schritte aus, um einen ServiceNow-Trigger mithilfe einer vorhandenen ServiceNow-Verbindung zu konfigurieren:

1. Klicken Sie im Integrationseditor auf das Element ServiceNow trigger, um den Bereich zur Triggerkonfiguration zu öffnen.
2. Klicken Sie auf Trigger konfigurieren.
3. Geben Sie auf der Seite 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.

      Application Integration zeigt nur die ServiceNow-Verbindungen an, die aktiv und für ein Ereignisabo aktiviert sind.

   3. Ereignisabotyp:Geben Sie den Ereignistyp ein, der die Integration auslösen soll. 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

Führen Sie die folgenden Schritte aus, um den ServiceNow-Trigger mit einer neuen ServiceNow-Verbindung zu konfigurieren:

1. Klicken Sie im Integrationseditor auf das Element ServiceNow trigger, um den Bereich zur 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 im Bereich Create Connection (Verbindung erstellen) die folgenden Schritte 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 Next (Weiter).
   2. Geben Sie im Schritt Verbindungsdetails Details zur neuen ServiceNow-Verbindung an:
      1. Connector-Version:Wählen Sie in der Drop-down-Liste eine verfügbare Version des ServiceNow-Connectors aus.
      2. Connection Name (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 Logdaten der Verbindung zu speichern.
      5. Dienstkonto: Wählen Sie ein Dienstkonto mit den erforderlichen IAM-Rollen für die ServiceNow-Verbindung aus.
      6. Ereignisabo aktivieren:Wählen Sie diese Option aus, um ein neues Ereignisabo für die ServiceNow-Verbindung zu erstellen und zu aktivieren. Sie können entweder nur Ereignisabos aktivieren oder auch Entitäten, Vorgänge und Aktionen für die Verbindung einschließen.
         Hinweis: Die folgenden zusätzlichen Schritte zur Konfiguration der Verbindung sind erforderlich, wenn Sie Entitäten, Vorgänge und Aktionen für die Verbindung aktivieren:

         • Ziele
         • Authentifizierung
      7. Systemtabellen einschließen:Wählen Sie aus, ob Systemtabellen in die Verbindung aufgenommen oder aufgenommen werden sollen.
      8. Optional: Tabellen filtern: Geben Sie die Liste der Systemtabellen ein (beginnend mit „sys_“, durch Kommas getrennt), die Sie einschließen möchten.
      9. Optional: Maximieren Sie Erweiterte Einstellungen, um die Einstellungen für 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 Next (Weiter).
   3. Geben Sie im Schritt Ziele die Details der 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 Next (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 mit dem ServiceNow-Nutzernamen verknüpft 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 Next (Weiter).
   5. Geben Sie im Schritt Ereignisabodetails die Authentifizierungsdetails an, die zum Validieren der ServiceNow-Token-Nutzlast verwendet werden:
      1. Authentication Token (Authentifizierungstoken): (Optional) Wählen Sie das Secret Manager-Secret des 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 sowie die entsprechende Secret-Version aus dem Drop-down-Menü Secret-Version aus.
      4. Klicken Sie auf Next (Weiter).
   6. Überprüfung: Prüfen Sie die bereitgestellten ServiceNow-Verbindungsdetails.
   7. Klicken Sie auf Erstellen, um das Erstellen einer neuen ServiceNow-Verbindung abzuschließen.
6. Nachdem die ServiceNow-Verbindung erstellt wurde, müssen Sie Ihre ServiceNow-Instanz aufrufen und manuell eine Geschäftsregel erstellen.
   Hinweis:Von ServiceNow wird eine Geschäftsregel nicht automatisch erstellt. Daher müssen Sie manuell eine Geschäftsregel in Ihrer ServiceNow-Instanz erstellen, um Ereignisabos zu aktivieren. Weitere Informationen zum Erstellen einer Geschäftsregel finden Sie unter Geschäftsregel erstellen.
7. Ereignisabotyp:Geben Sie den Ereignistyp ein, der die Integration auslösen soll. 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. Application Integration verwendet diese Geschäftsregeln, 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 für den Ereignis-Listener-Endpunkt aus Ihrer ServiceNow-Verbindung in Integration Connectors, um die URL request.setEndpoint 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 ein Beispiel für eine ServiceNow-Geschäftsregel mit dem Ereignistyp update_ticket:

Trigger-Ausgabe

Es dauert einige Minuten, bis der ServiceNow-Trigger das Ereignisabo konfiguriert hat. Sie können den Status Ihres Ereignisabos im Bereich für die Triggerkonfiguration unter Ereignisabodetails ansehen.

Der ServiceNow-Trigger gibt den Status eines Ereignisabos mit den folgenden Status an:

• Creating: Gibt an, dass der Trigger das Ereignisabo abonniert.
• Active: Gibt an, dass der Trigger ein Ereignisabo abonniert hat.
• Error: Gibt an, dass ein Problem mit dem konfigurierten Ereignisabo vorliegt.

Neben dem Abostatus des Ereignisses werden im Abschnitt Ereignisabodetails auch weitere Details wie Verbindungsregion, Verbindungsname, Name des Ereignisabos und mehr angezeigt.

Die folgende Abbildung zeigt ein Beispiellayout des Konfigurationsbereichs für ServiceNow-Trigger:

Trigger-Ausgabevariable

Der ServiceNow-Trigger generiert für jedes Ereignis eine ConnectorEventPayload-Ausgabevariable, die Sie in nachgelagerten Aufgaben verwenden können. Die Ausgabevariable hat das JSON-Format, das das ServiceNow-Ausgabeschema enthält.

Ereignisabos ansehen

So können Sie alle Ereignisabos aufrufen und verwalten, die mit einer Verbindung in Integration Connectors verknüpft sind:

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

   Zur Seite „Verbindungen“

2. Klicken Sie auf die Verbindung, deren Abos Sie sich ansehen möchten.
3. Klicken Sie auf den Tab Ereignisabos.

   Dadurch werden alle Ereignisabos für die Verbindung angezeigt.

ServiceNow-Trigger bearbeiten

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

Wichtig:Wenn Sie einen ServiceNow-Trigger bearbeiten oder ändern, können Sie entweder das zuvor konfigurierte Ereignisabo beibehalten, das mit dem Trigger verknüpft ist, oder es löschen. Wenn Sie ein Ereignisabo löschen, wirkt sich das auf alle veröffentlichten Integrationen aus, für die dieses Ereignisabo verwendet wird.

Führen Sie die folgenden Schritte aus, um einen ServiceNow-Trigger zu bearbeiten:

1. Klicken Sie im Integrationseditor auf das Element ServiceNow trigger, um den Bereich zur Triggerkonfiguration zu öffnen.
2. Klicken Sie auf ServiceNow-Trigger konfigurieren.
3. Gehen Sie auf der Seite Editor für Connector-Ereignistrigger so vor:
   1. Wenn Sie das zuvor konfigurierte Ereignisabo beibehalten möchten, klicken Sie auf Beibehalten oder auf Löschen.
      Warnung:Wenn Sie ein Ereignisabo löschen, wirkt sich das auf alle veröffentlichten Integrationen aus, für die das Ereignisabo verwendet wird. 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 zu Verbindung und Ereignisabo finden Sie im Triggerkonfigurationsbereich unter Ereignisabodetails.