Erstellen Sie einen gespeicherten externen Auslöser

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer
  • Speichern Sie eine Reihe von Auslöserdefinitionen als wiederverwendbaren Auslöser, der über Webhooks auf ein externes Ereignis reagiert. Wenn in der konfigurierten Drittanbieteranwendung ein Ereignis auftritt, das die angegebenen Bedingungen erfüllt, wird der Auslöser aktiviert.

    Warum und wann dieser Vorgang ausgeführt wird

    Erstellen Sie einen gespeicherten Auslöser, der auf Ereignisse reagiert, die in einer unterstützten Drittanbieter-Spoke auftreten, die bereits in Workflow-Studiokonfiguriert ist. Die Drittanbieter-Spoke sendet die Ereignisnutzlast jedes Mal an Workflow-Studio, wenn ein Ereignis auftritt. Geben Sie in der Auslöserdefinition die Ereignisnutzlast im JSON-Format und die Bedingungen zum Starten des Auslösers an. Rufen Sie die Ereignis-Nutzlast-JSON von der Drittpartei-Spoke ab, die Sie konfigurieren.

    Vorbereitungen

    Erforderliche Rolle: trigger_designer, flow_designer oder admin

    Abonnement erforderlich: Dieser Schritt erfordert ein Integration Hub-Abonnement.

    Erforderliche Plugins: Installieren Sie die folgenden Integration Hub-Plugins:
    • Externer Auslöser von ServiceNow Integration Hub [com.glide.ih.external_trigger]: Zur Verwendung sofort einsatzbereiter externer Auslöser.

    • Builder für externe Auslöser [sn_ext_trg_bldr]: Zum Erstellen eines gespeicherten externen Auslösers.

    Hinweis:
    Informationen dazu, was in verschiedenen Integration Hub-Abonnements enthalten ist, finden Sie unter Gesetzliche Zeitpläne − Integration Hub − Übersicht
    Stellen Sie sicher, dass Sie die Endpunkte der externen Auslöser für die Spoke der Drittparteianwendung konfiguriert haben. Folgende Spokes werden unterstützt:
    • Jira-Spoke
    • GitHub-Spoke
    • Docusign eSignature-Spoke
    Weitere Informationen zum Konfigurieren der Drittanbieter-Spoke finden Sie unter Set up external trigger endpoints.
    Wichtig:
    Halten Sie die Ereignisnutzlast-JSON der Drittparteianwendung bereit. In der Webhook-Dokumentation der Drittpartei erfahren Sie, woher Sie die Nutzlast-JSON kopieren können. Betrachten Sie beispielsweise den folgenden Link, der verschiedene Nutzlastformen für Jira-Ereignisse zeigt: Webhook wird ausgeführt.

    Prozedur

    1. Navigieren zu Alle > Prozessautomatisierung > Workflow-Studio.
    2. Wählen Sie auf der Workflow-Studio-Homepage die Option aus Neu > Auslöser.
    3. Füllen Sie die Felder des Formulars aus.
      Tabelle : 1. Formular „Neuer Auslöser“.
      Feld Beschreibung
      Auslösername Name zur Identifizierung des Auslösers.
      Auslösertyp Der Typ des Auslösers zum Starten Ihres Flows. Wählen Sie unter Extern die Option Ereignis (Webhook)aus.
      Beschreibung Beschreibung des Auslösers.
      Anwendung Anwendungsbereich zum Erstellen des Auslösers. Workflow-Studio zeigt die konfigurierten Spokes an, die unterstützt werden.
    4. Wählen Sie Zusätzliche Eigenschaften anzeigen und füllen Sie die Felder aus.
      Tabelle : 2. Formular „Zusätzliche Eigenschaften“.
      Feld Beschreibung
      Zugänglich von Auf die Auslöserdaten kann von allen Anwendungsbereichen aus zugegriffen werden.
      Kategorie Die Kategorie, in der Ihr Auslöser angezeigt wird.
      Auslöseranmerkung Anmerkung für Ihren Auslöser, die der Anwender sehen kann, bevor er den Auslöser auswählt.
    5. Wählen Sie Build trigger (Auslöser erstellen).
      Workflow-Studio zeigt die Seite „Auslöserdefinition“ an. Im Vorschaubereich Ereignisquelle können Sie Informationen zur Konfiguration des externen Auslöserendpunkts anzeigen.
    6. Füllen Sie die Felder unter Parseraus.
      Tabelle : 3. Parser-Formular
      Feld Beschreibung
      Auslöser-Ausgabename Bezeichnung zur Identifizierung der Auslöserausgabe.
      Anforderungskopfzeilen. Optionales Feld zum Angeben eines oder mehrerer Header, die in die eingehende Anforderung aufgenommen werden sollen.
      Abfrageparameter Optionales Feld zum Angeben eines oder mehrerer Parameter, die in die eingehende Anforderung aufgenommen werden sollen.
    7. Fügen Sie unter Textkörperim JSON-Editordie Nutzlast-JSON aus der Drittanbieteranwendung ein.
      In der Webhook-Dokumentation der Drittpartei erfahren Sie, woher Sie die Nutzlast-JSON kopieren können. Zeigt den JSON-Editor an, in den Sie die Nutzlastdaten in JSON einfügen.
    8. Wählen Sie Objekte visualisierenaus.
      Der Editor zeigt die Objekte an, die sich in der Nutzlast-JSON befinden. Sie können die Objekte neu anordnen oder entfernen. Die Objekte sind als Datenpillen zur Verwendung in Bedingungen verfügbar. Zeigt die Objekte an, nachdem Sie Objekte visualisieren ausgewählt haben.
    9. Ziehen Sie im Bedingungseditordie Datenpillen per Drag-and-Drop, um einen Bedingungssatz zu erstellen.
      Verwenden Sie die Operatoren [or] oder [and], um dem Bedingungssatz weitere Bedingungen hinzuzufügen. Beispiel für einen Datenpillenwert in einer Bedingung.
    10. Wählen Sie +Neuer Bedingungssatz aus, um zusätzliche Bedingungssätze gemäß Ihren Anforderungen hinzuzufügen.
    11. Wählen Sie Veröffentlichen aus, um den Auslöser für andere verfügbar zu machen.
      Hinweis:
      Sie können einen gespeicherten externen Auslöser nach der Veröffentlichung nicht bearbeiten.