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.

Antes de Iniciar

Função necessária: Trigger_designer (pode criar, ler, atualizar ou excluir origens de eventos externos) e trigger_designer_read (pode executar operações somente leitura nas origens de eventos externos que a função trigger_designer cria.)

Confirme se você instalou o plug-in Construtor de gatilhos externos em sua instância. External Trigger Builder v1.0.3 é a versão mais recente disponível.

Por Que e Quando Desempenhar Esta Tarefa

Uma origem de evento externa é um endpoint em seu ServiceNow instância que escuta um sistema ou aplicação fora de ServiceNow. Fora da aplicação ServiceNow envia um evento para a origem de evento externo, ele permite que uma definição de gatilho inicie um ou mais fluxos. Por exemplo, você define uma origem de evento externo para um software de acompanhamento de problemas que se comunica com uma definição de gatilho externo que você definiu. A definição do gatilho externo escuta a origem do evento e inicia um fluxo quando um novo problema é criado no software de acompanhamento de problemas. A origem do evento externo e as definições do gatilho são definidas em seu ServiceNow instância. Uma definição de gatilho externo fornece um conjunto de condições que informa à instância da ServiceNow quando iniciar um fluxo.

Crie uma origem de evento externa

Crie uma origem de evento externa para um spoke ou aplicação com escopo que escuta eventos que ocorrem em uma aplicação ou sistema externo ServiceNow. Com base na origem do evento externo, você pode criar uma definição de gatilho externo que receba comunicação da origem do evento externo e inicie um fluxo no ServiceNow instância.

Antes de Iniciar

Função necessária: Trigger_designer (pode criar, ler, atualizar ou excluir origens de eventos externos) e trigger_designer_read (pode executar operações somente leitura nas origens de eventos externos que a função trigger_designer cria.)

Confirme se você instalou o plug-in Construtor de gatilhos externos em sua instância.

Procedimento

1. Navegar até Tudo > Automação de Processo > Workflow Studio.
2. Clique na guia Integrações.
3. Clique no spoke.
   . Spokes a guia é selecionada por padrão. Se ele ainda não estiver selecionado, confirme se você o selecionou.

   

4. No painel esquerdo, clique em Origens de evento.
   
5. Clique em Criar origem do evento .
6. No campo Nome da origem do evento, forneça um nome exclusivo para a origem do evento externo.
7. Opcional: No campo Descrição, insira uma descrição da origem do evento externo.
   
8. Clique em Criar origem do evento .
   A origem do evento externo é criada no estado de rascunho.
9. Opcional: Exiba a origem do evento externo no estado de rascunho.
   1. Selecione a guia Spoke.
      
   2. Selecione a guia Rascunhos.
      A origem do evento externo que você criou é exibida.

      Dica:

      Se a origem do evento externo não aparecer, atualize a página e selecione Rascunhos guia.
10. No título Autenticação, selecione o método para autenticar o webhook que a aplicação externa envia para seu ServiceNow instância.
    Os seguintes métodos de autenticação estão disponíveis.

    • Básico
    • OAuth
    • Hash
    • Token

    Se você escolher o método de autenticação de hash ou token, deverá especificar as informações fornecidas na tabela.

    Tabela 1. Especificações de autenticação

    Método de autenticação	Campo	Descrição
    Básico		Opção para especificar que os nomes de usuário e senhas que a aplicação externa envia serão autenticados.
    OAuth		Opção para especificar que o mecanismo OAuth será usado para autenticar os webhooks da aplicação externa.
    Hash	Local da autenticação	Opção para especificar o local onde a aplicação ou sistema externo inclui o hash ao enviar a mensagem. Os locais disponíveis são: Parâmetros de consulta Cabeçalho
    	Nome do Parâmetro	Opção para especificar o nome do campo onde você pode encontrar o hash.
    	Algoritmo de hash	Opção para especificar o algoritmo usando o qual o hash é calculado. Os algoritmos disponíveis são: HmacSHA256 HmacSHA384 HmacSHA512
    	Prefixo	Opção para especificar um valor que pode vir antes do hash.
    	Script de Util do HMAC	Opção para especificar o script que gera ou valida o hash. Para saber mais sobre o HMAC, consulte Configure HMAC - Token-based authentication.
    Token	Local da autenticação	Opção para especificar o local onde o sistema externo inclui o token ao enviar a mensagem. Os locais disponíveis são: Parâmetros de consulta Cabeçalho
    	Nome do Parâmetro	Opção para especificar o nome do campo onde você pode encontrar o token.
    	Prefixo	Opção para especificar um valor que pode vir antes do token.

11. Clique em Publicar.
    A origem do evento externo está disponível para você associar a uma definição de gatilho externo.

    

12. Opcional: Exiba a origem do evento externo publicado.
    1. Selecione a guia Spoke.
       
    2. Selecione Publicado guia.
    A origem do evento externo que você publicou é exibida.

    Dica:

    Se a origem do evento externo não aparecer, atualize a página e selecione Rascunhos guia.

O que Fazer Depois

Crie um gatilho externo salvo e associe-o à origem de evento externo que você criou.

Atualize uma origem de evento externo

Atualize uma origem de evento externo que esteja no estado rascunho ou publicado.

Antes de Iniciar

Função necessária: Trigger_designer (pode criar, ler, atualizar ou excluir origens de eventos externos) e trigger_designer_read (pode executar operações somente leitura nas origens de eventos externos que a função trigger_designer cria.)

Confirme se você instalou o plug-in Construtor de gatilhos externos em sua instância.

Por Que e Quando Desempenhar Esta Tarefa

Você pode atualizar todas as informações de uma origem de evento externa no estado de rascunho, mas somente seu nome e descrição no estado Publicado.

Procedimento

1. Navegar até Tudo > Automação de Processo > Workflow Studio.
2. Clique na guia Integrações.
3. Clique no spoke que tem a origem do evento externo definida.
   . Spokes a guia é selecionada por padrão. Se não estiver selecionado, confirme que você o selecionou.

   

4. No painel esquerdo, clique em Origens de evento.
   
5. Para atualizar uma origem de evento no estado de rascunho, execute as etapas.
   1. Clique em Rascunhos guia.
   2. Clique na origem do evento externo que você deseja atualizar.
   3. Clique no botão de reticências ( ) E clique em Propriedades.
   4. No formulário Propriedades de origem do evento, atualize as informações.
   5. Clique em Atualizar.
      A origem do evento externo é atualizada.
6. Para atualizar uma origem de evento no estado Publicado, execute as etapas.
   1. Clique em Publicado guia.
   2. Clique na origem do evento externo que você deseja atualizar.
   3. Clique no botão de reticências ( ) E clique em Propriedades.
   4. No formulário Propriedades de origem do evento, atualize as informações nos campos a seguir.
      • Nome da origem do evento
      • Descrição
   5. Clique em Atualizar.
      A origem do evento externo é atualizada.

Exclua uma origem de evento externa

Exclua uma origem de evento externa no estado rascunho ou publicado que não esteja associada a uma definição de gatilho externo.

Antes de Iniciar

Função necessária: Trigger_designer (pode criar, ler, atualizar ou excluir origens de eventos externos) e trigger_designer_read (pode executar operações somente leitura nas origens de eventos externos que a função trigger_designer cria.)

Confirme se você instalou o plug-in Construtor de gatilhos externos em sua instância.

Procedimento

1. Navegar até Tudo > Automação de Processo > Workflow Studio.
2. Clique na guia Integrações.
3. Clique no spoke que tem a origem do evento externo definida.
   . Spokes a guia é selecionada por padrão. Se não estiver selecionado, confirme que você o selecionou.

   

4. No painel esquerdo, clique em Origens de evento.
   
5. Clique em Publicado ou Rascunhos guia.
6. Clique na origem do evento externo que você deseja excluir.
7. Clique no botão de reticências ( ) E selecione Propriedades.
8. Clique em Excluir.
9. Na caixa de diálogo Excluir origem do evento, clique em Excluir .
   A origem do evento externo é excluída.

   Nota:

   Não é possível excluir uma origem de evento externa que tenha um ou mais gatilhos externos associados.