Azure DevOps

Integração do Azure DevOps com o Test Manager por meio da UiPath Azure DevOps Extension para sincronizar itens de trabalho como requisitos, defeitos e, opcionalmente, casos de teste.

Integre o Azure DevOps ao Test Manager para dar suporte aos seus esforços de gerenciamento de teste, planejamento ágil ou rastreamento de defeitos. Por meio dessa integração, você pode sincronizar seus itens de trabalho com o Test Manager.

Para conectar sua instância do Test Manager a um projeto do Azure DevOps:

1. Criar um projeto no Azure DevOps
2. Configurar uma conexão do Azure DevOps

Pré-requisitos

• Conta do Azure DevOps
• Atribuir permissões para integrar com ganchos de serviço
• Conta de administrador do Test Manager
• An External Application registered in Automation Cloud, scoped to Test Manager. See Adding an external application. Without this, the connection fails immediately with an "Incorrect URL" error, even when the Server URL is formatted correctly.
• Extensão UiPath® Test Manager Azure DevOps
• Azure Test Plans - to sync test items with your Test Manager. Test Plans access requires a separate Azure DevOps subscription add-on, licensed through Microsoft — it is not part of any UiPath license and cannot be requested through UiPath. Make sure to validate the integration scenario thoroughly. Consider the following limitations:
  • Não é possível sincronizar as declarações.
  • Não é possível sincronizar as etapas de teste manual. O Azure DevOps armazena etapas de teste em um campo XML (Microsoft.VSTS.TCM.Steps) que suas APIs REST não expõem como dados estruturados — essa é uma restrição da API do Azure DevOps, não uma limitação do Test Manager.
  • As Execuções de teste não podem ser definidas com o status Concluído, pois são bloqueadas no Azure DevOps, para que os resultados sejam sincronizados em paralelo.
  • O escopo dos projetos no Test Manager e no Azure DevOps é substancialmente diferente e, portanto, requer um planejamento detalhado do roteamento de objetos.

Criar um projeto no Azure DevOps

Crie um projeto do Azure DevOps com o processo de itens de trabalho do Agile para compatibilidade com o planejamento ágil e forneça um destino para a sincronização de itens de trabalho com o Test Manager.

1. Faça logon no Azure DevOps.
2. Selecione Criar novo projeto e defina as configurações de seu projeto:
   • Nome do projeto: insira um nome para o seu projeto.
   • Description: Add a description to help you easily identify the use of each project.
   • Version control: Choose your version control.
   • Processo do item de trabalho: selecione Ágil no menu suspenso como seu processo padrão para oferecer suporte aos seus métodos de planejamento do Ágil, incluindo atividades de desenvolvimento e teste.
3. Selecione Criar.

Seu projeto é adicionado à sua coleção.

Configurar uma conexão do Azure DevOps

Configure a conexão entre o Test Manager e um projeto do Azure DevOps definindo as configurações de integração no Test Manager e na extensão do UiPath® Azure DevOps.

Pré-requisitos: para salvar a extensão do UiPath® Test Manager no Azure DevOps, você deve ser um usuário Administrator do Azure. 1. Faça login no Test Manager como Administrator. 2. Abra seu projeto. 3. Navegue até Configurações do projeto > Integração. 4.

Selecione Nova conexão e selecione Azure DevOps no menu suspenso. 5. Defina as seguintes configurações de conexão:

• Nome: insira um nome para sua conexão do Azure DevOps. * Descrição (opcional): adicione uma descrição para referência. * URL do servidor: adicione a URL do servidor do Azure Dev Ops. Por exemplo: https://company-name-serverRegion.cloudapp.azure.com.

• Token de acesso pessoal: crie um PAT e cole-o neste campo para autorizar o Test Manager a realizar ações. ::::warning: quando você criar a conexão ao Azure DevOps, o PAT precisa ter acesso total aos serviços do Azure DevOps.

Para fazer isso, selecione Acesso total em Escopos ao criar ou editar um PAT. Após a conexão ser concluída, é possível reduzir os escopos do PAT para : Test Management - Read & Write e Itens de trabalho - Read & Write. Para obter mais informações, consulte Usar tokens de acesso pessoal.

:::

• Defect Type: Enter an object type used for bug reporting in Azure DevOps. Otherwise, leave empty if you do not want to use defect integration.

Insira um tipo de defeito com base no tipo de objeto que você selecionou para seu projeto Azure DevOps recém-criado. Por exemplo: Bug ou Issue.

• Project Name: Enter your Azure DevOps project name.

6. Selecione a conexão para expandir o painel e copie a Chave de API para uso posterior. 7. Abra seu projeto no Azure Dev Ops e acesse Configurações do projeto. 8. Em Extensões, acesse o UiPath® Test Manager. 9. Defina as seguintes configurações de extensões:

• Tipos de Requisitos: selecione os tipos de objetos para os quais você deseja atribuir um teste Essas opções aparecerão como requisitos no Test Manager. Para obter mais informações, consulte Requisitos.
• URL do servidor: adicione a URL do Test Manager. A URL deve ter o seguinte formato: https://cloud.uipath.com/{organizationName}/{tenantName}/testmanager_.
• API: Paste the API key.
• Manage Tests with Azure DevOps: Select this option to manage your tests through Azure DevOps. Otherwise, leave this option off, to manage your tests through Test Manager.

10. Selecione Salvar.

    

Trabalhando com a integração do Azure DevOps

Para dar uma olhada em como a integração funciona, considere os seguintes exemplos:

• Sincronizando Itens de Trabalho
• Gerenciamento de testes por meio do Azure DevOps

Sincronizando Itens de Trabalho

You can create work items (e.g. Epic) in Azure DevOps and synchronize them with Test Manager. The work items will show up on the Requirements page.

1. Faça logon no Azure DevOps e abra seu projeto.
2. Selecione o botão de mais e selecione um Novo item de trabalho no menu suspenso.
3. Configure seu item de trabalho e, em seguida, selecione Salvar e fechar. Para obter mais informações, consulte Adicionar e atualizar um item de trabalho.
4. Faça login no Test Manager e acesse Requisitos para visualizar o item de trabalho sincronizado. Para atualizar a página, selecione o elemento de trilha Requisitos.
   Observação:

   Para sincronizar itens de trabalho criados antes da integração, abra um item individual, selecione o botão Actions e selecione Enviar por push para o Test Manager no menu suspenso.

Gerenciamento de testes por meio do Azure DevOps

Você pode usar o Test Cloud para automação de testes e o Azure DevOps para gerenciamento de testes Para usar ambas as soluções em conjunto, primeiro você precisa selecionar Gerenciar testes com o Azure DevOps na configuração de integração. Para obter mais informações, consulte Configurar uma Conexão DevOps do Azure.

Agora, é possível gerenciar os testes enviando por push casos de teste do Azure DevOps para o Test Manager. Em outras palavras, qualquer item de trabalho do Azure do tipo Caso de Teste será enviado por push para o Test Manager. Certifique-se de adicionar casos de teste a seus planos de teste do Azure, pois é para lá que os resultados serão enviados por push. Para obter mais informações, consulte Criar planos de teste e conjuntos de testes.

Após essa sincronização, você poderá automatizar os casos de teste por meio do Studio. Posteriormente, se você executar seus casos de teste usando o Orchestrator, os resultados serão enviados para seus planos de testes do Azure.

Matriz de fluxo de dados do Azure DevOps

A tabela a seguir resume quais dados sincronizam entre o Azure DevOps e o Test Manager por meio da extensão nativa do UiPath Azure DevOps e em qual direção. Esta matriz não se aplica ao Test Manager Connect, que usa um mecanismo de sincronização separado por meio do Planview® Hub.

Objeto/dados do Azure DevOps	Direction	Mecanismo de sincronização	Notas/limitações
Itens de trabalho (Épico, História de usuário etc.)	Azure DevOps → Test Manager	Automático ao salvar; aparece na página Requisitos	Os itens criados antes da integração precisam de uma ação manual Enviar para o Test Manager
item de trabalho do caso de teste	Azure DevOps → Test Manager	Requer a ativação de Gerenciar testes com o Azure DevOps na conexão	Você deve adicioná-lo a um Plano de teste do Azure, ou os resultados de execução não terão para onde sincronizar de volta
Etapas de teste manuais (campo Microsoft.VSTS.TCM.Steps)	Não sincronizado	—	O Azure DevOps armazena etapas de teste como um campo XML que suas APIs REST não expõem como dados estruturados — essa é uma restrição da API do Azure DevOps, não uma limitação do Test Manager
Asserções	Não sincronizado	—	Não é possível sincronizar, de acordo com o pré-requisito dos Planos de Teste
Resultados da execução do teste	Test Manager/Orchestrator → Planos de teste do Azure DevOps	Execuções automatizadas rodam pelo Orchestrator e enviam resultados para o Plano de Teste do Azure vinculado	Não é possível definir as execuções como Concluídas no Azure DevOps — elas permanecem desbloqueadas para que os resultados possam continuar sincronizando em paralelo
Defects	Test Manager → Azure DevOps	É preciso criar manualmente a partir de logs da página de execução (Criar defeito)	Habilite apenas um conector por projeto para sincronização de defeitos por período

Gerenciar conexões do Azure DevOps

Editar uma conexão do Azure DevOps

Edite suas configurações de conexão.

1. Faça login no Test Manager como Administrator
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 Azure DevOps para expandir o painel.
5. Selecione Editar para configurar a conexão.
6. Selecione Salvar para confirmar.

Excluir uma conexão do Azure DevOps

Exclua a conexão selecionada e seus requisitos associados.

1. Faça login no Test Manager como Administrator
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 Azure DevOps para expandir o painel.
5. Selecione Excluir para remover a conexão.
6. Selecione Ok para confirmar.

Artigos relacionados

Sincronização de defeitos

Resultado

O projeto do Azure DevOps está conectado ao Test Manager. Os itens de trabalho são sincronizados como requisitos, e os defeitos criados no Test Manager são sincronizados de volta para o Azure DevOps.