Partilhar via

Vincular itens de trabalho a objetos

Serviços de DevOps do Azure | Azure DevOps Server 2022 - Azure DevOps Server 2019

Links de item de trabalho são associações entre dois itens de trabalho ou um item de trabalho e outro objeto. Os links descrevem a relação entre objetos. Você pode usar links de item de trabalho para rastrear dependências e trabalho relacionado para rastreabilidade, compartilhar informações, gerenciar projetos complexos que envolvem várias equipes ou produtos, controlar alterações de código, testes e muito mais.

Pré-requisitos

Categoria Requerimentos
Acesso ao projeto Membro do projeto.
Permissões - Membro do grupo de segurança Contributors ou Project Administrators.
- Para exibir ou modificar itens de trabalho: Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó permissões definidas como Permitir. Por padrão, o grupo de Colaboradores tem essa permissão definida como Permitir. Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.
- Para configurar as opções de integração para um pipeline de versão clássica: Editar permissões para a versão.
- Para vincular itens de trabalho a commits e pull requests: Editar itens de trabalho neste nó com permissões definidas como Permitir para o Caminho de Área atribuído ao item de trabalho. Por padrão, o grupo de Colaboradores tem essa permissão.
- Para visualizar itens de trabalho: Visualizar itens de trabalho neste nó com permissões definidas como permitir para o Caminho de Área atribuído ao item de trabalho.
Níveis de acesso Para adicionar ou modificar itens de trabalho: Pelo menos Stakeholder acessar. Os utilizadores com acesso Stakeholder para projetos públicos têm acesso total às funcionalidades de backlog e de quadros, tal como utilizadores com acesso ao Basic. Para obter mais informações, consulte a Referência rápida sobre o acesso de Partes Interessadas.
Iterações definidas Para usar o painel Planning, o administrador da sua equipa definiu caminhos de iteração (sprint) e configurou iterações de equipa.
Categoria Requerimentos
Acesso ao projeto Membro do projeto.
Permissões - Membro do grupo de segurança Contributors ou Project Administrators.
- Para exibir ou modificar itens de trabalho: Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó permissões definidas como Permitir. Por padrão, o grupo de Colaboradores tem essa permissão definida como Permitir. Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.
- Para configurar as opções de integração para um pipeline de versão clássica: Editar permissões para a versão.
- Para vincular itens de trabalho a commits e pull requests: Editar itens de trabalho neste nó com permissões definidas como Permitir para o Caminho de Área atribuído ao item de trabalho. Por padrão, o grupo de Colaboradores tem essa permissão.
- Para visualizar itens de trabalho: Visualizar itens de trabalho neste nó com permissões definidas como permitir para o Caminho de Área atribuído ao item de trabalho.
Níveis de acesso Para adicionar ou modificar itens de trabalho: Pelo menos Stakeholder acessar. Os utilizadores com acesso Stakeholder para projetos públicos têm acesso total às funcionalidades de backlog e de quadros, tal como utilizadores com acesso ao Basic. Para obter mais informações, consulte a Referência rápida sobre o acesso de Partes Interessadas.
Iterações definidas Para usar o painel Planning, o administrador da sua equipa definiu caminhos de iteração (sprint) e configurou iterações de equipa.

Os seguintes tipos de links ajudam a gerenciar as relações entre itens de trabalho e outros objetos.

Categoria do tipo de link Descrição
Construa Conecta um item de trabalho a um número de compilação, encontrado na compilação ou integrado na compilação.
Código Conecta um item de trabalho a uma ramificação, conjunto de alterações, confirmação, solicitação pull, tag ou item versionado.
GitHub Conecta um item de trabalho a uma ramificação, commit, problema ou pull request do repositório GitHub.
Trabalho remoto Conecta um item de trabalho definido noutra organização que ou consome, produz, ou está remotamente relacionado via URL.
Requisito Conecta um item de trabalho a um storyboard via URL.
Teste Conecta um item de trabalho a um anexo ou resultado de teste.
Wiki Conecta um item de trabalho a uma página wiki.
Item de trabalho Conecta um item de trabalho a aspetos do seu trabalho, incluindo:
- Afetado por
- Afeta
- Criança
- Duplicado
- Duplicado de
- Hiperligação
- Integrado na fase de lançamento
- Pai
- Antecessor
- Referenciado por
- Referências
- Relacionados
- Passos partilhados
- Sucessor
- Caso de teste
- Testado por
- Testes

Para obter mais informações sobre tipos de link de trabalho, incluindo tipos de link remoto, hiperlinks, arquivos anexados, pai/filho, relacionado e antecessor-sucessor, consulte Tipos de link de trabalho. Para obter uma lista de todos os tipos de link que você pode especificar usando o SLI do Azure DevOps, execute o comando az boards work-item relation list-type .

Você pode usar vários recursos para vincular ou modificar links que usam o tipo de link pai/filho . Alguns recursos dependem da versão do Azure DevOps que você está usando. Consulte as seguintes opções para gerenciar esses links:

Essas ferramentas oferecem flexibilidade para gerenciar links pai/filho com base em seu fluxo de trabalho e preferências.

Para adicionar um link para outro item de trabalho no portal da Web, execute as seguintes etapas:

  1. Abra o item de trabalho do qual você deseja vincular.

  2. No formulário de item de trabalho, você pode escolher entre duas maneiras de executar essa tarefa:

    • Vá para a seção Trabalho Relacionado e selecione Adicionar link>item existente.
    • Selecione Links>Adicionar link>Item existente.

    Captura de tela mostra a sequência de botões realçados para adicionar um link a um item de trabalho existente na guia Vínculos.

  3. Na lista suspensa Tipo de link, selecione o tipo de link que pretende criar, por exemplo,filho ,pai ourelacionado .

  4. No campo Itens de trabalho a vincular, insira o ID do item de trabalho ao qual deseja vincular ou selecione a partir do menu suspenso e, em seguida, selecione Adicionar ligação.

    O exemplo a seguir usa o tipo de link Related para um caso de teste com o ID 280.

    Captura de ecrã do diálogo Adicionar link, no portal web, a um item de trabalho existente.

    Você só pode adicionar links um de cada vez. Não é possível inserir seus IDs separados por vírgulas ou espaços.

    Para vincular a vários itens de trabalho, insira suas IDs separadas por vírgulas ou espaços. Se não souber os identificadores ou para associar a um item num projeto diferente, selecione Mais ações.

  1. Na descrição da sua solicitação pull, digite # para acionar o seletor de #ID item de trabalho. Uma lista exibe 50 itens de trabalho que você modificou recentemente ou que lhe foram atribuídos.

    Captura de tela da lista de itens de trabalho produzida ao inserir o símbolo # na descrição de RP.

  2. Para restringir a lista de itens de trabalho sugeridos, insira até cinco palavras-chave que correspondam ao tipo, ID ou título do item de trabalho.

    Captura de tela da inserção da palavra-chave após o símbolo # e do item de trabalho resultante na pesquisa.

Para obter mais informações, consulte Ligação a itens de trabalho a partir de solicitações pull, commits e comentários.

  1. No portal da Web, abra uma lista de pendências ou uma página de resultados da consulta.

  2. Para adicionar um link, selecione várias vezes (destaque) os itens de trabalho.

  3. Selecione Mais ações para os itens de trabalho selecionados, selecione Adicionar linke, em seguida, escolha Vincular a um item existente... ou Vincular a um novo item de trabalho....

    No exemplo a seguir, selecionamos múltiplos itens a partir da lista de pendências do produto e escolhemos Vincular a um item existente....

    Captura de tela do menu de contexto da lista de pendências, Seleção múltipla de itens na lista de pendências, menu de contexto aberto, escolha Adicionar link a um item de trabalho existente.

  4. Selecione do menu suspenso Tipo de ligação, por exemplo, Pai, Filhoou Relacionado.

  5. No campo Item de trabalho, insira a ID do item de trabalho ao qual você deseja vincular e selecione Adicionar link.

  1. No portal da Web, abra seu item de trabalho e selecione Links.

  2. Selecione Mais ações>Editar link.

    Captura de tela da guia Links, abra Mais ações, escolha a opção Editar link.

  3. Escolha o tipo de link para o qual alterar e, em seguida, selecione Salvar.

    Captura de ecrã da caixa de diálogo Editar ligação.

Execute as etapas a seguir para vincular um item de trabalho a um novo item de trabalho.

  1. No item de trabalho, selecione Links>Adicionar link>Novo item.

    Sequência de captura de tela para adicionar link de item novo ou existente ao item de trabalho.

  2. Especifique o Tipo de link e o Tipo de item de trabalho, e insira um título para o novo item de trabalho e um comentário opcional. Selecione Adicionar link.

    Captura de tela da caixa de diálogo Adicionar link, Link para novo item de trabalho.

    Abre-se o novo item de trabalho.

  3. Insira informações adicionais e Salve o item de trabalho.

    Captura de ecrã do novo item de trabalho Problema adicionado.

Execute as etapas a seguir para vincular itens de trabalho a objetos definidos em outras organizações do Azure DevOps. Você só poderá fazer isso se ambas as organizações usarem a mesma ID do Microsoft Entra para gerenciar usuários.

  1. No seu item de trabalho, selecione Links>Adicionar link>Item existente.

    Captura de tela mostra a sequência para adicionar link a um item de trabalho recém-criado.

  2. Escolha um dos seguintes tipos de link remoto no menu suspenso para Tipo de link:

    • Consome de ou produz para: quando se pretende controlar dependências de tarefas que são definidas em organizações diferentes e geridas por equipas diferentes.
    • Relacionado remotamente: quando os itens de trabalho que estão sendo vinculados são definidos em organizações diferentes e gerenciados por equipes diferentes, mas não têm interdependências fortes.

  3. Introduza o URL do item de trabalho remoto e, em seguida, selecione Adicionar ligação.

    O exemplo a seguir usa o tipo de link Remoto Relacionado para ligar ao item de trabalho ID 350 que existe na organização remotelinkingtest2, projeto RemoteLinking.

    Captura de tela mostrando a remoção de um link de item de trabalho.

    O separador de ligações mantém uma contagem de todas as ligações para o item de trabalho. O campo Contagem de Hiperligação Remota mantém uma contagem do número de hiperligações adicionadas a um item de trabalho que se vinculam a um item de trabalho definido noutro projeto ou organização.

    O exemplo a seguir mostra dois links remotos, indicados pelo ícone de nuvem, adicionados a uma história de usuário.

    Captura de ecrã do formulário User Story, separador Ligação, mostrando duas ligações externas.

Ao ligar os Painéis do Azure aos repositórios do GitHub, é possível associar itens de trabalho a um Ramo do GitHub, um Commit do GitHub, um Problema do GitHube um Pedido de Pull do GitHub. Você pode usar o GitHub para desenvolvimento de software enquanto usa os Painéis do Azure para planejar e acompanhar seu trabalho.

Importante

Você só pode vincular itens de trabalho a objetos do GitHub que tenham repositórios conectados aos Painéis do Azure. Para obter mais informações, consulte Conectar painéis do Azure ao GitHub e Vincular a itens de trabalho de solicitações pull, confirmações e comentários.

Para obter mais informações, consulte Vincular commits do GitHub, solicitações de pull requests, ramificações e problemas aos itens de trabalho e Concluir automaticamente itens de trabalho com pull requests.

  1. Em uma página de resultados de lista de pendências ou consulta, selecione várias vezes os itens de trabalho que você deseja vincular a uma nova ramificação do git.

  2. Selecione o ícone de ações e, em seguida, Novo ramo.... Para obter mais informações, consulte Associar itens de trabalho a objetos de desenvolvimento do Git.

    Captura de tela da lista de pendências, menu de contexto, escolha Vincular vários itens da lista de pendências a uma ramificação do git.

Execute as etapas a seguir para vincular itens de trabalho a compilações existentes. Essas compilações podem estar no seu projeto ou noutros projetos na sua organização ou coleção.

Nota

Esse recurso requer a instalação da atualização do Azure DevOps Server 2020.1. Para obter mais informações, consulte Azure DevOps Server 2020 Update 1 RC1 Release Notes, Boards.

  1. No seu item de trabalho, selecione Links>Adicionar link>Item existente.

  2. Na caixa de diálogo Adicionar link, escolha um dos tipos de vínculo de compilação: Compilação, Encontrado na compilação, Integrado na compilação. Especifique o número de build.

    O número de compilação é uma combinação do nome do pipeline e do nome da compilação. Se você não souber o número da compilação, selecione Localizar compilações.

    A captura de ecrã mostra o botão realçado

  3. Escolha os parâmetros para filtrar a sua pesquisa de builds.

    Para vincular a uma compilação em um projeto diferente, primeiro escolha o projeto cuja compilação você deseja vincular.

    Por exemplo, pode especificar um número de compilação, selecionar um pipeline de compilação ou um resultado de compilação, como Todos, bem-sucedido, parcialmente bem-sucedido, falhou ou cancelado. Ou, com Sucesso selecionado para Resultado, selecione Localizar builds para listar os builds disponíveis aos quais você pode vincular.

    Captura de tela da caixa de diálogo Localizar compilações com o projeto selecionado e as compilações listadas.

  4. Escolha a compilação da lista à qual deseja ligar e, em seguida, selecione Confirmar.

  5. Selecione Adicionar link para concluir a operação.

    Captura de ecrã da janela de diálogo

Ao desenvolver seu software, você pode capturar quais alterações de código e compilações dão suporte à conclusão de um item de trabalho. Sua equipe pode entender o trabalho que foi feito ou como um bug foi corrigido através da trilha de auditoria de alterações na base de código.

Os tipos de link usados para construir estes links são: Branch, Build, Changeset, Commit, Encontrado na build, Integrado na build, Pedido de Pull, Item com versão e Integrado no ambiente de lançamento. Esses tipos aparecem na imagem a seguir.

Imagem conceitual dos tipos de links DevOps.

Gorjeta

Impulsione o desenvolvimento a partir do item de trabalho ao criá-lo. Você também pode adicionar o identificador do item de trabalho ao criar ramificações, commits e pedidos de pull. O Git permite vincular itens de trabalho a commits usando o tipo de link Commit. Aqui estão as maneiras de fazê-lo:

  • Antes de confirmar as suas alterações, adicione IDs de itens de trabalho nas Alterações do Git em para o Visual Studio 2022 ou no Team Explorer em das versões anteriores do Visual Studio.

    Captura de tela mostrando a adição de ID de item de trabalho ou arrastar itens antes de confirmar alterações.

  • Use o comando git-commit e inclua o ID do item de trabalho em seu comentário. Por exemplo, aplique este comentário #35 Catch null exception ao seu commit. Quando você envia por push a confirmação, o sistema cria um link de confirmação entre a confirmação e o item de trabalho #35.

  • Use o controlo para desenvolvimento do Git a partir do item de trabalho. Para obter mais informações, consulte Impulsionar o desenvolvimento do Git a partir de um item de trabalho nos Painéis do Azure.

Conforme mostrado na imagem a seguir, o controle de implantação exibe informações sobre as liberações para dois estágios de lançamento. Inclui itens de trabalho vinculados a um commit ou pull request do Git para um pipeline de lançamento configurado para integração com o Azure Boards.

Captura de tela de vários ambientes que a versão está visando.

Controle de implantação

O controle de implantação fornece vários recursos para ajudá-lo a gerenciar e acompanhar o status de liberação de itens de trabalho. A lista a seguir descreve esses recursos:

  • Aparência padrão: O controle Deployment aparece nos formulários de item de trabalho para os tipos de item de trabalho User Story (Agile), Product Backlog Item (Scrum), Issue (Basic), Requirement (CMMI), Feature, Epic, Bug, Task e Test Case por padrão.

  • Tipos de item de trabalho personalizados: Os tipos de item de trabalho personalizados que usam o processo Herdado são habilitados automaticamente.

  • Informações de versão: O controlo de implantação mostra as informações de lançamento para duas fases do pipeline de lançamento integrado com o Azure Boards.

  • Itens de trabalho vinculados: Esse controle mostra apenas os itens de trabalho vinculados a uma solicitação de confirmação ou pull do Git para esse pipeline.

  • Visão visual: Obtenha informações visuais sobre o status de um item de trabalho à medida que ele é implantado em diferentes ambientes de liberação e navegue rapidamente para cada estágio de liberação e execução.

    Captura de ecrã do formulário de Item de Trabalho, Controlo de Implantação.

  • Associações de commits: Os itens de trabalho associados a commits no build mostram o status da release.

  • Escopo do projeto: Somente os itens de trabalho dentro do mesmo projeto são vinculados ao local onde o pipeline de liberação é definido.

    Captura de ecrã mostrando vários ambientes para os quais a versão está destinada.

  • Visibilidade das etapas: Ao abrir um item de trabalho, podem-se ver as fases em tempo real.

    Captura de tela dos estágios de configurações de versão, incluindo teste, preparação, produção e desenvolvimento.

Para preencher o controle de implantação, execute as seguintes etapas:

Nota

O controlo de implementação requer a configuração de um pipeline de lançamento clássico. Ele não suporta links para estágios de liberação definidos para um pipeline YAML.

  1. Defina um pipeline de lançamento Clássico e configure os estágios de lançamento conforme descrito em Defina o seu pipeline de implantação contínua (CD) de vários estágios.

  2. Configure o fluxo de trabalho.

  3. Vincule itens de trabalho a uma solicitação de confirmação ou pull no repositório Git do Azure Repos. Para obter mais informações, consulte:

  4. Executar o pipeline.

O Controle de Versão do Team Foundation (TFVC) permite que você vincule itens de trabalho a conjuntos de alterações de controle de versão ou arquivos de código-fonte versionados usando os tipos de link Changeset e Versioned Item. Quando Você guarda alterações pendentes ou usa O Meu Trabalho para guardar alterações, os itens de trabalho são automaticamente vinculados às alterações. Para obter mais informações, consulte Registar o seu trabalho.

Screenshot do Team Explorer, O Meu Trabalho, Alterações Pendentes, check-in.

Os tipos de link relacionados ao teste vinculam itens de trabalho de gerenciamento de casos de teste entre si ou a outros itens de trabalho. No portal da Web ou no Microsoft Test Manager, você pode exibir quais casos de teste são definidos para um conjunto de testes e quais pacotes de teste são definidos para um plano de teste. Esses objetos não são vinculados entre si por meio de tipos de link.

Você pode associar itens de trabalho a casos de teste usando os tipos de ligação Testado/Testado por. Use os mesmos controles de link que você usa para vincular itens de trabalho a outros itens de trabalho.

A imagem a seguir mostra o conjunto completo de tipos de link que se pode usar com tipos de itens de trabalho de gestão de testes. A maioria dos links entre objetos de gerenciamento de teste ocorre executando uma tarefa das páginas de teste ou do Microsoft Test Manager.

Captura de tela dos tipos de link usados para vincular objetos de teste.

Por exemplo, quando você adiciona Etapas Compartilhadas a um Caso de Teste, elas são vinculadas automaticamente usando os tipos de link Caso de Teste/Etapas Compartilhadas . Para obter mais informações, consulte Partilhar passos entre casos de teste.

Captura de tela do formulário de item de trabalho de teste mostrando as etapas.

Captura de ecrã da caixa de diálogo Inserir Passos Partilhados.

Na seção de teste , é possível adicionar planos de teste, conjuntos de testes e casos de teste, que são automaticamente vinculados. Não é possível adicionar esses itens por meio de um tipo de link específico. O sistema de teste cria e gerencia as associações de resultados de teste para casos de teste e planos de teste.

Você pode usar um hiperlink ou um tipo de ligação de storyboard para vincular um item de trabalho a um site, um recurso de rede ou a um documento em um recurso de rede. Ambos os tipos de link são unidirecionais. Para adicionar esses tipos de link, use os mesmos controles descritos anteriormente.

Ao usar o tipo de link storyboard, especifique um storyboard ou um documento que ofereça especificações dos itens de trabalho. Esse tipo de link permite que sua equipe acesse o arquivo compartilhado e adicione seus comentários.

Captura de ecrã do tipo de link Hiperlink ou Storyboard para associar um item de trabalho a um URL.

O Azure DevOps fornece várias maneiras de exibir dependências e acompanhar o trabalho relacionado:

  • Editor de Consultas: Você pode usar o Editor de Consultas para criar consultas personalizadas que mostram todos os itens de trabalho vinculados a um item de trabalho específico.
  • Listas de Pendências e Quadros: As visualizações Listas de pendências e Quadros mostram relações pai-filho entre itens de trabalho, permitindo que se vejam as dependências rapidamente.
  • Controlador de Dependência: O Controlador de Dependência é um relatório do Power BI que fornece uma representação visual das dependências entre itens de trabalho.

Para exibir a lista de todos os objetos vinculados a um item de trabalho, execute as seguintes etapas:

  1. Abra o item de trabalho e selecione Links. O separador ligações indica a contagem de todos os objetos vinculados. Os objetos vinculados são agrupados sob seu tipo de link, com uma contagem dentro de cada grupo.

    Captura de ecrã do separador Ligações com a contagem de objetos ligados.

  2. (Opcional) Expanda ou recolha cada grupo e classifique dentro de cada grupo por Estado, Atualização Mais Recente ou Comentário escolhendo o título da coluna correspondente.

    Por exemplo, a guia Links a seguir mostra uma parte dos 64 objetos vinculados para um item de trabalho.

    Captura de tela da guia Links com muitos objetos vinculados.

    Links precedidos pelo sinal de exclamação indicam que a compilação, versão ou outro objeto foi eliminado. Devido às políticas de retenção, esses objetos são excluídos automaticamente após um determinado período de tempo.

Consulta de itens de trabalho ligados

Para filtrar itens com base em links hierárquicos, use o tipo de consulta Árvore de itens de trabalho. Para filtrar itens com base em todos os tipos de link, use Itens de trabalho e links diretos.

Para localizar itens de trabalho vinculados a outros itens de trabalho com tipos de link específicos, use uma consulta que mostre um conjunto primário e um conjunto secundário de itens de trabalho:

  • O conjunto primário atende aos critérios de campo.
  • O conjunto secundário está ligado ao conjunto primário.

Não é possível consultar itens de trabalho em lançamentos, mas é possível consultar itens de trabalho com links externos. Para refinar a sua pesquisa, adicione mais filtros de consulta.

Para obter mais informações, consulte Consultar itens de trabalho por link ou contagem de anexos.

Não é possível construir uma consulta que mostre uma exibição hierárquica de Planos de Teste, Conjuntos de Testes e Casos de Teste. Esses itens não são vinculados usando Pai/Filho ou qualquer outro tipo de link. Você só pode visualizar a hierarquia através da página Test>Planos de Teste. Para obter mais informações, consulte Criar planos de teste e conjuntos de testes.

Execute as etapas a seguir para excluir um link de item de trabalho.

  1. Abra o item de trabalho.
  2. Selecione o separador Ligações para ver a lista de ligações.
  3. Selecione a ligação que pretende eliminar e, em seguida, selecione Remover ligação.
  4. Confirme que deseja excluir o link.

Depois que um item de trabalho é vinculado a um commit ou a um pull request, continua a aparecer como parte das fases da versão. Por exemplo, se você tiver um item de trabalho que não passou nos critérios de teste, convém removê-lo das compilações e versões.

Para eliminar o item de trabalho da participação em compilações e versões futuras, elimine o link para o commit mais recente e o pedido de pull.

Conteúdo relacionado