Consulte os conectores compatíveis com o Application Integration.

Gatilho do Jira Cloud

O gatilho Jira Cloud é um gatilho de evento do conector que permite invocar uma integração com base nos eventos do Jira Cloud em que você se inscreveu na sua conexão do Jira Cloud.

Antes de começar

Se você planeja criar ou configurar uma nova conexão para o gatilho Jira do Cloud, 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 Jira do Cloud:

• 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 Jira Cloud

Para adicionar um gatilho Jira do Cloud à 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 Jira Cloud trigger no editor de integração.

Para configurar o gatilho do Jira Cloud, use uma conexão do Jira Cloud disponível no Integration Connectors ou crie uma nova conexão do Jira Cloud usando a opção de criação de conexão inline.

Configurar o gatilho do Jira Cloud usando uma conexão atual

É possível configurar o gatilho do Jira Cloud usando uma conexão do Jira Cloud existente no Integration Connectors. O gatilho Jira Cloud é um acionador de evento do conector. Portanto, só é possível usar uma conexão do Jira Cloud com a assinatura de eventos ativada para configurar o gatilho.

Para saber como configurar um gatilho do Jira Cloud usando uma nova conexão do Jira Cloud, consulte Configurar um gatilho do Jira Cloud usando uma nova conexão

Para configurar um gatilho do Jira Cloud usando uma conexão do Jira Cloud, siga estas etapas:

1. Clique no elemento Jira Cloud trigger no editor de integração para abrir o painel de configuração do gatilho.
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 do Jira Cloud.
   2. Conexão:selecione a conexão do Jira Cloud que você quer usar.

      O Application Integration mostra apenas as conexões do Jira Cloud que estão ativas e têm uma assinatura de evento ativada.

   3. Tipo de assinatura de evento:selecione o tipo de assinatura de evento que aciona a integração. Para informações sobre os tipos de assinatura de evento compatíveis com esse acionador, consulte Tipos de assinatura de evento compatíveis.
   4. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para o gatilho do Jira Cloud.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configurar o gatilho do Jira Cloud usando uma nova conexão

Para configurar o acionador do Jira Cloud usando uma nova conexão do Jira Cloud, siga estas etapas:

1. Clique no elemento Jira Cloud trigger 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 Jira Cloud:
      1. Região:selecione uma região na lista suspensa.
      2. Clique em Next.
   2. Na etapa Detalhes da conexão, forneça detalhes sobre a nova conexão do Jira Cloud:
      1. Versão do conector:escolha uma versão disponível do conector do Jira Cloud na lista suspensa.
      2. Connection Name:digite um nome para a conexão do Jira Cloud.
      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 Jira Cloud.
      6. Ativar inscrição de eventos:selecione para criar e ativar uma nova assinatura de evento para a conexão do Jira Cloud. Só é possível ativar assinaturas de eventos ou incluir entidades, operações e ações de conexão.
      7. (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 Jira Cloud, consulte a documentação Conexão do Jira Cloud.

      8. (Opcional) Clique em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
      9. Clique em Next.
   3. Na etapa Destinos, insira os detalhes da conta do Jira Cloud:
      1. Destination Type:selecione Host address.
      2. Host:digite o nome do host ou o endereço IP da sua conta do Jira Cloud.
      3. Clique em Next.
   4. Na etapa de Autenticação, insira os detalhes de autenticação da conta do Jira Cloud:
      1. Nome de usuário:digite o nome de usuário para acessar o endereço de destino fornecido.
      2. Token de API:selecione o secret do Secret Manager com o token de API associado ao nome de usuário do Jira Cloud.
      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 Next.
   5. Na etapa Detalhes da assinatura do evento, informe a conta do Jira Cloud em que as assinaturas do evento serão criadas.
      1. Destination Type:selecione Host address.
      2. Host:insira o URL de registro da sua conta do Jira Cloud. Serão criadas inscrições em eventos para esse URL.
      3. Nome de usuário:digite o nome de usuário para acessar o URL de registro fornecido.
      4. Token de API:selecione a chave secreta do Secret Manager com o token de API associado ao nome de usuário.
      5. Versão do secret:selecione uma versão do secret.
      6. Clique em Next.
   6. Revisão: analise os detalhes da conexão do Jira Cloud fornecidos.
   7. Clique em Criar para concluir a criação de uma nova conexão do Jira Cloud.
6. Tipo de assinatura de evento:selecione o tipo de assinatura de evento que aciona a integração. Para informações sobre os tipos de assinatura de evento compatíveis com esse acionador, consulte Tipos de assinatura de evento compatíveis.
7. Clique em Concluído e feche a página.

Saída do gatilho

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

• restart_alt Creating: indica que o acionador está fazendo a assinatura da 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 abaixo mostra um exemplo de layout do painel de configuração do gatilho do Jira Cloud:

Variável de saída do acionador

Para cada evento, o gatilho Jira do Cloud 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 Jira Cloud.

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 Jira Cloud

É possível editar um acionador do Jira do Cloud para mudar ou atualizar a configuração da conexão e os detalhes da assinatura do evento.

Para editar um gatilho do Jira Cloud, siga estas etapas:

1. Clique no elemento Jira Cloud trigger no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar o gatilho do Jira Cloud.
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.

Tipos de assinatura de eventos compatíveis

Use o gatilho Jira do Cloud para invocar uma integração com os seguintes tipos de assinatura de eventos:

Tipos de assinatura de eventos	Descrição
attachment_created	Um anexo é criado para um tíquete do Jira.
attachment_deleted	O anexo associado a um tíquete do Jira é excluído.
board_created	Um quadro do Jira é criado.
board_deleted	Um quadro do Jira foi excluído.
comment_created	Um comentário é adicionado ao tíquete do Jira.
comment_deleted	um comentário em um tíquete do Jira é excluído.
comment_updated	um comentário em um tíquete do Jira é atualizado;
filter_created	Um novo filtro do Jira foi criado.
filter_deleted	Um filtro do Jira foi excluído.
filter_updated	Um filtro do Jira existente foi atualizado.
issue_created	Um novo problema no Jira foi criado.
issue_deleted	Um problema no Jira foi excluído.
issue_updated	Um problema existente do Jira foi atualizado.
issuelink_created	Um novo link de problema é criado para uma instância do Jira.
issuelink_deleted	O link do problema de uma instância do Jira foi excluído.
option_issuelinks_changed	Um link para um problema de uma instância do Jira é alterado ou atualizado.
option_subtasks_changed	As subtarefas de um problema são atualizadas ou alteradas.
option_voting_changed	O número de votos para um problema do Jira mudar.
option_watching_changed	Os observadores ou a lista de usuários adicionados para assistir a um problema do Jira foram alterados.
project_created	Um novo projeto é criado.
project_deleted	Um projeto foi excluído.
project_restored_deleted	Um projeto excluído é restaurado.
project_soft_deleted	Um projeto é excluído e fica indisponível para os usuários, inclusive para os administradores que usam a interface do produto ou a API.
project_updated	Os detalhes do projeto serão atualizados.
sprint_closed	O sprint está encerrado.
sprint_created	Um sprint é criado.
sprint_deleted	Um sprint é excluído.
sprint_updated	os detalhes de um sprint são alterados ou atualizados.
user_created	Um usuário é criado.
user_updated	os detalhes de um usuário são alterados ou atualizados;
worklog_created	Uma entrada do registro de trabalho foi adicionada.
worklog_deleted	Uma entrada do registro de trabalho foi excluída.
worklog_updated	uma entrada do registro de trabalho for alterada ou atualizada.

Cotas e limites

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

A seguir

• Saiba mais sobre todas as tarefas e gatilhos.
• 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.