Configure um gatilho da Web do Jira para acionar uma ação sempre que um evento ocorrer no projeto do Jira. Esse exemplo mostra como criar um Task Bot com um gatilho da Web do Jira para enviar um e-mail para uma caixa de entrada do Microsoft 365 Outlook quando o usuário especificado criar um item no projeto do Jira especificado.

O gatilho da Web do Jira monitora 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:
  • Pré-requisitos mencionados em Pré-requisito de gatilhos da Web do Jira.
  • Segredo do cliente do Jira e nome de usuário do Microsoft 365 armazenados no Cofre de credenciais.
  • Uma conexão OAuth para a instância do Jira na qual o projeto está disponível e a conta Microsoft 365 Outlook.
  • Uma variável de registro chamada TriggerData.

Procedimento

  1. Execute as seguintes etapas para criar um Task Bot
    1. No painel da esquerda, clique em Automation (Automação).
    2. Clique em Criar > Task Bot.
      O assistente Criar bot de tarefa é 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: Adicione uma descrição para o bot no campo Descrição.
    5. Opcional: Clique em Escolher e siga as instruções para salvar o bot em uma pasta diferente.
    6. Clique em Criar e editar.
      O bot é criado e a página Editor de bot é exibida.
  2. Execute as seguintes etapas para adicionar e configurar o gatilho da Web do Jira.
    1. Clique em Acionadores > Jira , em se clique duas vezes ou arraste o Web trigger para adicionar o Web trigger à seção Acionadores.
    2. Selecione Problema criado no menu suspenso Monitorar evento.
    3. 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.
    4. Clique em Selecionar para escolher a conexão pré-configurada OAuth no modal Selecionar uma conexão OAuth.
    5. Selecione Segredo do cliente para verificar o evento recebido > Credenciais > Escolher e siga as instruções no modal Escolher uma credencial para selecionar o Segredo do cliente do Jira que está disponível no Cofre de credenciais.
    6. 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.
  3. Execute as etapas a seguir para adicionar e configurar a ação Conectar do Microsoft 365 Outlook.
    1. 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.
    2. Azure Cloud: selecione Azure Global.
      Se você possui uma versão governamental do Microsoft 365 Outlook, selecione Azure US GCC High.
    3. Selecione Gerenciado pela Control Room no menu suspenso Modo de autenticação OAuth2.
    4. Clique em Escolher em Conexão e siga as instruções no modal Escolher uma conexão OAuth para selecionar a conexão OAuth para a conta Microsoft 365 Outlook.
    5. Clique em Credencial > Escolher em Nome de usuário e siga as instruções no modal Escolher uma credencial para selecionar o nome de usuário do Microsoft 365.
    6. Opcional: Insira um nome apropriado para a sessão em Criar sessão do Microsoft 365 Outlook.
      O sistema define Microsoft365OutlookSession como o nome da sessão por padrão.
  4. Execute as etapas a seguir para adicionar e configurar a ação Enviar do Microsoft 365 Outlook.
    1. 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.
    2. Insira o nome da sessão que você informou ao configurar a ação Conectar.
      Se o nome padrão for mantido, o sistema preencherá automaticamente Microsoft365OutlookSession como a sessão do Microsoft 365 Outlook.
    3. Digite o ID de e-mail para o qual o sistema deve encaminhar os detalhes do Jira em Para.
    4. Insira $TriggerData{"issue.key"}$ em Assunto.
      A chave do item do Jira está definida como o assunto do e-mail.
    5. selecione código HTML e insira Resumo - $TriggerData{"issue.fields.summary"}$. Descrição: $TriggerData{"issue.fields.description"}$ em Tipo de corpo do e-mail.
      O resumo e a descrição do Jira são definidos como o corpo do e-mail.
  5. Clique em Salvar para salvar a automação.
Ao clicar em Executar > Executar com gatilhos, o sistema ativa o gatilho, que começa a monitorar o evento Item criado no projeto do Jira monitorado. Quando o usuário XYZ cria um novo item no projeto Jira ABC, o gatilho inicia as ações configuradas. A caixa de entrada do Microsoft 365 Outlook recebe um e-mail contendo o resumo e a descrição do Jira, com o ID do item do Jira como assunto.