Xray para Jira

Integração do Xray for Jira com o Test Manager para sincronizar requisitos e casos de teste, com sincronização de resultados de testes e defeitos de volta, para Xray Server e Xray Cloud.

A integração do Xray Test Management for Jira fornece uma alternativa para gerenciar seus testes usando o Test Manager. Para aproveitar isso, você precisa instalar o conector Jira e concluir a integração configurando uma nova conexão no Test Manager.

Para conectar sua instância do Test Manager a um projeto do XRay, siga estes procedimentos:

Etapa 1: instalar o UiPath® Test Manager para Jira

Etapa 2: configurar conexão Xray no Test Manager

Etapa 3: (somente Xray Cloud) configurar campo personalizado e telas

Tipos de objetos suportados e direção de transferência de dados

Objetos suportados

• Itens sincronizados do Xray para Jira para o Test Manager são somente de leitura, com exceção de anexos, rótulos de objetos e vínculos de casos de teste.
• Os Defeitos são sincronizados a partir das execuções de testes no Test Manager para o Xray para Jira.

Transferência de dados

A direção da transferência de dados e os objetos correspondentes estão listados abaixo:

• Requisitos sincronizados do Jira → Test Manager
• Casos de teste sincronizados a partir do Xray → Test Manager
• Resultados do teste sincronizados a partir do Test Manager → Xray
• Defeitos sincronizados do Test Manager → Jira

Pré-requisitos

• Conta do Jira Server
• UiPath® Test Manager para Jira Server e Jira Data Center - necessário para a integração do Xray para Jira Server e do Jira Data Center.
• UiPath® Test Manager para Jira Cloud - necessário para a integração do Xray para Jira Cloud.

Instalar o UiPath® Test Manager para Jira

Instale o app UiPath® Test Manager para Jira do Atlassian Marketplace para habilitar a integração do Xray entre sua instância do Jira e o Test Manager.

1. Faça login no Jira como administrador.
2. Navegue até Configurações > Gerenciar Apps.
3. Vá para Encontrar novos aplicativos.
4. Use a barra de pesquisa para encontrar o UiPath® Test Manager para Jira.
5. Selecione Instalar para adicionar o app ao Jira.

Configurar a conexão com o Xray

Configure a conexão do Xray no Test Manager inserindo os detalhes e credenciais de seu Jira Server, para que o os requisitos e os casos de teste possam ser sincronizados entre o Xray e o Test Manager.

1. Faça login no Test Manager como Administrator

2. Abra seu projeto.

3. Navigate to Project Settings > Integration.

4. Selecione Nova conexão e selecione XRay no menu suspenso para editar a conexão.

   

5. Configure da seguinte forma:

   • Nome: insira um nome para seu projeto do Xray.
   • Description (optional): Add a description.
   • Server URL: Add the Jira Server URL, including the port number. This is the URL of the server that exposes the Jira REST API. It is usually identical to the URL you navigate to when using Jira through your browser. For example: https://company-name.atlassian.net.
   • Web URL (optional): Add the web URL in case the server URL is not hosted under the same address as the web URL used to access Jira resources.
   • Username: The username you use to authenticate to the Jira API.
   • Password (Xray Server only): The password you use to authenticate to the Jira API.
   • Project Key: Enter the project key from Jira which refers to the project you want to integrate.
   • Token de API (apenas Xray Cloud): gere um token de API. Para obter mais informações sobre tokens de API Atlassian, consulte Gerenciar tokens de API para sua conta Atlassian.
   • Id do cliente (apenas Xray Cloud): crie uma chave de API contendo um ID do cliente e segredo do cliente. É preciso ser um administrador do Jira para realizar essa ação. Digite o ID do cliente gerado no software Jira.
   • Client Secret (Xray Cloud only): Enter the Client Secret generated in Jira Software.

6. Selecione Salvar para adicionar a conexão. A conexão do Xray é adicionada à lista Integração.

7. Copy the API Key.

8. Abra o Jira e navegue até Configurações do Projeto > UiPath® Test Manager.

9. Configure project settings and paste the API key in the API Key - XRay Integration field.

   

Configurar campos e telas personalizados (somente Xray Cloud)

Você precisa configurar um campo personalizado do tipo Paragraph, chamado UiPath Automation para associá-lo às telas no Xray for Jira. Esta etapa é necessária para que você possa visualizar as informações de automação do caso de teste no Xray for Jira.

Para obter mais informações, consulte Campos personalizados e Configuração de tela.

Edição de uma conexão Xray

Atualize os detalhes da configuração de uma conexão do Xray existente para refletir alterações, como uma nova URL do servidor, credenciais atualizadas ou uma chave do projeto diferente.

1. Efetue login no Test Manager como administrador.
2. Abra seu projeto.
3. Selecione o botão Configurações para abrir as configurações do projeto.
4. Na lista Integração, selecione uma conexão do Xray para expandir o painel.
5. Selecione Editar para configurar a conexão.
6. Selecione Salvar para confirmar.

Exclusão der uma conexão do Xray

A exclusão da conexão remove todos os requisitos e casos de teste associados.

1. Efetue login no Test Manager como administrador.
2. Abra seu projeto.
3. Selecione o botão Configurações para abrir as configurações do projeto.
4. Na lista Integração, selecione uma conexão do Xray para expandir o painel.
5. Selecione Excluir para remover a conexão.
6. Selecione Ok para confirmar.

Gerenciamento de testes por meio do Xray

Os testes executados por meio do Orchestrator propagam os resultados para Xray. Para obter mais informações sobre como gerenciar testes usando Xray, consulte a Página inicial da documentação do Xray.

Importante:

• Os casos de teste editados no Test Manager não são sincronizados com o Xray. Por outro lado, as alterações feitas nos casos de teste no Xray são refletidas no Test Manager.

Artigos relacionados

Sincronização de defeitos

Resultado

O projeto do Xray para o Jira está conectado ao Test Manager. Requisitos e casos de teste são sincronizados do Xray para o Test Manager, e os resultados de testes e defeitos são sincronizados do Test Manager de volta para o Xray e o Jira.