Aktualisierungen von Zutrittsanforderungen abonnieren

  • Freigeben Version: Washingtondc
  • Aktualisiert 1. Februar 2024
  • 2 Minuten Lesedauer

    • Senden Sie das Ergebnis jeder Employee Health Screening-Eingabeanforderung an ein Drittanbietersystem, indem Sie einen Webhook konfigurieren.

    Vorbereitungen

    Zum Senden ausgehender Webhook-Aufrufe sind die folgenden Plugins erforderlich.
    • ServiceNow IntegrationHub Runtime (com.glide.hub.integration.runtime)
    • Flow Designer Action Step - Payload Builder (com.glide.hub.action_step.payload)
    • ServiceNow IntegrationHub Action Step - REST (com.glide.hub.action_step.rest)
    Diese Plugins müssen über Now Support Servicekatalog angefordert werden. Anweisungen finden Sie unter Plugins anfordern.
    Wenn Sie den Webhook einrichten, sendet das System automatisch eine REST-Anforderung an einen Drittanbieterendpunkt, wenn ein Mitarbeiter oder Besucher den Zutritt anfordert. Arbeiten Sie mit einem Administrator des Drittanbietersystems zusammen, um den richtigen Endpunkt festzulegen.
    Hinweis:
    Der WebHook enthält keine Authentifizierungsheader in der Anforderung. Stellen Sie sicher, dass Sie einen Endpunkt mit Abfrageparametern zur Authentifizierung der Anforderung bereitstellen.

    Weitere Informationen zum Zutrittsanforderungsmodul von Employee Health Screening finden Sie unter Führen Sie ein Gesundheitsscreening für den Zutritt durch..

    Erforderliche Rolle: sn_imt_core.admin oder admin

    Prozedur

    1. Navigieren zu Alle > Arbeitsschutzstatus des Mitarbeiters > Ausgehende Webhooks.
    2. Klicken Sie in der Webhook-Tabelle [sn_imt_core_webhook] auf Neu.
    3. Füllen Sie die Felder im Formular aus.
      Tabelle : 1. Webhook-Formular
      Feld Beschreibung
      Name Interner Bezeichner für den Drittanbieterendpunkt
      Event Event, das Sie abonnieren möchten. Verfügbare Optionen:
      • Zutrittsanforderung durch Mitarbeiter: Sendet jedes Mal eine Aktualisierung, wenn ein Mitarbeiter den Zutritt anfordert
      • Besucherzutrittsanforderungen: Sendet jedes Mal eine Aktualisierung, wenn ein Besucher den Zutritt anfordert
      Endpunkt Endpunkt, an den die Employee Health Screening-Zutrittsanforderungsdaten gesendet werden sollen
      Hinweis:
      Der WebHook enthält keine Authentifizierungsheader in der Anforderung. Stellen Sie sicher, dass Sie einen Endpunkt mit Abfrageparametern zur Authentifizierung der Anforderung bereitstellen.
      Sichere Parameter Abfrageparameter für den Endpunkt, die sicher behandelt werden müssen, z. B. ein Autorisierungstoken. Geben Sie Parameter im Format ?param1=value&param2=othervalue ein.
      Tipp:
      Wenn vom Drittanbietersystem, an das Sie Daten senden, kein sicher generiertes Autorisierungstoken bereitgestellt wird, können Sie ein Token in Ihrer ServiceNow-Instanz mit dem folgenden Skript generieren. 
      var secureRandom = GlideSecureRandomUtil;
var secret = secureRandom.getSecureRandomString(30);
gs.log(secret);
      Aktiv Option zum Aktivieren des Datensatzes
    4. Klicken Sie auf Absenden.

    Ergebnisse

    Die Anwendung Employee Health Screening sendet Zutrittsanforderungsdaten jedes Mal an den Drittanbieterendpunkt, wenn ein Mitarbeiter den Zutritt 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
    event Typ des Events, das in der Webhook-Tabelle definiert ist.

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

    Datentyp: Zeichenfolge
    Benutzername Benutzername des Mitarbeiters aus der Tabelle der Health and Safety-Anwender [sn_imt_core_health_and_safety_user]

    Datentyp: Zeichenfolge
    user_id Sys_id des Benutzerdatensatzes aus der Tabelle der Health and Safety-Anwender [sn_imt_core_health_and_safety_user].

    Datentyp: Zeichenfolge
    location Speicherort der Gesundheitsprüfung.

    Datentyp: Zeichenfolge
    location_id Sys_id des Standortdatensatzes aus der Standorttabelle [cmn_location]

    Datentyp: Zeichenfolge
    access_granted Kennzeichnung, die angibt, ob dem Mitarbeiter aufgrund der Gesundheitsprüfung Zutritt gewährt wurde. Gültige Werte:
    • true: Der Mitarbeiter hat die Gesundheitsprüfung bestanden und Zutritt erhalten.
    • false: Der Mitarbeiter hat die Gesundheitsprüfung nicht bestanden und keinen Zutritt erhalten.

    Datentyp: Boolesch
    aktualisiert Datum und Uhrzeit, zu der der Mitarbeiter oder Besucher den Zutritt angefordert hat.

    Datentyp: Datum/Uhrzeit