Abonnieren Sie die Anforderung von Eintragsaktualisierungen

  • Freigeben Version: Yokohama
  • Aktualisiert 30. Januar 2025
  • 2 Minuten Lesedauer

    • Senden Sie das Ergebnis von jedem Gesundheits-Screening von MitarbeiternEingabeanforderung an ein Drittparteisystem durch Konfiguration eines Webhooks.

    Vorbereitungen

    Das Senden ausgehender Webhook-Aufrufe erfordert die folgenden Plugins.
    • ServiceNow IntegrationHub Laufzeit (com.glide.hub.integration.runtime)
    • Workflow-Studio Aktionsschritt – Nutzlastgenerator (com.Glide.Hub.action_STEP.Payload)
    • ServiceNow IntegrationHub Aktionsschritt – REST (com.Glide.Hub.action_STEP.Rest)
    Diese Plugins müssen über angefordert werden Now Support Servicekatalog. Anweisungen finden Sie unter Fordern Sie ein Plugin an .
    Wenn Sie den Webhook einrichten, sendet das System automatisch eine REST-Anforderung an einen Drittpartei-Endpunkt, wenn ein Mitarbeiter oder Besucher den Eintrag anfordert. Arbeiten Sie mit einem Administrator für das Drittparteisystem zusammen, um den richtigen Endpunkt zu bestimmen, der bereitgestellt werden soll.
    Hinweis:
    Der Webhook enthält keine Authentifizierungsheader in der Anforderung. Stellen Sie sicher, dass Sie einen Endpunkt angeben, der Abfrageparameter enthält, um die Anforderung zu authentifizieren.

    Um mehr über zu erfahren Gesundheits-Screening von MitarbeiternModul „Anforderungseintrag“, siehe Führen Sie einen Integritätsbildschirm für den Eintrag durch.

    Erforderliche Rolle: sn_imt_Core.admin oder admin

    Prozedur

    1. Navigieren zu Alle > Arbeitsschutzstatus des Mitarbeiters > Ausgehende Webhooksan.
    2. Klicken Sie in der Tabelle Webhook [sn_imt_core_webhook] auf Neu .
    3. Füllen Sie im Formular die Felder aus.
      Tabelle : 1. Webhook-Formular
      Feld Beschreibung
      Name Interner Bezeichner für den Drittpartei-Endpunkt.
      Ereignis Ereignis, das Sie abonnieren möchten. Optionen umfassen:
      • Mitarbeiter hat Eintrag angefordert : Sendet jedes Mal eine Aktualisierung, wenn ein Mitarbeiter einen Eintrag anfordert.
      • Besucher hat Zutritt angefordert : Sendet jedes Mal ein Update, wenn ein Besucher den Eintrag anfordert.
      Endpunkt Endpunkt, der gesendet werden soll Gesundheits-Screening von MitarbeiternAnforderungseintragsdaten an.
      Hinweis:
      Der Webhook enthält keine Authentifizierungsheader in der Anforderung. Stellen Sie sicher, dass Sie einen Endpunkt angeben, der Abfrageparameter enthält, um die Anforderung zu authentifizieren.
      Sichere Parameter Abfrageparameter für den Endpunkt, die sicher verarbeitet werden müssen, z. B. ein Autorisierungstoken. Geben Sie Parameter im Format an ?Param1=value&param2=othervalue .
      Tipp:
      Wenn das Drittparteisystem, an das Sie Daten senden, kein sicher generiertes Autorisierungstoken bereitstellt, können Sie ein Token in generieren ServiceNowInstanz mit dem folgenden Skript. 
      var secureRandom = GlideSecureRandomUtil;
var secret = secureRandom.getSecureRandomString(30);
gs.log(secret);
      Aktiv Option zum Festlegen des Datensatzes auf „aktiv“.
    4. Klicken Sie auf Absenden.

    Ergebnisse

    Die Gesundheits-Screening von MitarbeiternDie Anwendung sendet Anforderungseintragsdaten jedes Mal an den Drittpartei-Endpunkt, wenn ein Mitarbeiter den Eintrag anfordert. Die JSON-Nutzlast enthält die folgenden Daten. 
    {
  "event": "entry.requested",
  "email": "aileen.mottern@example.com",
  "username": "aileen.mottern",
  "user_id": "a8f98bb0eb32010045e1a5115206fe3a",
  "location": "San Antonio",
  "location_id": "108486c7c611227500b093211aa88dcc",
  "access_granted": false,
  "updated": "2020-07-01 22:19:03"
}
    Eigenschaft Beschreibung
    Ereignis Typ des in der Webhook-Tabelle definierten Ereignisses.

    Datentyp: Zeichenfolge
    E-Mail E-Mail-Adresse des Mitarbeiters.

    Datentyp: Zeichenfolge
    username Anwendername des Mitarbeiters aus der Tabelle „Arbeitsschutz-Anwender“ [sn_imt_core_health_and_safety_user].

    Datentyp: Zeichenfolge
    user_id SYS_ID des Anwenderdatensatzes aus der Tabelle „Arbeitsschutz-Anwender“ [sn_imt_core_health_and_safety_user].

    Datentyp: Zeichenfolge
    location Standort der Gesundheitsuntersuchung.

    Datentyp: Zeichenfolge
    Standort_ID SYS_ID des Standortdatensatzes aus der Tabelle „Standort“ [cmn_location].

    Datentyp: Zeichenfolge
    Access_granted Kennzeichnung, die angibt, ob dem Mitarbeiter aufgrund der Gesundheitsprüfung Zugriff gewährt wurde. Gültige Werte:
    • Wahr : Der Mitarbeiter hat die Gesundheitsprüfung bestanden und hat Zugriff gewährt.
    • Falsch : Der Mitarbeiter hat die Gesundheitsprüfung nicht bestanden und hat keinen Zugriff gewährt.

    Datentyp: Boolescher Wert
    aktualisiert Datum und Uhrzeit, zu der der Mitarbeiter oder Besucher den Eintritt angefordert hat.

    Datentyp: Datum/Uhrzeit