Crie um gatilho externo salvo

Salve um conjunto de definições de gatilho como um gatilho reutilizável que responde a eventos externos 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 terceiro compatível que já esteja configurado em Workflow Studio. Quando ocorre um evento, o spoke de terceiros envia a carga do evento para Workflow Studio.

Na definição do gatilho, você especifica:

• A estrutura de carga do evento no formato JSON
• As condições que determinam quando o gatilho é iniciado

Obtenha o JSON da carga do evento do spoke de terceiros que você configurou.

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 gatilhos externos [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

Crie as origens de evento necessárias no construtor de origem de evento ou use as origens de evento existentes desses spokes.

• Spoke do Jira
• 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 identificar onde você pode copiar o JSON da carga do evento. Por exemplo, consulte o link a seguir para cargas de evento do 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 > 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 de onde você pode copiar o JSON da carga.
8. Selecione Visualizar 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.
   Uso e. ou ou operador para adicionar mais condições ao conjunto de condições.
10. Selecione Novo conjunto de condições para adicionar conjuntos de condições adicionais, conforme necessário.
11. Selecione Publicar para disponibilizar o gatilho para uso.
    Nota:

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

Resultado

O gatilho é criado e publicado. Você pode usar o gatilho em qualquer um dos seus fluxos. Para obter informações sobre como adicionar um gatilho a um fluxo, consulte Use um gatilho salvo.

• Gerenciar origens de eventos externos
  Crie e gerencie origens de evento externas para um spoke ou uma aplicação com escopo que escuta eventos que ocorrem em uma aplicação externa ServiceNow. Em seguida, você pode criar definições de gatilho externo e associá-las às origens de eventos externos. Quando ocorre o evento especificado na definição do gatilho externo, ele inicia um ou mais fluxos no ServiceNow instância.