Obter dados de saúde de funcionários ou visitantes

  • Versão de lançamento: Washingtondc
  • Atualizado 1 de fev. de 2024
  • 2 min. de leitura
  • Envie uma solicitação GET para Status de saúde e segurança do funcionário dados para usar em seu sistema de terceiros. Obtenha dados para determinar o estado de saúde 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 da tabela na sua instância.
    Para obter mais informações, consulte API da tabela.
    1. Construa o endpoint usando a tabela Usuário de Saúde 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 explorador de APIs, você pode inserir uma das seguintes cadeias de caracteres no campo sysparm_query para gerar um endpoint que inclua o parâmetro de consulta correto:

      • usuário.e-mail=<user-email-address> : consulta o endereço de e-mail do funcionário fornecido.
      • visitante.e-mail=<visitor-email-address> : consulta o endereço de e-mail do visitante fornecido.
      Exemplo de valor de sysparm_query para consultar o endereço de e-mail de um usuário específico.
    Este exemplo de solicitação cURL consulta a tabela Usuário de Saúde 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

    A aplicação Status de saúde e segurança do funcionário 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 dados a seguir.
    {
      "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
    requisitos_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 Criar um requisito de saúde e segurança.
    • Desmarcado: o visitante ou funcionário concluiu todos os requisitos para retornar ao local de trabalho.
    • Não liberado: 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 saúde do visitante.

    Tipo de dados: objeto

    visitante.link Link para o registro do visitante na instância.
    Nota:
    Usado somente ao retornar dados de saúde do visitante.

    Tipo de dados: cadeia de caracteres

    visitante.valor Sys_id do registro do visitante.
    Nota:
    Usado somente ao retornar dados de saúde 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

    usuário.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

    valor.usuário 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