Consulte os conectores compatíveis com o Application Integration.

Gatilho do ServiceNow

O gatilho do ServiceNow é um acionador de evento do conector que permite invocar uma integração com base nos eventos personalizados do ServiceNow que você definiu na regra de negócios da instância do ServiceNow.

Antes de começar

Se você planeja criar ou configurar uma nova conexão para o gatilho ServiceNow, verifique se tem o seguinte papel do IAM no projeto:

• Administrador do conector (roles/connectors.admin)

Para informações sobre como conceder papéis, consulte Gerenciar acesso.

Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o gatilho ServiceNow:

• Invocador do Application Integration (roles/integrations.integrationInvoker)

Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.

Adicionar o gatilho ServiceNow

Para adicionar um gatilho do ServiceNow à sua integração, siga estas etapas:

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrations.

   A página Lista de integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração ou clique em Criar integração para criar uma nova.

   Caso você esteja criando uma nova integração, siga estas etapas:

   1. Insira um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
   3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel info Resumo da integração na barra de ferramentas da integração.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

4. Na barra de navegação do editor de integração, clique em Gatilhos para ver a lista de gatilhos disponíveis.
5. Clique e coloque o elemento gatilho ServiceNow no editor de integração.

Para configurar o gatilho ServiceNow, você pode usar uma conexão ServiceNow existente disponível em Integration Connectors ou criar uma nova conexão ServiceNow usando a opção de criação de conexão inline.

Configurar o gatilho ServiceNow usando uma conexão atual

É possível configurar o gatilho do ServiceNow usando uma conexão do ServiceNow existente no Integration Connectors. Observe que o acionador do ServiceNow é um acionador de evento do conector. Portanto, você só pode usar uma conexão do ServiceNow com a assinatura de eventos ativada para configurar o gatilho.

Para informações sobre como configurar um gatilho ServiceNow usando uma nova conexão ServiceNow, consulte Configurar gatilho ServiceNow usando uma nova conexão

Para configurar um gatilho ServiceNow usando uma conexão ServiceNow existente, execute as seguintes etapas:

1. Clique no elemento ServiceNow trigger no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar gatilho.
3. Forneça os seguintes detalhes de configuração na página Editor do acionador de evento do conector:
   1. Região:selecione a região da sua conexão ServiceNow.
   2. Conexão: selecione a conexão do ServiceNow que você quer usar.

      A integração de aplicativos só mostra as conexões do ServiceNow que estão ativas e têm uma assinatura de eventos ativada.

   3. Tipo de assinatura de evento:insira o tipo de evento que você quer usar para acionar a integração. Esses tipos de eventos precisam ser definidos na regra de negócios da instância do ServiceNow.
   4. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para o gatilho do ServiceNow.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configurar o gatilho ServiceNow usando uma nova conexão

Para configurar o gatilho do ServiceNow usando uma nova conexão do ServiceNow, siga estas etapas:

1. Clique no elemento Gatilho do ServiceNow no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar gatilho.
3. Ignore o campo Região.
4. Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
5. Conclua as seguintes etapas no painel Criar conexão:
   1. Na etapa Local, escolha o local da nova conexão do ServiceNow:
      1. Região:selecione uma região na lista suspensa.
      2. Clique em Próxima.
   2. Na etapa Detalhes da conexão, forneça detalhes sobre a nova conexão do ServiceNow:
      1. Versão do conector: escolha uma versão disponível do conector do ServiceNow na lista suspensa.
      2. Connection Name: digite um nome para a conexão do ServiceNow.
      3. (Opcional) Descrição : insira uma descrição para a conexão.
      4. (Opcional) Ativar o Cloud Logging:marque essa caixa de seleção para armazenar todos os dados de registro da conexão.
      5. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para a conexão do ServiceNow.
      6. Ativar a assinatura de eventos: selecione para criar e ativar uma nova assinatura de eventos para a conexão do ServiceNow. Só é possível ativar assinaturas de eventos ou incluir entidades, operações e ações de conexão.
      7. Incluir tabelas do sistema: selecione para gerar relatórios ou incluir tabelas do sistema na conexão.
      8. (Opcional) Filtrar tabelas:insira a lista de tabelas do sistema que você quer incluir (começando com "sys_", separadas por vírgulas).
      9. (Opcional) Expanda Configurações avançadas para definir as configurações do nó de conexão.

         Para mais informações sobre as configurações do nó de conexão para o ServiceNow, consulte a documentação Conexão do ServiceNow.

      10. (Opcional) Clique em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
      11. Clique em Próxima.
   3. Na etapa Destinos, forneça os detalhes da instância do ServiceNow:
      1. Destination Type:selecione Host address.
      2. Host:digite o nome do host ou o endereço IP da instância do ServiceNow.
      3. Clique em Próxima.
   4. Na etapa Autenticação, forneça os detalhes de autenticação para a instância do ServiceNow:
      1. Nome de usuário:digite o nome de usuário para acessar o endereço de destino fornecido.
      2. Senha: selecione o secret do Secret Manager que contém a senha associada ao nome de usuário do ServiceNow.
      3. Versão do secret:selecione uma versão do secret.

      Para saber mais sobre como configurar a autenticação, consulte Configurar a autenticação.

      4. Clique em Próxima.
   5. Na etapa Detalhes da assinatura do evento, forneça os detalhes de autenticação que serão usados para validar o payload do token do ServiceNow:
      1. Token de autenticação: (opcional) selecione o secret do Secret Manager do token de autenticação e a versão do secret correspondente na lista suspensa Versão do secret.
      2. Algoritmo HMAC: (opcional) selecione o algoritmo HMAC para criptografar o payload de resposta.
      3. Chave secreta HMAC:caso você tenha selecionado um algoritmo HMAC, selecione o secret do Secret Manager da chave HMAC e a versão do secret correspondente no menu suspenso Versão secreta.
      4. Clique em Próxima.
   6. Revisão: analise os detalhes da conexão do ServiceNow.
   7. Clique em Criar para concluir a criação de uma nova conexão do ServiceNow.
6. Depois que a conexão do ServiceNow for criada, você precisará acessar sua instância do ServiceNow e criar uma regra comercial manualmente.
7. Tipo de assinatura de evento:insira o tipo de evento que você quer usar para acionar a integração. Esses tipos de eventos precisam ser definidos na regra de negócios da instância do ServiceNow.
8. Clique em Concluído e feche a página.

Criar uma regra de negócios

Uma regra de negócios do ServiceNow é uma lógica do lado do servidor executada quando um registro do banco de dados é consultado, atualizado, inserido ou excluído na sua instância do ServiceNow. A Application Integration usa essas regras de negócios para identificar e detectar eventos que acionam uma integração.

Para informações sobre como criar uma regra de negócios, consulte a documentação do ServiceNow.

A imagem a seguir mostra um exemplo de regra de negócios do ServiceNow com o tipo de evento update_ticket:

Saída do gatilho

O acionador do ServiceNow leva alguns minutos para concluir a configuração da assinatura do evento. É possível conferir o status da assinatura do evento no painel de configuração do acionador em Detalhes da assinatura do evento.

O gatilho ServiceNow indica o status de uma assinatura de evento usando os seguintes estados:

• restart_alt Creating: indica que o acionador está se inscrevendo na assinatura de eventos.
• check_circle Active: indica que o acionador foi inscrito em uma assinatura de eventos.
• error Error: indica que há um problema com a inscrição de eventos configurada.

Além do status da assinatura do evento, a seção Detalhes da assinatura do evento também exibe outros detalhes, como região da conexão, nome da conexão, nome da assinatura do evento e muito mais.

A imagem a seguir mostra um exemplo de layout do painel de configuração do gatilho ServiceNow:

Variável de saída do acionador

Para cada evento, o gatilho ServiceNow gera uma variável de saída ConnectorEventPayload que pode ser usada nas tarefas downstream. A variável de saída está no formato JSON e contém o esquema de payload do ServiceNow.

Ver inscrições em eventos

Para visualizar e gerenciar todas as assinaturas de eventos associadas a uma conexão no Integration Connectors, faça o seguinte:

1. Acesse Integration Connectors > Conexões.

   Acessar a página "Conexões"

2. Clique na conexão que tem as assinaturas que você quer conferir.
3. Clique na guia Inscrições de eventos.

   Isso mostra todas as assinaturas de eventos da conexão.

Editar gatilho do ServiceNow

É possível editar um gatilho do ServiceNow para alterar ou atualizar a configuração da conexão e os detalhes da assinatura do evento.

Para editar um gatilho do ServiceNow, execute as seguintes etapas:

1. Clique no elemento Gatilho do ServiceNow no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar gatilho do ServiceNow.
3. Faça o seguinte na página Editor do acionador de evento do conector:
   1. Para manter a assinatura de eventos configurada anteriormente, clique em Reter. Caso contrário, clique em Excluir.
   2. Atualize a configuração da conexão e os detalhes de inscrição no evento conforme desejado.
   3. Clique em Concluído.

Confira os detalhes atualizados da conexão e da assinatura do evento no painel de configuração do acionador em Detalhes da assinatura do evento.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

A seguir

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais sobre o tratamento de erros.
• Saiba mais sobre os registros de execução de integração.