Rufen Sie Gesundheitsdaten von Mitarbeitern oder Besuchern ab

  • Freigeben Version: Australia
  • Aktualisiert 12. März 2026
  • 2 Minuten Lesedauer

    • Senden Sie eine GET-Anforderung für Arbeitsschutzstatus des Mitarbeiters Daten, die in Ihrem Drittparteisystem verwendet werden sollen. 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 in Ihrer Instanz.
    Weitere Informationen finden Sie unter Tabellen-API .
    1. Erstellen Sie den Endpunkt mithilfe der Tabelle „Arbeitsschutz-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 Anwenders abzufragen.

      Im API-Explorer können Sie eine der folgenden Zeichenfolgen in eingeben Sysparm_query Feld zum Generieren eines Endpunkts, 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.
      Beispiel für „sysparm_query“-Wert zum Abfragen der E-Mail-Adresse eines bestimmten Anwenders.
    In dieser Beispiel-Curl-Anforderung wird die Arbeitsschutz-Anwendertabelle abgefragt und Datensätze zurückgegeben, 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 Arbeitsschutzstatus des Mitarbeiters Die Anwendung gibt den Arbeitsschutz-Anwenderdatensatz 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 Gibt an, ob der Besucher oder Mitarbeiter alle Anforderungen für die Rückkehr an den Arbeitsplatz erfüllt hat. Weitere Informationen finden Sie unter Erstellen Sie Arbeitsschutz-Anwenderdatensätze und Erstellen Sie eine Arbeitsschutzanforderung.
    • Gelöscht: Der Besucher oder Mitarbeiter hat alle Anforderungen für die Rückkehr an den Arbeitsplatz erfüllt.
    • Nicht gelöscht: Der Besucher oder Mitarbeiter hat nicht alle Anforderungen für die Rückkehr an den Arbeitsplatz erfüllt.

    Datentyp: Zeichenfolge
    Besucher Wenn vorhanden, stellt dieser Datensatz einen Besucher anstelle eines Mitarbeiters dar.
    Hinweis:
    Wird nur verwendet, wenn Gesundheitsdaten des Besuchers zurückgegeben werden.

    Datentyp: Objekt
    Visitor.Link Link zum Besucherdatensatz in der Instanz.
    Hinweis:
    Wird nur verwendet, wenn Gesundheitsdaten des Besuchers zurückgegeben werden.

    Datentyp: Zeichenfolge
    Besucher.Wert SYS_ID des Besucherdatensatzes.
    Hinweis:
    Wird nur verwendet, wenn Gesundheitsdaten des Besuchers zurückgegeben werden.

    Datentyp: Zeichenfolge
    Anwender Wenn vorhanden, stellt dieser Datensatz einen Mitarbeiter anstelle eines Besuchers dar.
    Hinweis:
    Wird nur verwendet, wenn Gesundheitsdaten von Mitarbeitern zurückgegeben werden.

    Datentyp: Objekt
    Anwender.Link Link zum Anwenderdatensatz in der Instanz.
    Hinweis:
    Wird nur verwendet, wenn Gesundheitsdaten von Mitarbeitern zurückgegeben werden.

    Datentyp: Zeichenfolge
    Anwender.Wert SYS_ID des Anwenderdatensatzes.
    Hinweis:
    Wird nur verwendet, wenn Gesundheitsdaten von Mitarbeitern zurückgegeben werden.

    Datentyp: Zeichenfolge