Assinar para solicitar atualizações de entrada

  • Versão de lançamento: Xanadu
  • Atualizado 1 de ago. de 2024
  • 2 min. de leitura

    • Envie o resultado de cada solicitação de entrada Avaliação de saúde do funcionário para um sistema de terceiros configurando um webhook.

    Antes de Iniciar

    O envio de chamadas de webhook de saída requer os plug-ins a seguir.
    • ServiceNow Integration Hub Tempo de execução (com.glide.hub.integration.runtime)
    • Workflow Studio Etapa de ação - Construtor de carga (com.glide.hub.action_step.payload)
    • ServiceNow Integration Hub Etapa de ação - REST (com.glide.hub.action_step.rest)
    Esses plug-ins devem ser solicitados por meio de Now Support Catálogo de serviços. Para obter instruções, consulte Solicitar um plug-in.
    Quando você configura o webhook, o sistema envia automaticamente uma solicitação REST para um endpoint de terceiros sempre que um funcionário ou visitante solicita uma entrada. Trabalhe com um administrador do sistema de terceiros para determinar o endpoint correto a ser fornecido.
    Nota:
    O webhook não inclui cabeçalhos de autenticação na solicitação. Certifique-se de fornecer um endpoint que inclua parâmetros de consulta para autenticar a solicitação.

    Para saber mais sobre o módulo Avaliação de saúde do funcionário de entrada de solicitação, consulte Conduzir uma tela de integridade para entrada.

    Função necessária: sn_imt_core.admin ou administrador

    Procedimento

    1. Navegar até Todos > Status de saúde e segurança do funcionário > Webhooks de saída.
    2. Na tabela Webhook [sn_imt_core_webhook], clique em Novo.
    3. No formulário, preencha os campos.
      Tabela 1. Formulário de webhook
      Campo Descrição
      Nome Identificador interno do endpoint de terceiros.
      Evento Evento que você deseja assinar. As opções incluem:
      • Entrada solicitada pelo funcionário: envia uma atualização sempre que um funcionário solicita uma entrada.
      • Entrada solicitada pelo visitante: envia uma atualização sempre que um visitante solicita uma entrada.
      Endpoint Endpoint para o qual os dados de entrada de solicitação Avaliação de saúde do funcionário serão enviados.
      Nota:
      O webhook não inclui cabeçalhos de autenticação na solicitação. Certifique-se de fornecer um endpoint que inclua parâmetros de consulta para autenticar a solicitação.
      Parâmetros de segurança Parâmetros de consulta para o endpoint que deve ser tratado com segurança, como um token de autorização. Forneça parâmetros no formato ?param1=value–m2=othervalue.
      Dica:
      Se o sistema de terceiros para o qual você está enviando dados não fornecer um token de autorização gerado com segurança, você poderá gerar um token em sua instância ServiceNow com o script a seguir. 
      var secureRandom = GlideSecureRandomUtil;
var secret = secureRandom.getSecureRandomString(30);
gs.log(secret);
      Ativo Opção para definir o registro como ativo.
    4. Clique em Enviar.

    Resultado

    A aplicação Avaliação de saúde do funcionário envia dados de entrada de solicitação para o endpoint de terceiros sempre que um funcionário solicita entrada. A carga JSON contém os dados a seguir. 
    {
  "event": "entry.requested",
  "email": "aileen.mottern@example.com",
  "username": "aileen.mottern",
  "user_id": "a8f98bb0eb32010045e1a5115206fe3a",
  "location": "San Antonio",
  "location_id": "108486c7c611227500b093211aa88dcc",
  "access_granted": false,
  "updated": "2020-07-01 22:19:03"
}
    Propriedade Descrição
    evento Tipo de evento definido na tabela do Webhook.

    Tipo de dados: cadeia de caracteres
    e-mail Endereço de e-mail do funcionário.

    Tipo de dados: cadeia de caracteres
    nome do usuário Nome de usuário do funcionário da tabela Usuários de Saúde e segurança [sn_imt_core_health_and_safety_user].

    Tipo de dados: cadeia de caracteres
    user_id Sys_id do registro do usuário da tabela Usuários de Saúde e segurança [sn_imt_core_health_and_safety_user].

    Tipo de dados: cadeia de caracteres
    local Local do exame de saúde.

    Tipo de dados: cadeia de caracteres
    location_id Sys_id do registro de local da tabela Local [cmn_location].

    Tipo de dados: cadeia de caracteres
    acesso_concedido Sinalizador que indica se o funcionário teve acesso concedido como resultado da triagem de integridade. Valores válidos:
    • true: o funcionário foi aprovado na triagem de integridade e teve acesso concedido.
    • false: o funcionário não passou na triagem de integridade e não teve acesso concedido.

    Tipo de dados: booliano
    atualizado Data e hora em que o funcionário ou visitante solicitou a entrada.

    Tipo de dados: data/hora