Compartilhar via

Vincular itens de trabalho a objetos

  • Artigo

Azure DevOps Services | Azure DevOps Server 2022 - Azure DevOps Server 2019

Os 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 controlar dependências e trabalho relacionado para rastreabilidade, compartilhar informações, gerenciar projetos complexos que envolvem várias equipes ou produtos, acompanhar alterações de código, testes e muito mais.

Pré-requisitos

Pré-requisito Descrição
administrador do projeto ou membro colaborador Membro do projeto membro do grupo de segurança Colaboradores ou Administradores do projeto .
Acesso dos stakeholders Para adicionar ou modificar itens de trabalho, você precisa receber acesso de Stakeholder ou superior. Os usuários com acesso de Stakeholder a projetos públicos têm acesso completo aos recursos de lista de pendências e quadro, assim como os usuários com acesso Básico. Para mais informações, veja Referência rápida de acesso das partes interessadas.
Membro colaborador ou permissões Permitir Para exibir ou modificar itens de trabalho, você precisar ter as permissões de Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó definidas como Permitir. Por padrão, o grupo Colaboradores tem essa permissão definida como Permitir. Para obter mais informações, consulte Definir permissões e acesso para controle de trabalho.
- Para configurar as opções de integração para um pipeline de versão clássica, você deve ter permissões para editar a versão.
- Para vincular itens de trabalho a confirmações e solicitações de recebimento, você deve ter suas permissões Editar itens de trabalho neste nó definidas como Permitir para o Caminho da Área atribuído ao item de trabalho. Por padrão, o grupo Colaboradores tem esse conjunto de permissões.
- Para exibir itens de trabalho, você deve ter suas permissões Exibir itens de trabalho neste nó definidas como Permitir para o Caminho de Área atribuído ao item de trabalho.
Iterações definidas Para usar o painel Planejamento, o administrador da equipe deve definir caminhos de iteração (sprint) e configurar iterações de equipe.
Pré-requisito Descrição
administrador do projeto ou membro colaborador Membro do projeto membro do grupo de segurança Colaboradores ou Administradores do projeto .
Acesso dos stakeholders Para adicionar ou modificar itens de trabalho, você precisa receber acesso de Stakeholder ou superior.
Membro colaborador ou permissões Permitir Para exibir ou modificar itens de trabalho, você precisar ter as permissões de Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó definidas como Permitir. Por padrão, o grupo 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 lançamento clássico, você deve ter permissões para editar a versão.
- Para vincular itens de trabalho a commits e solicitações de pull, você precisa ter as permissões Editar itens de trabalho neste nó definidas como Permitir para o Caminho da Área atribuído ao item de trabalho. Por padrão, o grupo Colaboradores tem esse conjunto de permissões.
- Para exibir itens de trabalho, você precisa ter as permissões Exibir itens de trabalho neste nó definidas como Permitir para o Caminho da Área atribuído ao item de trabalho.
Iterações definidas Para usar o painel Planejamento, o administrador da equipe deve definir caminhos de iteração (sprint) e configurar iterações de equipe.
Pré-requisito Descrição
administrador do projeto ou membro colaborador Membro do projeto membro do grupo de segurança Colaboradores ou Administradores do projeto .
Acesso dos stakeholders Para adicionar ou modificar itens de trabalho, você precisa receber acesso de Stakeholder ou superior.
Membro colaborador ou permissões Permitir Para exibir ou modificar itens de trabalho, você precisar ter as permissões de Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó definidas como Permitir. Por padrão, o grupo Colaboradores tem essa permissão definida como Permitir. Para obter mais informações, consulte Definir permissões e acesso para acompanhamento de trabalho.
Iterações definidas Para usar o painel Planejamento, o administrador da equipe deve definir caminhos de iteração (sprint) e configurar iterações de equipe.

Os tipos de vínculos a seguir ajudam você a gerenciar as várias relações entre itens de trabalho e outros objetos.

Categoria de tipo de link Descrição
Build Conecta um item de trabalho a um número de build, encontrado no build ou integrado no build.
Código Conecta um item de trabalho a um branch, conjunto de alterações, confirmação, solicitação de pull, marca ou item com versão.
GitHub Conecta um item de trabalho a um branch do repositório GitHub, commit, problema ou solicitação de pull.
trabalho remoto Conecta um item de trabalho definido em uma organização diferente que 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 de teste ou resultado.
Wiki Conecta um item de trabalho a uma página wiki.
Trabalho Conecta um item de trabalho a vários aspectos do seu trabalho, incluindo:
- Afetado por
- Afeta
-Criança
- Duplicata
- Duplicata de
-Hiperlink
– Integrado no estágio de lançamento
-Pai
- Antecessor
- Referenciado por
-Referências
-Relacionado
– Etapas compartilhadas
- Sucessor
- Caso de teste
- Testado por
-Testes

Para obter mais informações sobre tipos de vínculo de trabalho, incluindo pai/filho, relacionados e predecessor-sucessor, consulte Tipos de link de trabalho.

Para vincular itens de trabalho a vários objetos, siga estas etapas gerais:

  1. Entre em sua organização (https://dev.azure.com/{Your_Organization}).

  2. Abra o item de trabalho existente do qual você deseja vincular ou crie um novo.

  3. Selecione Links>Adicionar link, e então selecione Item existente ou Novo item.

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

  4. Na lista suspensa Tipo de link selecione o tipo de link que deseja criar.

  5. No campo a seguir, insira ou selecione o objeto ao qual você deseja vincular.

  6. (Opcional) Insira um comentário para descrever o link.

  7. Selecione Adicionar link para criar o link.

Para obter instruções mais específicas sobre como vincular diferentes tipos de itens de trabalho, consulte as seções a seguir.

Dica

Você pode usar outros recursos para vincular ou alterar links que usam o tipo de link Pai/Filho . Alguns recursos dependem da versão. Para obter mais informações, consulte os seguintes artigos:

Para adicionar um link a 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 do item de trabalho, você pode escolher entre duas maneiras de fazer essa tarefa:

    • Vá para a seção de 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 da guia Links.

  3. Na lista suspensa Tipo de link selecione o tipo de link que você deseja criar, por exemplo, Filho, Pai ou Relacionados.

  4. No campo Itens de trabalho para vincular, insira o ID do item de trabalho ao qual você deseja vincular ou escolha no menu suspenso, e selecione Adicionar link.

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

    Captura de tela da caixa de diálogo Adicionar link, portal da Web, a um item de trabalho existente.

    Você só pode adicionar um link de cada vez. Você não pode inserir suas IDs separadas 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 você não souber as IDs ou \quiser vincular a um item em um projeto diferente, selecione Mais ações.

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

  2. Seleção múltipla (destaque) dos itens de trabalho para adicionar um link.

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

    No exemplo a seguir, selecionamos várias opções na lista de pendências do produto e escolhemos o Link para um item existente....

    Captura de tela do menu de contexto da lista de pendências, Selecionar vários itens na lista de pendências, abrir menu de contexto, escolher Adicionar link a um item de trabalho existente.

  4. Selecione no menu suspenso tipo de Link, por exemplo, Pai, Filho ou Relacionado.

  5. No campo do 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 o item de trabalho e selecione Vínculos.

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

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

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

    Captura de tela da caixa de diálogo Editar link.

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 um 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.

    Um novo item de trabalho foi aberto.

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

    Captura de tela do novo item de trabalho com 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 Microsoft Entra ID para gerenciar usuários.

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

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

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

    • Consome de ou Produz para: Quando você deseja controlar dependências de itens de trabalho definidos em diferentes organizações e gerenciados por equipes diferentes.
    • Remotamente relacionado: quando os itens de trabalho que estão sendo vinculados forem definidos em organizações diferentes e gerenciados por equipes diferentes, mas não tiverem dependências fortes.

  3. Insira a URL do item de trabalho remoto e selecione Adicionar link.

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

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

    A guia de links mantém uma contagem de todos os links para o item de trabalho. O campo Contagem de Links Remotosmantém uma contagem do número de links adicionados a um item de trabalho que se vinculam a um item de trabalho definido em outro 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 tela do formulário História de Usuário, guia Link, mostrando dois links externos.

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

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

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

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

Para obter mais informações, consulte Vínculo para itens de trabalho de solicitações de pull, confirmações e comentários.

Ao conectar o Azure Boards com repositórios do GitHub, você pode vincular itens de trabalho a um GitHub Branch, Commit do GitHub, Issue do GitHube Pull Request do GitHub. Você pode usar o GitHub para desenvolvimento de software enquanto usa Azure Boards para planejar e acompanhar seu trabalho.

Ao conectar o Azure Boards com repositórios do GitHub, você pode vincular itens de trabalho a um Confirmação do GitHub e Solicitação de pull do GitHub. Você pode usar o GitHub para desenvolvimento de software enquanto usa Azure Boards para planejar e acompanhar seu trabalho.

Importante

Você só pode vincular itens de trabalho a objetos do GitHub que têm repositórios conectados ao Azure Boards. Para obter mais informações, consulte Conectar o Azure Boards ao GitHub e Vincular a itens de trabalho de solicitações de pull, confirmações e comentários.

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

  1. A partir de uma página de resultados de consulta ou de lista de pendências, selecione vários itens de trabalho que você deseja vincular a um novo git branch.

  2. Selecione o ícone de ações e, em seguida, nova ramificação.... Para obter mais informações, consulte Vincular itens de trabalho a objetos de desenvolvimento do Git.

    Captura de tela da lista de pendências, menu de contexto, escolher Vincular vários itens de lista de pendências a um branch Git.

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

Observação

Esse recurso requer a instalação do Azure DevOps Server atualização 2020.1. Para obter mais informações, consulte Notas de versão do Azure DevOps Server 2020 Atualização 1 RC1, Quadros.

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

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

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

    A captura de tela mostra o botão destacado, Localizar builds.

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

    Para vincular a um build em um projeto diferente, primeiro escolha o Projeto cujo build você deseja vincular.

    Por exemplo, você pode especificar um número de build, selecionar um pipeline de build ou um resultado de build, como Todos, bem-sucedido, parcialmente bem-sucedido, com falha ou cancelado. Ou, com Concluído 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 o build na lista à qual você deseja vincular e selecione Confirmar.

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

    Captura de tela da caixa de diálogo Adicionar link com o número da compilação inserido.

Você pode vincular itens de trabalho a builds existentes na caixa de diálogo Adicionar link.

  1. Na guia Links de um item de trabalho, escolha Adicionar link>Item existente.

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

    O número de build é uma combinação do pipeline e do nome do build. Se você não souber o número da compilação, procure-o escolhendo o ícone.

    Captura de tela da caixa de diálogo Adicionar link com a opção Criar tipo de link selecionada.

  3. Na caixa de diálogo Vincular builds, escolha os parâmetros para filtrar a pesquisa de builds.

    Por exemplo, você pode especificar um número de build, selecionar um pipeline de build ou um resultado de build, como Todos, bem-sucedido, parcialmente bem-sucedido, com falha ou cancelado. Ou, com Todos selecionado para Resultado, escolha Localizar para listar os builds disponíveis para vincular.

    Captura de tela da caixa de diálogo Localizar compilações, link para uma compilação no seu projeto.

  4. Escolha o build na lista à qual você deseja vincular e selecione OK.

  5. Na caixa de diálogo Adicionar link, escolha OK para concluir a operação.

    Captura de tela da caixa de diálogo Adicionar link com o número da compilação inserido.

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

Os tipos de link usados para construir esses links são: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item e Integrated in release environment. Esses tipos aparecem na imagem a seguir.

Imagem conceitual dos tipos de links de devops.

Dica

Impulsione o desenvolvimento a partir do item de trabalho quando você o criar. Você também pode adicionar o ID do item de trabalho ao criar branches, commits e solicitações de pull. O Git permite vincular itens de trabalho a commits usando o tipo de link Commit. Aqui estão as maneiras de fazer isso:

  • Antes de confirmar suas alterações, adicione IDs de item de trabalho no Git Changes para o Visual Studio 2022 ou no Team Explorer para versões anteriores do Visual Studio.

    Captura de tela para adicionar o ID do item de trabalho ou arrastar itens antes de confirmar as alterações.

  • Use o comando git-commit e inclua a ID do item de trabalho em seu comentário. Por exemplo, aplique esse comentário #35 Catch null exception à sua confirmação. Quando você efetua push do commit, o sistema cria um link Commit entre o commit e o item de trabalho nº 35.

  • Use o controle Desenvolvimento para o desenvolvimento do Git a partir do item de trabalho. Para obter mais informações, consulte Conduzir o desenvolvimento do Git de um item de trabalho em Azure Boards.

Conforme mostrado na imagem a seguir, o controle de implantação exibe informações de versão para dois estágios de versão. Ele inclui itens de trabalho vinculados a uma confirmação ou solicitação de pull do Git para um pipeline de lançamento configurado para integração com o Azure Boards.

Captura de tela de vários ambientes direcionados à versão.

Controle de implantação

O controle de Implantação fornece várias funcionalidades que auxiliam no gerenciamento e acompanhamento do status de liberação dos itens de trabalho. A lista a seguir descreve estes recursos:

  • Aparência padrão: por padrão, o controle Implantar aparece nos formulários de item de trabalho para os tipos de item de trabalho História de Usuário (Agile), Item do Backlog do Produto (Scrum), Problema (Básico), Requisito (CMMI), Recurso, Épico, Bug, Tarefa e Caso de Teste.

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

  • Informações de versão: O controle de implantação mostra as informações de versão de dois estágios do pipeline de release integrado ao Azure Boards.

  • itens de trabalho vinculados: esse controle mostra apenas os itens de trabalho que estão vinculados a um commit ou solicitação de pull do Git para esse pipeline.

  • Insight visual: obtenha insight visual sobre o status de um item de trabalho à medida que ele é implantado em diferentes ambientes de lançamento e navegue rapidamente para cada estágio de lançamento e execução.

    Captura de tela do formulário Item de trabalho, controle Implantação.

  • Associações commit: Itens de trabalho associados a commits no build mostram o status da versão.

  • Escopo do projeto: Somente os itens de trabalho no mesmo projeto são vinculados ao local em que o pipeline de lançamento é definido.

    Captura de tela mostrando vários ambientes direcionados à versão.

  • Visibilidade do estágio: ao abrir um item de trabalho, você pode ver os estágios 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:

Observação

O controle Implantação requer a configuração de um pipeline de lançamento clássico. Ele não dá suporte à vinculação a estágios de lançamento 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 Definir seu pipeline de CD (implantação contínua) de vários estágios.

  2. Configure o pipeline.

  3. Vincule itens de trabalho a uma solicitação de commit ou pull no repositório Git do Azure Repos. Para saber mais, veja:

  4. Execute o pipeline.

O Controle de Versão do Team Foundation (TFVC) permite vincular itens de trabalho a conjuntos de alterações de controle de versão ou a arquivos de código-fonte com controle de versão usando os tipos de links Conjunto de alterações e Controle de versão. Quando você registra alterações pendentes ou usa Meu Trabalho para registrar as alterações, os itens de trabalho são automaticamente vinculados às suas alterações. Para obter mais informações, consulte Fazer check-in do seu trabalho.

Captura de tela de Team Explorer, Meu Trabalho, Alterações Pendentes, check-in.

Os tipos de link relacionados a testes conectam itens de trabalho de gerenciamento de casos de teste entre si ou a outros itens de trabalho. No portal da Web ou no Gerenciador de Testes da Microsoft, você pode exibir quais casos de teste são definidos para um conjunto de testes e quais conjuntos de testes 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 vincular itens de trabalho a casos de teste usando os tipos de link Testado/Testado por . Use os mesmos controles de link que você usa para vincular itens de trabalho a outros itens de trabalho. Consulte Vincular itens de trabalho.

A imagem a seguir mostra o conjunto completo de tipos de link que você pode usar com tipos de item de trabalho de gerenciamento de teste. A maioria dos links entre objetos de gerenciamento de teste ocorre executando uma tarefa nas páginas de teste ou no 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 vínculo Caso de Teste/Etapas Compartilhadas. Para obter mais informações,confira Compartilhar etapas entre casos de teste.

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

Captura de tela da caixa de diálogo Inserir Etapas Compartilhadas.

Na seção Test, você pode adicionar planos de teste, conjuntos de testes e casos de teste, que são vinculados automaticamente. 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 link de storyboard para vincular um item de trabalho a um site, compartilhamento de rede ou documento em um compartilhamento de rede. Ambos os tipos de link são links unidirecionais. Para adicionar esses tipos de link, use os mesmos controles descritos anteriormente. Consulte Vincular itens de trabalho.

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

Captura de tela do tipo de link Hiperlink ou Storyboard para vincular 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 de listas de pendências e quadros mostram as relações pai-filho entre os itens de trabalho, permitindo que você veja as dependências em um relance.
  • Dependency Tracker: O Dependency Tracker é um relatório do Power BI que fornece uma representação visual de 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. A guia links indica a contagem de todos os objetos vinculados. Os objetos vinculados são agrupados em seu tipo de vínculo, com uma contagem dentro de cada grupo.

    Captura de tela da guia Links com contagem de objetos vinculados.

  2. (Opcional) Expanda ou recolher 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 com o ponto de exclamação indicam que o build, a versão ou outro objeto foi excluído. Devido às políticas de retenção, esses objetos são excluídos automaticamente após um determinado período de tempo.

Consultar itens de trabalho vinculados

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 vínculo, use Itens de trabalho e vínculos diretos.

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

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

Você não pode consultar itens de trabalho em versões, mas pode consultar itens de trabalho com links externos. Adicione mais filtros de consulta para refinar sua pesquisa.

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

Não é possível criar 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 tipos de link Pai/Filho nem outro tipo de link. Você só pode visualizar a hierarquia por meio da página Testar>Planos de Teste. Para obter mais informações, consulte Criar planos de teste e conjuntos de testes.

Você pode adicionar, remover e mostrar detalhes de links para um item de trabalho com o comando az boards work-item relation. Para obter mais informações, consulte Introdução à CLI do Azure DevOps.

Os tipos de link incluem tipos de link de trabalho, tipos de link remoto, hiperlinks e arquivos anexados. Para ver uma lista de todos os tipos de link que você pode especificar, execute o comando az boards work-item relation list-type.

az boards work-item relation add
az boards work-item relation remove
az boards work-item relation show

Nos exemplos a seguir, a organização é fabrikam e a ID do projeto corresponde a aaaaaaaa-0000-1111-2222-bbbbbbbbbbbbbb. O formato de tabela é usado para mostrar a saída. Para conhecer outros formatos, confira Formatos de saída para comandos da CLI do Azure.

Para vincular um ou mais itens de trabalho a um único item de trabalho, insira o comando az boards work-item relation add.

Os parâmetros necessários incluem a ID do item de trabalho ao qual vincular e o tipo de link. Os tipos de link suportados incluem Pai, Filho, Relacionado e Relacionado Remoto. Para obter uma lista de todos os tipos de link, execute o comando az boards work-item relation list-type .

Para itens de trabalho definidos na mesma organização, especifique a ID do item de trabalho ou a URL de destino. Para itens de trabalho definidos em uma organização remota, especifique a URL de destino. Você pode especificar vários valores separando IDs ou URLs com vírgulas.

az boards work-item relation add --id
                                 --relation-type
                                 [--detect {false, true}]
                                 [--org]
                                 [--target-id]
                                 [--target-url]

O comando a seguir vincula o item de trabalho ID=2807 ao item de trabalho ID=2794 com o tipo de link Filho. O comando retorna uma lista de todos os links definidos atualmente para o item de trabalho.

az boards work-item relation add --id 2794 --relation-type Child --target-id 2856 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2807

Para exibir as informações dos itens de trabalho vinculados, insira uma das URLs listadas no navegador.

Para remover um ou mais itens de trabalho vinculados de um só item de trabalho, insira o comando az boards work-item relation remove.

Os parâmetros necessários incluem a ID do item de trabalho do qual remover o link e o tipo de link. Você só pode remover links para itens de trabalho definidos na mesma organização. Você pode especificar qualquer um dos tipos de link com suporte, exceto por tipos de link remoto.

Especifique a ID do item de trabalho de destino. Você pode especificar vários valores separando IDs ou URLs com vírgulas.

az boards work-item relation remove --id
                                    --relation-type
                                    --target-id
                                    [--detect {false, true}]
                                    [--org]
                                    [--yes]

O comando a seguir remove o link para o item de trabalho ID=2794 do item de trabalho ID=2856 para o item de trabalho com o tipo de link Filho. O comando retorna uma lista de todos os links definidos atualmente para o item de trabalho.

az boards work-item relation remove --id 2794 --relation-type Child --target-id 2807 --output table
Are you sure you want to remove this relation(s)? (y/n): y
Relation Type    Url
---------------  -------------------------------------------------------------------------------------------------
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2805

Para exibir as informações dos itens de trabalho vinculados, insira uma das URLs listadas no navegador.

Para exibir os itens de trabalho vinculados a um só item de trabalho, insira o comando az boards work-item relation show. Para ver uma lista de todos os tipos de link que podem ser retornados, execute o comando az boards work-item relation list-type.

az boards work-item relation show --id
                                  [--detect {false, true}]
                                  [--org]

O comando a seguir lista os detalhes dos links definidos para o item de trabalho ID=2931 na organização fabrikam no formato de tabela.

az boards work-item relation show --id 2931 --output table
Relation Type    Url
---------------  -----------------------------------------------------------------------------------------------------------------------------------
Related          https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/bbbbbbbb-1111-2222-3333-cccccccccccc/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb/_apis/wit/attachments/1cc6c026-b4ed-420c-bfe6-065be726cba7

Para exibir as informações dos itens de trabalho vinculados, insira uma das URLs listadas no navegador. Escolha a URL de um arquivo anexado para baixar o anexo.

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

  1. Abra o item de trabalho.
  2. Selecione a guia Links para ver a lista de links.
  3. Selecione o link que você deseja excluir e, em seguida, selecione Remover link.
  4. Confirme se deseja excluir o link.

Depois que um item de trabalho é vinculado a uma solicitação de confirmação ou pull, ele continua a aparecer como parte dos estágios de lançamento. Por exemplo, se você tiver um item de trabalho que não passou nos critérios de teste, talvez queira removê-lo dos builds e versões.

Para remover o item de trabalho de participar de versões e builds futuros, exclua o link para a solicitação de commit e pull mais recente.