Integração do Jira

Se o UiPath Automation Hub for o local onde você pode gerenciar centralmente seu pipeline de oportunidades de automação, o Jira é provavelmente o local onde seus desenvolvedores acompanharão as tarefas subjacentes usadas no ciclo de vida do desenvolvimento da automação.

Ao vincular as Ideias do Automation Hub aos tickets do Jira, você terá uma visão mais clara do progresso do desenvolvimento das suas automações.

A autenticação entre o Automation Hub e o Jira aproveita o Conector do Jira Cloud existente no UiPath Integration Service.

Configurando a Integração do Jira

Os usuários do Automation Hub com permissões para Gerenciar a integração do Jira podem configurá-lo e ativá-lo para que os usuários possam vincular ou criar um tíquete do Jira diretamente de uma ideia de automação.

Autenticação

A Integração do Jira deve ser habilitada e configurada por um usuário do Automation Hub com permissões para gerenciar a integração, antes de implementá-la para o resto dos usuários.

Nesta guia, o usuário precisa primeiro inserir um espaço de trabalho do Jira para poder executar a configuração.

Observação:

• Os administradores precisam ter a permissão Gerenciar Integration di Jira atribuída.

• As funções Proprietário da Conta e Administrador do Sistema têm permissão atribuída por padrão.

Siga as etapas abaixo para iniciar a configuração:

1. Comece conectando-se ao espaço de trabalho do Jira

• Em Console de Administração > Configuração da Plataforma, selecione Integração do Jira.

• Na seção Autenticação, você será solicitado a começar por adicionar a URL do seu espaço de trabalho do Jira e selecionar Conectar.

  
  

  

  
  
  A URL do espaço de trabalho do Jira precisa respeitar o seguinte formato: https://[yourworskpace].atlassian.net

2. Autentique com o Jira.

• Selecione Abrir Autenticador.
• O UiPath Integration Service é aberto em uma nova janela, de onde você pode selecionar Adicionar conexão.

Saiba mais sobre como usar conectores na página Conexões.

Uma nova Janela Conectar ao Jira é exibida onde o URL do site e Escopo devem ser previamente preenchidos. Selecione Conectar.

• A página da Web da Atlassian é aberta, onde você precisa confirmar UiPath - Integração do Jira. Selecione Aceitar.

  
  

  

  
  
  Observação:

  Se você ainda não estiver conectado ao JIra, ele pedirá que você faça login primeiro e depois retomar o UiPath - Integração do Jira.

  A conexão que o administrador configura no nível do Integration Service não pode ser reutilizada para o restante dos usuários que usarão a integração. Todos os usuários terão que possuir uma conexão existente para usar a integração.

• Você é redirecionado para a página inicial da Conexão com o Jira no Automation Hub onde, abaixo do botão Abrir Autenticação você precisa selecionar Confirmar, para que a conexão da integração seja bem sucedida.

  Nesse ponto, sua conexão com o Jira está em vigor e você pode passar para as próximas etapas.

  3. Configurar o tipo de problema e o nome do projeto
• Usando o menu suspenso para cada caixa, você pode selecionar o Nome do Projeto e o Tipo de problema, que será usado quando um ticket do Jira for criado a partir de uma ideia de automação. Selecione Confirmar.

• Os valores da lista suspensa são obtidos do espaço de trabalho do Jira ao qual você está conectado.

  
  

  

  
  
  4. Selecionar um problema existente como modelo

• Agora é necessário adicionar o Link do problema, que representa o modelo de tíquete do Jira para o seu projeto. As seções pré-preenchidas desse tíquete são sempre adicionadas aos tíquetes criados pelo usuário. Adicione o URL do tíquete do Jira e selecione Validar.

  
  

  

  
  

  O problema do modelo será validado antes de salvar para garantir que:

• Ele seja do mesmo projeto que o definido na etapa anterior.
• O tipo de problema corresponda ao tipo definido na etapa anterior.
• O problema existe no espaço de trabalho do Jira conectado.

• O formato da URL esteja correto: https://yourworskpace.atlassian.net/browse/YOURPROJECTKEY-1111

Exemplo de configuração do modelo de problema do Jira:

• Você começa com um ticket existente do seu Projeto Jira https://yourworskpace.atlassian.net/browse/KEY-1111 .
• O problema é do tipo Tarefa e contém os Campos básicos do Jira e um campo personalizado adicional chamado Validação necessária.
• O ticket é salvo na configuração do Automation Hub.

• Na guia Mapeamento de Campo, você pode fazer a seguinte configuração:

  • Mapas de títulos de ideias para o Resumo do Jira.
  • Mapas de descrições de ideias para Descrição do Jira.
• Você pode optar por mapear o campo do Jira Validação Necessária em um campo no Automation Hub ou pode codificar no modelo para sempre ter um determinado valor certo - por exemplo, Sim.
• O toque final pode ser adicionar também uma etiqueta codificada por AUTOMATION_HUB_IDEA no modelo de problema do Jira.

• Usando essa configuração, os tickets do Jira criados a partir do Automation Hub terão a seguinte configuração:

  • Resumo e Descrição e descrição obtidos dos campos correspondentes do Automation Hub.
  • Campo personalizado Validação necessária codificado como Sim para todos os problemas.

  • Rótulos codificados para AUTOMATION_HUB_IDEA para todos os problemas.

    Uma vez criado o ticket, ele seguirá o fluxo de trabalho definido no Jira para aquele tipo de problema.

Importante: certifique-se de que o modelo não seja excluído ou alterado enquanto a Conexão com o Jira estiver ativa e definida, pois pode levar à interrupção do fluxo da integração.

5. A última etapa no fluxo de conexão mostra que a conexão está agora habilitada.

Mapeamento de campo

Na guia Mapeamento de Campo, você pode mapear campos do Automation Hub para campos do Jira. Ao fazer isso, você configurará o modo como os tickets são criados pelos usuários com permissão para disparar a criação do Problema do Jira no Automation Hub

Quando um mapeamento é realizado, os valores do campo no Automation Hub são usados para preencher o campo mapeado correspondente no Jira.

Por padrão, dois campos do Jira são mapeados após uma Conexão com o Jira bem-sucedida:

Campo do Jira	Campo do Automation Hub
Summary	Nome da Automação
Um campo com texto sem formatação	Description

Um novo mapa de campo pode ser adicionado por:

1. Selecionar +Adicionar Mapeamento.
2. Em campo Jira, selecione a nova linha nova criada e, no menu suspenso, selecione o campo disponível desejado.
3. No campo do Automation Hub, selecione o campo disponível desejado na lista suspensa.

As linhas na tabela de mapeamento são salvas automaticamente.

Para excluir uma linha, acesse o menu de três pontos no lado direito da linha e selecione Excluir.

Exemplo de mapeamento:

• Você tem um campo do Jira chamado Razão comercial.
• Você também tem um campo no Automation Hub chamado Business reason (os nomes não precisam corresponder) que você definiu em uma das suas avaliações.
• Na guia Mapeamento de Campo, você mapeia os dois juntos.
• Quando um usuário selecionar Criar um novo ticket do Jira a partir do Automation Hub, o campo Motivo Empresarial no Jira receberá o valor do Motivo Empresarial da ideia do Automation Hub.

Se o campo for nulo ou não existir no Perfil de Automação da Ideia, a criação será feita, mas o campo do Jira correspondente terá valores nulos.

Excluir conexão com o Jira

Ao excluir a Conexão com o Jira, todos os dados do formulário Autenticação são limpos.

1. Em Console de Administração > Configuração da Plataforma, selecione Integração do Jira.
2. Selecione Excluir Conexão.

O botão Redefinir Conexão pode ser usado para redefinir o formulário de Autenticação de Administração do Jira antes de a conexão ser salva.