Aktualisierungen von Zutrittsanforderungen abonnieren

  • Freigeben Version: Xanadu
  • Aktualisiert 1. August 2024
  • 2 Minuten Lesedauer

    • Senden Sie das Ergebnis jeder Gesundheits-Screening von Mitarbeitern-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)
    • Workflow-Studio 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 hierzu finden Sie unter Plugin 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 Gesundheits-Screening von Mitarbeitern finden Sie unter Führen Sie einen Gesundheitsbildschirm für die Eingabe 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 Gesundheits-Screening von Mitarbeitern-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 Gesundheits-Screening von Mitarbeitern 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