Exemplo de criação de uma automação com o gatilho da Web do Jira

Crie uma automação com o gatilho da Web do Jira para enviar um e-mail para uma caixa de entrada do Microsoft 365 Outlook quando um novo problema for criado em um projeto específico do Jira. O e-mail inclui o ID do item do Jira, o resumo e a descrição.

Configure o gatilho da Web do Jira para monitorar um projeto do Jira chamado ABC para novos itens (evento Item criado) criados por um usuário chamado XYZ. Quando o usuário cria um item, o gatilho inicia as ações do Microsoft 365 Outlook subsequentes que enviam um e-mail para a caixa de entrada do Microsoft 365 Outlook. Esse e-mail inclui o resumo e a descrição do Jira com o ID do item do Jira como assunto.

Pré-requisitos

Certifique-se de cumprir os seguintes pré-requisitos:

Procedimento

  1. No painel da esquerda, clique em Automation (Automação).
  2. Clique em Criar > Task Bot.
    O assistente Criar Task Bot será exibido.
  3. Digite um nome apropriado para o bot no campo Nome.
    Todos os bots são armazenados na pasta \Bots por padrão.
  4. Opcional: Você pode adicionar uma descrição para o bot no campo Descrição.
  5. Opcional: Você pode usar o botão Escolher para salvar o bot em uma pasta diferente.
  6. Clique em Criar e editar.
    O bot é criado e o Editar Task Bot é exibido.
  7. Clique em Acionadores > Jira , em se clique duas vezes ou arraste o Web trigger para adicionar o Web trigger à seção Acionadores.
  8. Selecione Problema criado no menu suspenso Monitorar evento.
  9. Configure os critérios de filtro de eventos em Critérios de filtro usando uma das seguintes opções:
    • Consulta: Digite a seguinte consulta JQL project= "ABC" AND reporter= "XYZ".
    • Condição: Execute as seguintes etapas para criar uma condição de filtro usando o construtor de condições.
      1. Selecione E > Adicionar condição.
      2. Configure a primeira condição com ID como Tipo de condição, Igual a como Selecionar operação e ABC como Valor.
      3. Clique em Adicionar para adicionar a condição.
      4. Clique em Adicionar condição.
      5. Configure a segunda condição com Reporter como Tipo de condição, Igual a como Selecionar operação e XYZ como Valor.
      6. Clique em Adicionar para adicionar a segunda condição.
    Consulte a seção Critérios de filtro (opcional) em Gatilhos da Web do Jira para obter mais informações sobre como criar critérios de filtro.
  10. Clique em Selecionar para escolher a conexão pré-configurada OAuth no modal Selecionar uma conexão OAuth.
  11. Selecione Segredo do cliente para verificar o evento recebido > Credenciais e siga as instruções no modal Escolher uma credencial para selecionar o Jira Segredo do cliente que está disponível no Cofre de credenciais.
  12. Selecione TriggerData na lista suspensa Resposta (opcional).
    Essa variável de registro captura os dados de resposta do gatilho. Os dados de resposta do gatilho contêm todas as informações sobre o evento em que a alteração ocorreu no formato de par de chave-valor.
  13. Clique em Ações > Microsoft 365 Outlook e, em seguida, clique duas vezes ou arraste a ação Conectar para adicioná-la à seção Ações.
  14. Configure a ação Conectar da seguinte forma:
    1. Azure Cloud: selecione Azure Global.
      Se você possui uma versão governamental do Microsoft 365 Outlook, selecione Azure US GCC High.
    2. Modo de autenticação OAuth2: selecione Control Room gerenciada.
    3. Conexão: clique em Escolher e siga as instruções no modal Escolher uma conexão OAuth para selecionar uma conexão OAuth apropriada.
    4. Nome de usuário: Clique em Credencial > Escolher e siga as instruções no modal Escolher uma credencial para selecionar o nome de usuário do Microsoft 365.
    5. Criar sessão do Microsoft 365 Outlook: por padrão, o Microsoft365OutlookSession é definido como o nome da sessão.
  15. Clique em Ações > Microsoft 365 Outlook e, em seguida, clique duas vezes ou arraste a ação Enviar para adicioná-la à seção Ações.
  16. Configure a ação Enviar da seguinte forma:
    1. Microsoft365OutlookSession: por padrão, o sistema seleciona Microsoft365OutlookSession como o nome da sessão.
    2. Para: digite o e-mail para o qual o sistema deve encaminhar os detalhes do Jira.
    3. Assunto: digite $TriggerData{"issue.key"}$.
      A chave do item do Jira está definida como o assunto do e-mail.
    4. Tipo de corpo do e-mail: selecione código HTML e insira Resumo - $TriggerData{"issue.fields.summary"}$. Descrição: $TriggerData{"issue.fields.description"}$.
      O resumo e a descrição do Jira são definidos como o corpo do e-mail.
  17. Clique em Salvar para salvar a automação.
Clique em Executar > Executar com gatilhos para ativar o gatilho. Em seguida, o gatilho monitora o evento Item criado no projeto monitorado do Jira. Quando o usuário XYZ cria um novo item no projeto Jira ABC, o gatilho inicia as ações configuradas. Você receberá um e-mail contendo o resumo e a descrição do Jira com o ID do item do Jira como assunto.