Obtenha dados de saúde do funcionário ou visitante

Envie uma solicitação GET para Status de saúde e segurança do funcionário dados a serem usados em seu sistema de terceiros. Obtenha dados para determinar o status de integridade atual de um funcionário ou visitante.

Antes de Iniciar

Função necessária: sn_imt_core.reader

Procedimento

Envie uma solicitação GET para a API Tabela em sua instância.

Para obter mais informações, consulte API de tabela .

1. Construa o endpoint usando a tabela Usuário de integridade e segurança [sn_imt_core_health_and_safety_user].

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

2. Adicione um parâmetro de consulta para consultar o endereço de e-mail de um usuário específico.

   No gerenciador de API, você pode inserir uma das seguintes cadeias de caracteres no sysparm_query campo para gerar um endpoint que inclui o parâmetro de consulta correto:

   • user.email: <user-email-address> : Consulta o endereço de e-mail do funcionário fornecido.
   • e-mail do visitante: <visitor-email-address> : Consulta o endereço de e-mail do visitante fornecido.

   

Este exemplo de solicitação cURL consulta a tabela Usuário de integridade e segurança e retorna registros associados ao endereço de e-mail de 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'

Resultado

. Status de saúde e segurança do funcionário A aplicação retorna o registro do usuário de saúde e segurança associado ao endereço de e-mail na solicitação. A carga JSON contém os seguintes dados.

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

Todos os campos são internos, exceto o seguinte:

Propriedade	Descrição
requirements_status	Se o visitante ou funcionário concluiu todos os requisitos para retornar ao local de trabalho. Para obter mais informações, consulte Criar registros de usuário de saúde e segurança e Crie um requisito de saúde e segurança. Apagado: O visitante ou funcionário concluiu todos os requisitos para retornar ao local de trabalho. Não limpo: O visitante ou funcionário não concluiu todos os requisitos para retornar ao local de trabalho. Tipo de dados: Cadeia de caracteres
visitante	Se presente, este registro representa um visitante em vez de um funcionário. Nota: Usado somente ao retornar dados de integridade do visitante. Tipo de dados: Objeto
visitor.link	Link para o registro do visitante na instância. Nota: Usado somente ao retornar dados de integridade do visitante. Tipo de dados: Cadeia de caracteres
valor.visitor	Sys_id do registro do visitante. Nota: Usado somente ao retornar dados de integridade do visitante. Tipo de dados: Cadeia de caracteres
usuário	Se presente, este registro representa um funcionário em vez de um visitante. Nota: Usado somente ao retornar dados de saúde do funcionário. Tipo de dados: Objeto
user.link	Link para o registro do usuário na instância. Nota: Usado somente ao retornar dados de saúde do funcionário. Tipo de dados: Cadeia de caracteres
user.value	Sys_id do registro do usuário. Nota: Usado somente ao retornar dados de saúde do funcionário. Tipo de dados: Cadeia de caracteres