Integração com Jira

Instalação

Para integrar com o Jira, siga os seguintes passos:

Escolha uma Organização e vá até a aba “Integrações”.

Clique na opção de aplicativo Jira.

Clique em “Instalar” e preencha as informações no modal:

“Atlassian Host” é a URL base da sua conta Jira Cloud, por exemplo: meloQA.atlassian.net.

Deve ser informada somente a URL base, sem o "https" e sem o conteúdo após o "net".

O “E-mail utilizado no Jira” é o e-mail do usuário no Jira.

Para gerar o token, clique no seguinte link: https://id.atlassian.com/manage/api-tokens.

Observações

Para que a integração entre o Jira e o MeloQA funcione corretamente, especialmente no processo de vinculação e gerenciamento de tarefas, o usuário que realiza a conexão precisa possuir três permissões no projeto Jira:

  • Criar tarefas

  • Editar tarefas

  • Excluir tarefas

Se qualquer uma dessas permissões não estiver habilitada (por exemplo, a de exclusão), a integração com o MeloQA poderá falhar, impedindo a sincronização ou o gerenciamento completo das tarefas.

Caso a integração apresente falhas, entre em contato com o Administrador do projeto Jira da sua equipe e solicite a concessão das três permissões acima para o seu usuário no projeto correspondente.

Após o ajuste das permissões, a integração deve funcionar normalmente.

Se o problema persistir mesmo após a verificação das permissões, entre em contato com o Suporte MeloQA.

Após instalar, escolha suas opções de configuração.

Escolha qual projeto no MeloQA você deseja habilitar para integrar. Em seguida, escolha o projeto no Jira que deverá ser integrado.

Habilite os toogles das opções de Vinculação e Sincronização de acordo com as suas necessidades.

A seguir, estão os detalhes sobre cada uma das opções.

Permitir a vinculação de Casos de Teste com Issues no Jira

Ao habilitar essa opção, você poderá linkar seus Casos de teste no MeloQA a issues no Jira.

Na criação ou edição do Caso de Teste, clique em “Vincular a uma issue”.

Escolha qual issue deseja linkar ao Caso de Teste.

Após vincular, você pode clicar sobre o ícone de integração na listagem ou nos detalhes do Caso de Teste para ser direcionado para essa issue no Jira.

O usuário que vinculou o caso de teste é exibido nos comentários do card no Jira.

Se um Caso de Teste estiver vinculado a issues no Jira, a Execução desse Caso de Teste vai exibir essas vinculações também.

Permitir a vinculação de Ciclos de Testes com Issues no Jira

É possível também vincular o Ciclo todo a issues no Jira.

Para isso, na criação ou edição do Ciclo, clique em “Vincular a uma issue”.

Após vincular, você pode clicar sobre o ícone de integração na listagem ou nos detalhes do Ciclo para ser direcionado para essa issue no Jira.

O usuário que vinculou o ciclo de testes é exibido nos comentários do card no Jira.

Permitir a vinculação de Bugs com Issues no Jira

Ao habilitar essa opção, você poderá linkar seus Bugs no MeloQA a issues no Jira.

Na criação ou edição do Bug, clique em “Vincular a uma issue”.

Após vincular, você pode clicar sobre o ícone de integração na listagem ou nos detalhes do Bug para ser direcionado para essa issue no Jira.

O usuário que vinculou o bug é exibido nos comentários do card no Jira.

Sincronizar a criação, edição e exclusão de Bugs do meloQA para o Jira

Quando a sincronização de Bugs do MeloQA para o Jira está habilitada, ao criar um novo Bug no Melo, será criada também uma cópia no Jira.

Se o projeto Jira for do tipo Scrum , o card será aberto no backlog; se o projeto for do tipo Kanban, o card será aberto na coluna de “Tarefas pendentes”.

Por padrão, o card aberto no Jira será do tipo "Bug".

Mas se o quadro do Jira não tiver o tipo "Bug" habilitado, será aberto como outro tipo disponível: Épico, História, Tarefa, etc.

Os campos sincronizados são o título e a descrição. Se você fizer alterações nessas informações no MeloQA, elas irão refletir no card do Jira.

A exclusão e conclusão do Bug no MeloQA também reflete no card no Jira.

Importante: a cópia do Bug no Jira terá como “Relator” o usuário que foi informado ao instalar a integração:

O usuário que fez a sincronização do bug é exibido nos comentários do card no Jira.

Sincronizar a edição e exclusão de Bugs do Jira para o meloQA

Quando a sincronização de Bugs do Jira para o MeloQA está habilitada, os campos título e descrição ficam sincronizados. Se você fizer alterações nessas informações no Jira, elas irão refletir no MeloQA.

A exclusão e conclusão do Bug no Jira também reflete no MeloQA.

Campos personalizados na sincronização

Por padrão, apenas os campos título e descrição do Bug ficam sincronizados.

Mas se o card de bug no seu projeto do Jira possui campos personalizados e você deseja sincronizá-los também, siga os seguintes passos:

  1. Vá até as configurações do projeto no meloQA para criar os campos personalizados:

  1. Clique em “Novo Campo Personalizado”.

  2. Selecione a opção “Bug” no campo “Entidade”.

  3. Preencha o título do campo com o texto idêntico ao título do campo no Jira. Atenção: se o texto não for idêntico, a integração vai falhar.

  4. Escolha entre o tipo de campo: “Texto” ou “Seleção”.

  5. Se for escolhido o tipo “Seleção”, informe as opções com texto idêntico às opções no Jira. Atenção: se os textos não forem idênticos, a integração vai falhar.

  6. Marque “Campo obrigatório” se o campo no Jira for obrigatório também.

8. Salve o novo campo personalizado no meloQA.

Quando for registrado um bug no meloQA, as informações dos campos personalizados ficarão sincronizadas:

Importante: Para o funcionamento correto da sincronização, os campos personalizados no Jira devem ser do tipo texto simples ou select simples.

Plugin “meloqa-jira”

Como parte da integração, oferecemos também o plugin “meloqa-jira” para facilitar a organização e rastreabilidade dos seus itens linkados.

O uso do plugin é opcional.

Se o seu projeto ainda não tem a integração com o Jira habilitada, por favor, confira o item Instalação deste tutorial.

Caso deseje utilizar o plugin, acesse o link disponível na página de "Configurações" da integração.

Em seguida, clique em “Get app”.

Selecione o site (sua organização no Jira) onde o plugin será instalado.

Em seguida, informe seus dados de acesso ao MeloQA.

Após a instalação, o card no Jira vai exibir um espaço com os itens linkados no meloQA.

Selecione o projeto no MeloQA para qual deseja ver os itens linkados.

Se desejar linkar novos itens, clique em “Link MeloQA item”.

Busque o item que precisa linkar e clique no +.

Após clicar no +, o item já estará linkado.

Se quiser excluir o link, é só clicar no X na lista.

Atenção: Ao clicar no X, o link será excluído e não é possível desfazer a ação.

No caso de um bug sincronizado, se o link for removido, as atualizações de 2 vias deixarão de acontecer para esse bug.

Como conceder permissões a um usuário em um projeto do Jira

Ao tentar integrar o MeloQA ao Jira, você pode receber a mensagem:

“Você não possui todas as permissões necessárias no Jira.

Permissões ausentes: criar, editar, deletar”

Essa mensagem indica que o usuário que está tentando realizar a conexão não possui uma ou mais permissões obrigatórias no projeto do Jira. Sem essas permissões, a integração falha automaticamente, impedindo a sincronização e o gerenciamento das tarefas entre as plataformas.

Siga as etapas abaixo para conceder as permissões necessárias e concluir a integração corretamente.

1. Acesse o projeto desejado

Dentro da sua organização no Jira, vá até a aba Espaços e selecione o projeto no qual deseja configurar as permissões.

2. Abra as configurações do espaço

Passe o mouse sobre o nome do projeto. Clique nos três pontos (...) que aparecem à direita e escolha Configurações do espaço.

3. Acesse as permissões

No menu lateral esquerdo, selecione Permissões.

4. Edite as permissões do Projeto

No canto superior direito da tela, clique em Ações → Editar permissões. A página será atualizada, permitindo que o administrador atualize ou remova as permissões do projeto.

Apenas administradores do projeto têm permissão para editar as configurações de permissões.

4. Edite as permissões do Projeto

Nessa seção, você encontrará as três permissões necessárias para a integração:

  • Criar Itens

  • Editar Itens

  • Excluir Itens

6. Atualize as permissões

Clique em Atualizar ao lado de cada uma das permissões. Na janela que abrir, selecione o(s) usuário(s) que devem receber acesso, conforme a necessidade do projeto.

Após conceder as três permissões (Criar, Editar e Excluir Itens), o usuário poderá integrar o Jira ao MeloQA normalmente.

Se você seguiu este passo a passo e ainda não conseguiu realizar a integração, entre em contato com o suporte do MeloQA para que possamos ajudar.

Last updated