Obtenir des données de santé sur les employés ou les visiteurs
Envoyez une demande GET pour les données État de santé et de sécurité des employés à utiliser dans votre système tiers. Accédez à des données pour déterminer l'état de santé actuel d'un employé ou d'un visiteur.
Avant de commencer
Procédure
Envoyez une demande GET à l'API de table sur votre instance.
Pour plus d’informations, consultez API de table.
-
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 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=<user-email-address>: interroge l'adresse e-mail de l'employé fournie.
- visitor.email=<visitor-email-address>: interroge l'adresse e-mail du visiteur fournie.
Cet exemple de demande cURL interroge la table Utilisateur Health and Safety 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
{
"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 | Indique si le visiteur ou l'employé a rempli toutes les exigences pour revenir au travail. Pour en savoir plus, voir Créer des enregistrements d'utilisateurs de santé et de sécurité et Créer une exigence en matière de santé et de sécurité.
Type de données : chaîne |
| visiteur | S'il est présent, cet enregistrement représente un visiteur au lieu d'un employé. Remarque : Utilisé uniquement lors du renvoi des données de santé du visiteur. 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é du visiteur. 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é du visiteur. Type de données : chaîne |
| utilisateur | S'il est présent, cet enregistrement représente un employé au lieu d'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 de l'utilisateur sur l'instance. Remarque : Utilisé uniquement lors du renvoi des données de santé de l'employé. Type de données : chaîne |
| user.value | Sys_id de l'enregistrement de l'utilisateur. Remarque : Utilisé uniquement lors du renvoi des données de santé de l'employé. Type de données : chaîne |