Gesundheitsdaten von Mitarbeitern oder Besuchern abrufen

Senden Sie eine GET-Anforderung für Arbeitsschutzstatus des Mitarbeiters-Daten zur Verwendung in Ihrem Drittanbietersystem. Rufen Sie Daten ab, um den aktuellen Gesundheitsstatus eines Mitarbeiters oder Besuchers zu bestimmen.

Vorbereitungen

Erforderliche Rolle: sn_imt_core.reader

Prozedur

Senden Sie eine GET-Anforderung an die Tabellen-API für Ihre Instanz.

Weitere Informationen finden Sie unter Tabellen-API.

1. Konstruieren Sie den Endpunkt mithilfe der Tabelle der Health and Safety-Anwender [sn_imt_core_health_and_safety_user].

   https://<your-instance>.servicenow.com/api/now/table/sn_imt_core_health_and_safety_user

2. Fügen Sie einen Abfrageparameter hinzu, um die E-Mail-Adresse eines bestimmten Benutzers abzufragen.

   Im API-Explorer können Sie eine der folgenden Zeichenfolgen im Feld sysparm_query eingeben, um einen Endpunkt zu generieren, der den richtigen Abfrageparameter enthält:

   • user.email = <user-email-address>: Fragt die E-Mail-Adresse des angegebenen Mitarbeiters ab
   • visitor.email=<visitor-email-address>: Fragt die E-Mail-Adresse des angegebenen Besuchers ab

   

Diese Beispiel-cURL-Anforderung fragt die Tabelle der Health and Safety-Anwender ab und gibt Datensätze zurück, die der E-Mail-Adresse von Abel Tuter zugeordnet sind.

curl "http://<your-instance>.servicenow.com/api/now/table/sn_imt_core_health_and_safety_user?sysparm_query=user.email%3Dabel.tuter%40example.com&sysparm_limit=1" \
--request GET \
--header "Accept:application/json" \
--user 'username':'password'

Ergebnisse

Die Anwendung Arbeitsschutzstatus des Mitarbeiters gibt den Datensatz des Health and Safety-Anwenders zurück, der der E-Mail-Adresse in der Anforderung zugeordnet ist. Die JSON-Nutzlast enthält die folgenden Daten.

{
  "result": [
    {
      "sys_mod_count": "0",
      "sys_updated_on": "2020-07-14 19:58:00",
      "sys_tags": "",
      "type": "employee",
      "sys_id": "33f184491bce9010e3730e16ec4bcb71",
      "sys_updated_by": "system.administrator",
      "manually_created": "true",
      "sys_created_on": "2020-07-14 19:58:00",
      "sys_domain": {
        "link": "https://<my-instance>.servicenow.com/api/now/table/sys_user_group/global",
        "value": "global"
      },
      "requirements_status": "cleared",
      "visitor": "",
      "user": {
        "link": "https://<my-instance>.servicenow.com/api/now/table/sys_user/62826bf03710200044e0bfc8bcbe5df1",
        "value": "62826bf03710200044e0bfc8bcbe5df1"
      },
      "sys_created_by": "system.administrator"
    }
  ]
}

Alle Felder sind intern, mit Ausnahme der folgenden:

Eigenschaft	Beschreibung
requirements_status	Legt fest, ob der Besucher oder Mitarbeiter alle Anforderungen für die Rückkehr zum Arbeitsplatz erfüllt hat. Weitere Informationen finden Sie unter Datensätze für Arbeitsschutzanwender erstellen und Arbeitsschutzanforderung erstellen.. Freigegeben: Der Besucher oder Mitarbeiter hat alle Anforderungen für die Rückkehr zum Arbeitsplatz erfüllt. Nicht freigegeben: Der Besucher oder Mitarbeiter hat nicht alle Anforderungen für die Rückkehr zum Arbeitsplatz erfüllt. Datentyp: Zeichenfolge
visitor	Wenn vorhanden, stellt dieser Datensatz einen Besucher anstelle eines Mitarbeiters dar. Hinweis: Wird nur verwendet, wenn Gesundheitsdaten von Besuchern zurückgegeben werden. Datentyp: Objekt
visitor.link	Link zum Besucherdatensatz in der Instanz Hinweis: Wird nur verwendet, wenn Gesundheitsdaten von Besuchern zurückgegeben werden. Datentyp: Zeichenfolge
visitor.value	Sys_id des Besucherdatensatzes Hinweis: Wird nur verwendet, wenn Gesundheitsdaten von Besuchern zurückgegeben werden. Datentyp: Zeichenfolge
user	Wenn vorhanden, stellt dieser Datensatz einen Mitarbeiter anstelle eines Besuchers dar. Hinweis: Wird nur verwendet, wenn Gesundheitsdaten von Mitarbeitern zurückgegeben werden. Datentyp: Objekt
user.link	Link zum Benutzerdatensatz in der Instanz Hinweis: Wird nur verwendet, wenn Gesundheitsdaten von Mitarbeitern zurückgegeben werden. Datentyp: Zeichenfolge
user.value	Sys_id des Benutzerdatensatzes Hinweis: Wird nur verwendet, wenn Gesundheitsdaten von Mitarbeitern zurückgegeben werden. Datentyp: Zeichenfolge