Consulte os conectores compatíveis com a 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 definidos 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 de conectores (
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 do ServiceNow
Para adicionar um gatilho do ServiceNow à sua integração, siga estas etapas:
- No console do Google Cloud, acesse a página Application Integration.
- No menu de navegação, clique em Integrações.
A página Lista de integrações aparece listando todas as integrações disponíveis no projeto do Google Cloud.
- Selecione uma integração existente ou clique em Criar integração para criar uma nova.
Se você estiver criando uma integração:
- Digite um nome e uma descrição no painel Create Integration.
- Selecione uma região para a integração.
- 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.
- Clique em Criar.
Isso abre a integração na página do editor de integração.
- Na barra de navegação do editor de integração, clique em Gatilhos para conferir a lista de gatilhos disponíveis.
- Clique e coloque o elemento do gatilho do ServiceNow no editor de integração.
Para configurar o gatilho do ServiceNow, use uma conexão do ServiceNow disponível nos Integration Connectors ou crie uma nova com a opção de criação de conexão in-line.
Configurar o gatilho do ServiceNow usando uma conexão atual
É possível configurar o acionador do ServiceNow usando uma conexão atual do ServiceNow nos Integration Connectors. O gatilho ServiceNow é um acionador de evento do conector. Portanto, só é possível usar uma conexão do ServiceNow com a assinatura de evento ativada para configurar o gatilho.
Para saber como configurar um gatilho ServiceNow usando uma nova conexão do ServiceNow, consulte Configurar o gatilho do ServiceNow usando uma nova conexão.
Para configurar um gatilho do ServiceNow usando uma conexão atual, execute as seguintes etapas:
- Clique no elemento Trigger do ServiceNow no editor de integração para abrir o painel de configuração do gatilho.
- Clique em Configurar gatilho.
- Forneça os seguintes detalhes de configuração na página Editor do gatilho de evento do conector:
- Região:selecione a região da sua conexão do ServiceNow.
- Conexão:selecione a conexão do ServiceNow que você quer usar.
O Application Integration exibe apenas as conexões do ServiceNow que estão ativas e com uma assinatura de evento ativada.
- 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.
- Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para o gatilho do ServiceNow.
- Clique em Concluído para finalizar a configuração do acionador e fechar a página.
Configurar o gatilho do ServiceNow usando uma nova conexão
Para configurar o gatilho do ServiceNow usando uma nova conexão do serviço, siga estas etapas:
- Clique no elemento Trigger do ServiceNow no editor de integração para abrir o painel de configuração do gatilho.
- Clique em Configurar gatilho.
- Ignore o campo Região.
- Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
- Siga estas etapas no painel Criar conexão:
- Na etapa Local, escolha o local da nova conexão do ServiceNow:
- Região:selecione uma região na lista suspensa.
- Clique em Próxima.
- Na etapa Detalhes da conexão, informe detalhes sobre a nova conexão do ServiceNow:
- Versão do conector:escolha uma versão disponível do conector do ServiceNow na lista suspensa.
- Nome da conexão: insira um nome para a conexão do ServiceNow.
- (Opcional) Descrição : insira uma descrição para a conexão.
- (Opcional) Ativar o Cloud Logging:marque essa caixa de seleção para armazenar todos os dados de registro da conexão.
- Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para a conexão do ServiceNow.
- Ativar assinatura de eventos:selecione para criar e ativar uma nova assinatura de eventos para a conexão do ServiceNow. É possível ativar apenas assinaturas de eventos ou incluir entidades, operações e ações de conexão.
- Incluir tabelas do sistema: selecione para gerar relatórios ou incluir tabelas do sistema na conexão.
- (Opcional) Filtrar tabelas:insira a lista das tabelas do sistema que você quer incluir, começando com "
sys_", separadas por vírgulas. - (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 com o ServiceNow.
- (Opcional) Clique em + Adicionar rótulo para incluir um rótulo à conexão na forma de um par de chave-valor.
- Clique em Próxima.
-
Na etapa Destinos, forneça os detalhes da instância do ServiceNow:
- Destination Type:selecione Host address.
- Host:digite o nome do host ou o endereço IP da instância do ServiceNow.
- Clique em Próxima.
-
Na etapa Autenticação, forneça os detalhes de autenticação para a instância do ServiceNow:
- Nome de usuário:digite o nome de usuário para acessar o endereço de destino fornecido.
- Password:selecione o secret do Secret Manager que contém a senha associada ao nome de usuário do ServiceNow.
- Versão do secret:selecione uma versão do secret.
- Clique em Próxima.
Para saber mais sobre como configurar a autenticação, consulte Configurar autenticação.
-
Na etapa Detalhes da assinatura do evento, informe os detalhes de autenticação que serão usados para validar o payload do token do ServiceNow:
- Authentication Token: (opcional) selecione o secret do Secret Manager do seu token de autenticação e a versão do secret correspondente no menu suspenso Secret Version.
- Algoritmo HMAC: (opcional) selecione o algoritmo HMAC para criptografar o payload da resposta.
- Chave secreta HMAC:se você selecionou um algoritmo HMAC, escolha o secret do Secret Manager da chave HMAC e a versão correspondente do secret na lista suspensa Versão do secret.
- Clique em Próxima.
- Revisão: revise os detalhes da conexão do ServiceNow fornecidos.
- Clique em Criar para concluir a criação de uma nova conexão do ServiceNow.
- Na etapa Local, escolha o local da nova conexão do ServiceNow:
- Depois que a conexão do ServiceNow for criada, acesse sua instância do ServiceNow e crie manualmente uma regra de negócios.
- 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.
- 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 que é executada quando um registro de 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 gatilho ServiceNow leva alguns minutos para concluir a configuração da assinatura do evento. É possível ver o status da sua assinatura de eventos no painel de configuração do acionador, em Detalhes da inscrição de eventos.
O gatilho ServiceNow indica o status de uma assinatura de evento usando os seguintes estados:
Creating: indica que o acionador está assinando a assinatura do evento.Active: indica que o acionador foi inscrito em uma assinatura de evento.Error: indica que há um problema com a inscrição de eventos configurada.
Além do status da inscrição no evento, a seção Detalhes da inscrição no evento também exibe outras informações, como região da conexão, nome da conexão, nome da inscrição do evento e muito mais.
A imagem a seguir mostra um exemplo de layout do painel de configuração do gatilho do 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, que contém o esquema de payload de saída do ServiceNow.
Ver inscrições em eventos
Para conferir e gerenciar todas as assinaturas de eventos associadas a uma conexão no Integration Connectors, faça o seguinte:
- Acesse a página Conectores de integração > Conexões.
- Clique na conexão em que você quer exibir as assinaturas.
- Clique na guia Inscrições em eventos.
Todas as inscrições de eventos da conexão são exibidas.
Editar gatilho do ServiceNow
É possível editar um acionador do ServiceNow para alterar ou atualizar a configuração da conexão e os detalhes da assinatura de eventos.
Para editar um gatilho do ServiceNow, siga estas etapas:
- Clique no elemento Trigger do ServiceNow no editor de integração para abrir o painel de configuração do gatilho.
- Clique em Configurar o gatilho do ServiceNow.
- Faça o seguinte na página Editor do gatilho de evento do conector:
- Para manter a assinatura de eventos configurada anteriormente, clique em Reter. Caso contrário, clique em Excluir.
- Atualize a configuração da conexão e os detalhes da inscrição no evento conforme desejado.
- Clique em Concluído.
Você pode ver os detalhes atualizados da conexão e das inscrições de eventos no painel de configuração do acionador, em Detalhes da inscrição de eventos.