Consulte os conectores compatíveis com o Application Integration.

Acionador do ServiceNow

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

Importante:os Integration Connectors são um componente faturável do Google Cloud. Para informações sobre os custos e as cobranças do uso do Integration Connectors, consulte Preços do Integration Connectors.

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 mais informações sobre como conceder papéis, consulte Gerenciar o acesso.

Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o gatilho do 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 acionador do 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 Integrações.

   A página Lista de integrações aparece com 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.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   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 Resumo da integração na barra de ferramentas da integração.
      Observação:a opção de selecionar uma conta de serviço só vai aparecer se você tiver ativado a governança de integração para a região selecionada.
   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 conferir a lista de acionadores disponíveis.
5. Clique e coloque o elemento Gatilho do 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 em Integration Connectors. O gatilho do ServiceNow é um gatilho de evento do conector. Portanto, só é possível usar uma conexão do ServiceNow com a assinatura de eventos ativada para configurar o acionador.

Para saber como configurar um gatilho do ServiceNow usando uma nova conexão, consulte Configurar o gatilho do 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. Informe os seguintes detalhes de configuração na página Editor de gatilho de evento do conector:
   1. Região: selecione a região da sua conexão do 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 evento precisam ser definidos na regra de negócios da sua 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 acionador do 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 acionador.
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 ServiceNow na lista suspensa.
      2. Connection Name: digite um nome para a conexão do ServiceNow.
         Observação:os nomes das conexões precisam atender aos seguintes critérios:

         • Os nomes de conexões podem usar letras, números ou hifens.
         • As letras precisam ser minúsculas.
         • Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
         • Os nomes das conexões não podem exceder 63 caracteres.
      3. (Opcional) Descrição : insira uma descrição para a conexão.
      4. (Opcional) Ativar o Cloud Logging: marque esta 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. É possível ativar apenas as assinaturas de eventos ou incluir também entidades, operações e ações de conexão.
         Observação:as seguintes etapas extras de configuração de conexão serão necessárias se você optar por ativar entidades, operações e ações para a conexão:

         • Destinos
         • Authentication
      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 (começando com "sys_", separadas por vírgulas) que você quer incluir.
      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 do 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. Tipo de destino: selecione Endereço do host.
      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 da 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 com 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 secreta correspondente no menu suspenso Versão secreta.
      2. Algoritmo HMAC: (opcional) selecione o algoritmo HMAC para criptografar o payload de resposta.
      3. Chave secreta HMAC: se você tiver selecionado um algoritmo HMAC, selecione o secret do Gerenciador de secrets da chave HMAC e a versão secreta correspondente no menu suspenso Versão secreta.
      4. Clique em Próxima.
   6. Revisão: revise os detalhes de conexão do ServiceNow fornecidos.
   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.
   Observação: o ServiceNow não cria automaticamente uma regra de negócios. Portanto, é necessário criar manualmente uma regra de negócios na sua instância do ServiceNow para ativar as assinaturas de eventos. Para saber como criar uma regra de negócios, consulte Criar uma regra de negócios.
7. Tipo de assinatura de evento:insira o tipo de evento que você quer usar para acionar a integração. Esses tipos de evento precisam ser definidos na regra de negócios da sua 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 integração de aplicativos 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.

Pontos principais:

• Use o valor de Endpoint do listener de eventos da conexão do ServiceNow no Integration Connectors para definir o URL request.setEndpoint na regra de negócios.
• Use eventType como a chave para definir valores de tipos de eventos personalizados em request.setRequestBody.

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 do ServiceNow indica o status de uma assinatura de evento usando os seguintes estados:

• Creating: indica que o acionador está fazendo a assinatura da assinatura de eventos.
• Active: indica que o acionador foi inscrito em uma assinatura de evento.
• Error: indica que há um problema com a assinatura de evento configurada.

Além do status da assinatura do evento, a seção Detalhes da assinatura do evento também mostra outros detalhes, como região de 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:

Acionar variável de saída

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 exibe todas as inscrições 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.

Importante:ao editar ou modificar um gatilho do ServiceNow, é possível manter a assinatura de evento configurada anteriormente que está anexada ao gatilho ou excluí-la. A exclusão de uma assinatura de evento vai afetar todas as integrações publicadas que usam essa assinatura.

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 de gatilho de evento do conector:
   1. Para manter a assinatura de eventos configurada anteriormente, clique em Reter. Caso contrário, clique em Excluir.
      Aviso:a exclusão de uma assinatura de evento vai afetar todas as integrações publicadas que usam essa assinatura. Essa tarefa não pode ser desfeita.
   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.