Assinar a solicitação de atualizações de entrada

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

    • Envie o resultado de cada solicitação de entrada Employee Health Screening 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 IntegrationHub Tempo de execução (com.glide.hub.integration.runtime)
    • Flow Designer Etapa de ação - Construtor de carga (com.glide.hub.action_step.payload)
    • ServiceNow IntegrationHub 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 a 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 Employee Health Screening Solicitar Entrada, consulte Realizar uma triagem de integridade para entrada na triagem de.

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

    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 entrada.
      Endpoint Endpoint para o qual enviar os dados de entrada de solicitação Employee Health Screening.
      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 devem ser tratados 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 Employee Health Screening 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 Webhook.

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

    Tipo de dados: cadeia de caracteres
    username 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 do local da tabela Local [cmn_location].

    Tipo de dados: cadeia de caracteres
    access_granted Sinalizador que indica se o funcionário obteve acesso como resultado do exame de saúde. Valores válidos:
    • true: o funcionário foi aprovado na triagem de saúde e recebeu acesso.
    • false: o funcionário não passou na triagem de saúde e não teve acesso.

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

    Tipo de dados: data/hora