Consulte os conectores compatíveis com a integração de aplicativos.

Gatilho do Jira Cloud

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

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

Antes de começar

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

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

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

Configurar o acionador do Jira Cloud usando uma conexão existente

É possível configurar o gatilho do Jira Cloud usando uma conexão do Jira Cloud nos Conectores de integração. O gatilho do Jira Cloud é um gatilho 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, consulte Configurar o 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 Gatilho do Jira Cloud no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar acionador.
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 Jira Cloud.
   2. Conexão:selecione a conexão do Jira Cloud que você quer usar.

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

   3. Tipo de assinatura de evento:selecione o tipo de assinatura de evento que aciona a integração. Para saber mais 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 acionador do Jira Cloud.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

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

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

1. Clique no elemento Gatilho do Jira Cloud 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 etapas a seguir 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 Próxima.
   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. Nome da conexão:insira um nome para a conexão do Jira Cloud.
         Observação:os nomes de conexão 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 Jira Cloud.
      6. Ativar a assinatura de eventos:selecione para criar e ativar uma nova assinatura de eventos para a conexão do Jira Cloud. Você pode ativar apenas as assinaturas de eventos ou incluir também entidades, operações e ações de conexão.
         Observação:as etapas de configuração de conexão a seguir são necessárias se você ativar entidades, operações e ações para a conexão:

         • Destinos
         • Authentication
      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 do 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 Próxima.
   3. Na etapa Destinos, forneça os detalhes da conta do Jira Cloud:
      1. Tipo de destino:selecione Endereço do host.
      2. Host:insira o nome do host ou o endereço IP da sua conta do Jira Cloud.
      3. Clique em Próxima.
   4. Na etapa Autenticação, forneça 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 que contém 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 Próxima.
   5. Na etapa Detalhes da assinatura de eventos, forneça detalhes da conta do Jira Cloud em que as assinaturas de eventos serão criadas.
      1. Tipo de destino:selecione Endereço do host.
      2. Host:insira o URL de registro da sua conta do Jira Cloud. As assinaturas de eventos serão criadas para este URL.
      3. Nome de usuário:digite o nome de usuário para acessar o URL de registro fornecido.
      4. Token da API:selecione o secret do Secret Manager que contém o token de API associado ao nome de usuário.
      5. Versão do secret:selecione uma versão do secret.
      6. Clique em Próxima.
   6. Revisão: revise os detalhes de conexão do Jira Cloud fornecidos.
   7. Clique em Criar para concluir a criação de uma nova conexão com o Jira Cloud.
6. Tipo de assinatura de evento:selecione o tipo de assinatura de evento que aciona a integração. Para saber mais 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 do Jira Cloud leva alguns minutos para concluir a configuração da assinatura de eventos. É possível conferir o status da assinatura de evento no painel de configuração do acionador em Detalhes da assinatura de evento.

O gatilho do Jira Cloud indica o status de uma assinatura de evento usando os seguintes estados:

• Creating: indica que o acionador está se inscrevendo na 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 layout de exemplo do painel de configuração de acionadores do Jira Cloud:

Acionar variável de saída

Para cada evento, o acionador do Jira 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 e contém o esquema de payload de saída do Jira Cloud.

Conferir assinaturas de eventos

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

1. Acesse a página Integration Connectors > Connections.

   Acessar a página "Conexões"

2. Clique na conexão em que você quer ver as assinaturas.
3. Clique na guia Assinaturas de eventos.

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

Editar gatilho do Jira Cloud

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

Importante:ao editar ou modificar um acionador do Jira Cloud, você pode manter a assinatura de evento configurada anteriormente que está anexada ao acionador 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 acionador do Jira Cloud, siga estas etapas:

1. Clique no elemento Gatilho do Jira Cloud no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar acionador do Jira Cloud.
3. Faça o seguinte na página Editor de gatilho de evento do conector:
   1. Para manter a assinatura de evento configurada anteriormente, clique em Manter. Caso contrário, clique em Excluir.
      Aviso:excluir uma assinatura de evento vai afetar todas as integrações publicadas que usam essa assinatura. Esta tarefa não pode ser desfeita.
   2. Atualize a configuração da conexão e os detalhes da assinatura de eventos conforme necessário.
   3. Clique em Concluído.

É possível conferir os detalhes atualizados da conexão e da assinatura de eventos no painel de configuração do acionador em Detalhes da assinatura de eventos.

Tipos de assinatura de evento com suporte

Você pode usar o gatilho do Jira Cloud para invocar uma integração para os seguintes tipos de assinatura de eventos:

Tipos de inscrição em 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 novo quadro do Jira é criado.
board_deleted	Um painel do Jira é 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 é criado.
filter_deleted	Um filtro do Jira é excluído.
filter_updated	Um filtro do Jira é atualizado.
issue_created	Um novo problema do Jira é criado.
issue_deleted	Um problema do Jira é excluído.
issue_updated	Um problema do Jira é 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 é excluído.
option_issuelinks_changed	Um link de problema existente para 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 em um problema do Jira é alterado.
option_watching_changed	A lista de usuários que foram adicionados para acompanhar um problema do Jira foi alterada.
project_created	Um novo projeto é criado.
project_deleted	Um projeto é excluído.
project_restored_deleted	Um projeto excluído é restaurado.
project_soft_deleted	Um projeto é excluído para não ficar visível para nenhum usuário, incluindo administradores que usam a interface do produto ou a API.
project_updated	Os detalhes do projeto são atualizados.
sprint_closed	O sprint foi fechado.
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 de registro de trabalho é adicionada.
worklog_deleted	Uma entrada de registro de trabalho é excluída.
worklog_updated	Uma entrada de registro de trabalho é alterada ou atualizada.

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.