Configurar um evento de webhook
Configure um evento de API de webhook na tabela de configuração do provedor para permitir que os fornecedores de crachá compartilhem os dados de crachá coletados de tabelas de crachá usando o evento de webhook.
Antes de Iniciar
Função necessária: sn_wsd_wc.admin
Por Que e Quando Desempenhar Esta Tarefa
Os dados de crachá (JSON) são processados usando o ServiceNow Rest API Explorer. Um ou vários registros de dados de crachá brutos (carga útil) podem ser compartilhados e processados usando o explorador de REST API. O evento de webhook para dados de crachá é carregado na tabela Eventos do conector em um ou vários registros JSON. Vários registros são enviados como uma matriz. Para obter mais informações, consulte Análise de participação.
Procedimento
- Navegar até Tudo > Conectores do Workplace > Configurações do conector do provedor.
-
Selecione Criar novo.
No formulário, preencha os campos.
Tabela 1. Formulário de configuração do conector do provedor Campo Descrição Nome Nome da configuração do provedor. Configuração do Conector Opção para pesquisar e selecionar o ícone da lista de pesquisa ( ) para selecionar Crachá.
Para obter mais informações, consulte Definir configuração do conector para dados de crachá.
Tipo de Origem Origem de onde os dados de crachá são coletados e carregados na tabela de dados de crachá de destino. Selecione Webhook para configurar o evento de webhook.
Nome do parâmetro do token O nome do parâmetro do token e o valor do token são um par de chave-valor secreto, que é usado para autenticar a chamada de API do sistema de crachá do fornecedor para a aplicação Conectores para local de trabalho. Ambos os sistemas têm o valor do nome do token. Usando o nome do token, a aplicação autentica a solicitação de API.
Valor do token O valor do token é a chave secreta usada pelo fornecedor de crachá ao chamar o evento de API para permitir que o servidor autentique a solicitação de API. Ativo Opção para indicar que a configuração do provedor está Ativa. URL do Retorno de Chamada Opção para selecionar o ícone da URL de retorno de chamada ( ) para bloquear ou editar a URL de retorno de chamada.
Local de atualização automática Opção para atualizar automaticamente os locais quando espaços são adicionados ou quando alguns espaços são removidos de um local selecionado. Os registros de mapeamento de espaço do provedor de atualização de trabalho programado são executados diariamente e leem o campo Local de atualização automática na tabela Configuração do conector do provedor. Ele lê todos os registros nos registros de configuração do conector do provedor e atualiza a tabela Mapeamento do espaço do provedor com os dados mais recentes. Por exemplo, se um novo piso ou um espaço for adicionado a um local, eles serão adicionados automaticamente a um local selecionado.
Métricas Opção para selecionar o registro de destino para métricas compatíveis. Selecione Dados do evento. - Selecione Atualizar.
-
Selecione o evento de webhook recém-criado.
O botão Gerar URL de retorno de chamada está disponível para gerar uma URL de retorno de chamada para a solicitação de REST API.
- Como fornecedor de crachá, compartilhe os dados de crachá no formato JSON navegando até Tudo > Serviços web do sistema > REST > Explorador de REST API.
-
Na página Explorador de REST API, selecione o seguinte:
- Namespace: na lista suspensa, selecione sn_wsd_wc
- Nome da API: Webhook do conector do local de trabalho
- Versão da API: v1
-
Na página do evento do Webhook do conector do local de trabalho, forneça os seguintes valores:
- token_name: nome do parâmetro de token usado na etapa 2. O valor do nome do token é usado por fornecedores de crachá para compartilhar os dados de crachá (JSON) com Conectores para local de trabalho. Os dados brutos (dados de carga ou crachá) são processados e carregados na tabela Eventos do conector.
- ni.nolog.id: copie e cole o ID do sistema do webhook criado na etapa 2. Selecione o ícone do menu de ações adicionais (
) no painel.
- token_value: valor de token fornecido na etapa 2. O valor de token é a chave secreta usada pelo fornecedor de crachá ao chamar o evento de API para permitir que o servidor autentique a solicitação de API.
-
No corpo da solicitação de API, selecione Bruto e copie os dados de crachá (carga) no formato JSON.
Esses dados de crachá são coletados de sensores de crachá.
-
Selecione "Enviar".
Se o Código de resposta for 200 OK e o resultado da resposta for Success, os dados de crachá serão carregados na tabela Eventos do conector.
- A tabela Eventos do conector (sn_wsd_wc_connector_events) carrega os dados de crachá compartilhados por fornecedores de crachá. O estado dos dados de crachá é Novo quando são carregados pelo Explorador de REST API.
- Os registros de dados do provedor de webhook do Processo de trabalho programado são executados a cada minuto para carregar os dados de crachá da tabela Eventos do conector (dados com o Estado Novo) para a tabela Dados de participação do funcionário.
O trabalho agendado usa os dados de origem do evento do Webhook para transformar os dados no formato necessário e, em seguida, colocá-los na tabela de dados de participação do funcionário de destino.Nota:Para acessar os Conectores para local de trabalho trabalhos agendados, navegue até Tudo > Definição do Sistema > Trabalhos programados. Pesquise conectores de local de trabalho na coluna Aplicação. Dois trabalhos agendados estão disponíveis para Conectores para local de trabalho.- Registros de dados do provedor de processo: lê dados de dados de crachá do fornecedor (tabela de origem). Depois de processar os dados de crachá, o registro os carrega na tabela Dados de participação do funcionário (tabela de destino). Para obter mais informações, consulte Configurar dados da tabela de crachá.
- Processar registros de dados do provedor de webhook: lê dados da tabela Eventos do conector. Processa os dados de evento do webhook e os carrega na tabela Dados de participação do funcionário (tabela de destino).
- Os dados são carregados na tabela Dados de participação do funcionário. O estado dos dados de crachá na tabela Eventos do conector muda para Processado.
- Na tabela Dados de participação do funcionário, os dados são carregados na tabela Análise de participação.Nota:Os registros de dados de crachá na tabela Eventos do conector com o estado Processado são limpos após dois dias a partir da data de criação ou da data atual pela tabela Eventos do conector [sn_wsd_wc_connector_events]. Os dados no estado Erro são limpos após sete dias a partir da data de criação. Os dados no estado Novo não são limpos.