Crie um gatilho externo salvo

Salve um conjunto de definições de gatilho como um gatilho reutilizável que responde a um evento externo por meio de webhooks. Quando ocorre um evento na aplicação de terceiros configurada que atende às condições especificadas, o gatilho é ativado.

Por Que e Quando Desempenhar Esta Tarefa

Crie um gatilho salvo que responda a eventos que ocorrem em um spoke de terceiros compatível que já esteja configurado em Workflow Studio. O spoke de terceiros envia a carga do evento para Workflow Studio sempre que ocorrer um evento. Na definição do gatilho, especifique a carga útil do evento no formato JSON e as condições para iniciar o gatilho. Obtenha a carga JSON do evento do spoke de terceiros que você configura.

Antes de Iniciar

Função necessária: Trigger_designer, flow_designer ou admin

Assinatura necessária: Esta etapa requer uma assinatura do Hub de integração.

Plug-ins necessários: Instale os seguintes plug-ins do Hub de integração:

• Gatilho externo do hub de integração da ServiceNow [com.glide.ih.external_trigger]: Para usar gatilhos externos prontos para uso.

• Construtor de gatilho externo [sn_ext_trg_bldr]: Para criar um gatilho externo salvo.

Nota:

Para obter informações sobre o que está incluído com diferentes  assinaturas do Integration Hub, consulte Cronogramas jurídicos - Visão geral do Integration Hub

Você cria as origens de evento necessárias no construtor de origem de evento ou pode usar as origens de evento existentes desses spokes.

• Jira Spoke
• GitHub Spoke
• Spoke do DocuSign eSignature
• Spoke do Microsoft Azure DevOps Boards

Para obter mais informações sobre como criar uma origem de evento, consulte Crie uma origem de evento externa.

Importante:

Mantenha a carga JSON do evento da aplicação de terceiros à mão. Consulte a documentação do webhook de terceiros para saber mais sobre de onde você pode copiar a carga JSON. Por exemplo, consulte o link a seguir que mostra diferentes formas de carga para eventos Jira: Executando um webhook .

Procedimento

1. Navegar até Tudo > Automação de Processo > Workflow Studio.
2. Na página inicial do Workflow Studio, selecione Novo(a) > Gatilho.
3. No formulário, preencha os campos.

   Tabela 1. Novo formulário de gatilho

   Campo	Descrição
   Nome do gatilho	Nome para identificar o gatilho.
   Tipo de gatilho	O tipo de gatilho para iniciar seu fluxo. Em Externo, selecione Evento (webhook) .
   Descrição	Descrição do gatilho.
   Aplicação	Escopo da aplicação para criar o gatilho. Workflow Studio exibe os spokes configurados compatíveis.
   Origem do evento	O sistema de terceiros para o qual os eventos serão enviados ServiceNow.
   Domínio	Escopo do domínio do fluxo. Para obter mais informações sobre Domain Separation, consulte Domain separation explained.

4. Selecione Mostrar propriedades adicionais e preencha os campos.

   Tabela 2. Formulário de propriedades adicionais

   Campo	Descrição
   Acessível de	Os dados do gatilho podem ser acessados em todos os escopos da aplicação.
   Categoria	A categoria em que o gatilho é exibido.
   Anotação do gatilho	Anotação para o gatilho que o usuário pode ver antes de selecioná-lo.

5. Selecione Gatilho de criação .
   Workflow Studio Exibe a página Definição do gatilho. Na área de visualização da origem do evento, você pode exibir informações sobre como o endpoint do gatilho externo está configurado. As configurações feitas no gatilho são salvas automaticamente .
6. Em Analisador preencha os campos.

   Tabela 3. Formulário do analisador

   Campo	Descrição
   Nome da saída do gatilho	Rótulo para identificar a saída do gatilho.
   Cabeçalhos da solicitação	Campo opcional para especificar um ou mais cabeçalhos a serem incluídos na solicitação de entrada.
   Parâmetros de consulta	Campo opcional para especificar um ou mais parâmetros a serem incluídos na solicitação de entrada.

7. Em Corpo , em Editor JSON Cole a carga JSON da aplicação de terceiros.
   Consulte a documentação do webhook de terceiros para saber mais sobre de onde você pode copiar a carga JSON.
8. Selecione Visualize objetos .
   O editor exibe os objetos que estão na carga JSON. Você pode reordenar ou remover os objetos. Os objetos estão disponíveis como cápsulas de dados para uso em condições.
9. Em Editor de condições arraste e solte as cápsulas de dados para criar um conjunto de condições.
   Use os operadores [OR] ou [AND] para adicionar mais condições ao conjunto de condições.
10. Selecione Novo conjunto de condições para adicionar conjuntos de condições adicionais de acordo com seu requisito.
11. Selecione Publicar para disponibilizar o gatilho para que outras pessoas usem.
    Nota:

    Depois que o gatilho for publicado, você poderá editar somente o. saída Rótulo campos .