Obtenir les données de santé de l’employé ou du visiteur

Envoyez une demande GET pour les État de santé et de sécurité des employés données à utiliser dans votre système tiers. Obtenez des données pour déterminer l’état de santé actuel d’un employé ou d’un visiteur.

Avant de commencer

Rôle requis : sn_imt_core.reader

Procédure

Envoyez une demande GET à l’API de table sur votre instance.

Pour plus d’informations, consultez API de table.

1. Construisez le point de terminaison à l’aide de la table Utilisateur de Santé et sécurité [sn_imt_core_health_and_safety_user].

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

2. Ajoutez un paramètre de requête pour interroger l’adresse e-mail d’un utilisateur spécifique.

   Dans l’explorateur d’API, vous pouvez entrer l’une des chaînes suivantes dans le champ sysparm_query pour générer un point de terminaison qui inclut le paramètre de requête correct :

   • user.email=<adresse e-mail de l’utilisateur> : interroge l’adresse e-mail de l’employé fourni.
   • visitor.email=<adresse e-mail du visiteur> : interroge l’adresse e-mail du visiteur fourni.

   

Cet exemple de demande cURL interroge la table Utilisateur Santé et sécurité et renvoie les enregistrements associés à l’adresse e-mail d’Abel Tuter.

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'

Résultats

L’application État de santé et de sécurité des employés renvoie l’enregistrement de l’utilisateur Santé et sécurité associé à l’adresse e-mail dans la demande. La charge utile JSON contient les données suivantes.

{
  "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"
    }
  ]
}

Tous les champs sont internes, à l’exception des éléments suivants :

Propriété	Description
requirements_status	Si le visiteur ou l’employé a rempli toutes les exigences pour retourner sur le lieu de travail. Pour plus d'informations, consultez Créer des enregistrements d’utilisateurs Santé et sécurité et Créer un besoin en matière de santé et de sécurité. Validé : le visiteur ou l’employé a rempli toutes les conditions requises pour retourner sur le lieu de travail. Non validé : le visiteur ou l’employé n’a pas rempli toutes les exigences pour retourner sur le lieu de travail. Type de données : chaîne
visiteur	S’il est présent, cet enregistrement représente un visiteur et non un employé. Remarque : Utilisé uniquement lors du renvoi des données de santé des visiteurs. Type de données : objet
visitor.link	Lien vers l’enregistrement du visiteur sur l’instance. Remarque : Utilisé uniquement lors du renvoi des données de santé des visiteurs. Type de données : chaîne
visitor.value	Sys_id de l’enregistrement du visiteur. Remarque : Utilisé uniquement lors du renvoi des données de santé des visiteurs. Type de données : chaîne
utilisateur	S’il est présent, cet enregistrement représente un employé et non un visiteur. Remarque : Utilisé uniquement lors du renvoi des données de santé de l’employé. Type de données : objet
user.link	Lien vers l’enregistrement utilisateur sur l’instance. Remarque : Utilisé uniquement lors du renvoi des données de santé de l’employé. Type de données : chaîne
valeur.utilisateur	Sys_id de l’enregistrement utilisateur. Remarque : Utilisé uniquement lors du renvoi des données de santé de l’employé. Type de données : chaîne