Vincular itens de trabalho a objetos

Azure DevOps Services | 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, que descrevem sua relação. 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.

• Vincular itens de trabalho a vários objetos
• Vincular itens de trabalho a outros itens de trabalho
• Vincular vários itens de trabalho
• Alterar o tipo de link de um link existente
• Vincular itens de trabalho a novos itens de trabalho
• Vincular itens de trabalho a itens de trabalho em diferentes projetos (entre organizações)
• Vincular itens de trabalho a pull requests
• Vincular itens de trabalho a objetos do GitHub
• Vincular vários itens a novos branches do Git
• Vincular itens de trabalho a builds
• Vincular itens de trabalho a implantações
• Vincular itens de trabalho ao desenvolvimento de código do TFVC
• Vincular itens de trabalho a testes
• Vincular itens de trabalho a um site, compartilhamento de rede, storyboard ou documento
• Exibir dependências e acompanhar o trabalho relacionado
• Consulta para itens de trabalho vinculados
• Usar a CLI do Azure para adicionar, remover ou mostrar links
• Excluir links de item de trabalho

Pré-requisitos

Pré-requisito	Descrição
Administrador do projeto ou membro colaborador	Você precisa ser adicionado a um projeto como membro do grupo de segurança Colaboradores ou Administradores de projeto.
Acesso de participante	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 Permitir permanentes em	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.

Quais tipos de vínculos existem?

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

Tipo de link	Column2
Hiperlink	Conecta um item de trabalho a qualquer URL ou compartilhamento de rede
Tipo de vínculo externo	Conecta um item de trabalho a um objeto externo, como um objeto de código, build ou página wiki
Tipo de vínculo de trabalho remoto	Conecta itens de trabalho definidos em diferentes organizações
Tipo de vínculo do GitHub	Conecta um item de trabalho a uma solicitação de confirmação, problema ou pull do repositório GitHub
Tipo de vínculo de trabalho	Vincula itens de trabalho, incluindo selecionar itens de trabalho de gerenciamento de caso de teste

Para obter mais informações sobre tipos de vínculo, incluindo pai/filho, relacionado, predecessor-sucessor e assim por diante, consulte Referência de tipo de vínculo/Tipos de vínculo de trabalho.

Vincular itens de trabalho a vários objetos

Para vincular itens de trabalho a vários objetos, execute as etapas a seguir.

1. No portal da Web, abra o item de trabalho do qual você deseja vincular ou crie um novo.
2. Selecione a guia Links e, em seguida, selecione Vincular.
3. Na lista suspensa tipo de vínculo, selecione o tipo de vínculo que você deseja criar.
4. No campo Vincular a, insira ou selecione o objeto ao qual você deseja vincular. Dependendo do tipo de link, você pode inserir ou selecionar os objetos a seguir. Selecione cada objeto para obter mais detalhes.
   • Outra ID ou título do item de trabalho
   • Uma URL de item de trabalho remoto
   • Uma URL de solicitação de pull do Git externo
   • Um número de build ou um nome de definição
   • Um nome de estágio de implantação ou um nome de ambiente
   • Uma PÁGINA da Web ou URL do documento
5. (Opcional) Insira um comentário para descrever o link.
6. Selecione OK para criar o link.

Dica

Há outros recursos que você pode usar para vincular ou alterar rapidamente links que usam o tipo de vínculo Pai/Filho (alguns recursos dependem da versão, consulte os artigos vinculados para obter detalhes).

• Para vincular itens da lista de pendências a itens da lista de pendências do portfólio ou alterar a estrutura de links entre esses itens, use o painel de mapeamento para organizar sua lista de pendências. Ou você pode optar por Mostrar Pais e arrastar e soltar itens dentro da hierarquia de árvore.
• Para criar e vincular tarefas a itens da lista de pendências, use a página de lista de pendências do sprint; no portal da Web, você também pode arrastar e soltar itens para alterar a estrutura do link.
• Para recuar (), recuar () e alterar a estrutura de vínculo de uma hierarquia de árvore, reparentar e reordenar itens de uma lista de pendências no portal da Web ou usar uma consulta de árvore no Team Explorer.
• Para adicionar ou excluir itens de trabalho ou alterar a estrutura de links, use o Excel. Confira Adicionar ou modificar itens de trabalho em massa com o Excel.

Vincular itens de trabalho a outros itens de trabalho

Execute as etapas a seguir para adicionar um vínculo a outra história de usuário, épica, recurso, bug, problema ou tarefa do portal da Web.

1. Abra o item de trabalho que você deseja vincular a outro item de trabalho.
2. No formulário do item de trabalho, selecione a seção Trabalho Relacionado.
3. Selecione Adicionar vínculo e, em seguida Item existente.
4. Na lista suspensa Tipo de vínculo, selecione o tipo de vínculo que você deseja criar (por exemplo, Pai, Filho, Relacionado e assim por diante).
5. No campo Item de trabalho, insira a ID do item de trabalho ao qual você deseja vincular e selecione OK. No exemplo a seguir usamos o tipo de link Relacionado para vincular três itens ao bug com a ID 400.

Você só pode adicionar um link de cada vez. Você não pode inserir suas IDs separadas por vírgulas ou espaços.

6. (Opcional) Se você estiver trabalhando na página Resultados da Consulta, salve em massa os itens de trabalho modificados. Quando você trabalha em uma lista de pendências, os itens de trabalho são salvos automaticamente.

Vincular vários itens de trabalho

1. No portal da Web, abra uma página de resultados de consulta ou lista de pendências e selecione vários itens de trabalho aos quais deseja adicionar um link.

2. Abra o menu de contexto ... de um dos itens de trabalho selecionados, escolha Adicionar link e escolha Item existente... ou Novo item....

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

Alterar o tipo de link de um link existente

1. No portal da Web, abra o item de trabalho e selecione Vínculos.

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

   

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

   

4. Salve o item de trabalho.

Vincular itens de trabalho a novos itens de trabalho

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

1. Especifique o tipo de link, o tipo de item de trabalho e o título do novo item de trabalho. Selecione OK. É aberto um item de trabalho do tipo selecionado.

   

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

   

3. (Opcional) Se você estiver trabalhando na página Resultados da Consulta, salve em massa os itens de trabalho que modificou.

Vincular itens de trabalho a itens de trabalho remotos (entre organizações)

As organizações que usam a Microsoft Entra ID podem vincular a itens de trabalho que existem em diferentes projetos entre organizações. Use os seguintes tipos de link, conforme indicado:

• Use os tipos de link Consome de/Produz para quando quiser rastrear dependências de itens de trabalho definidos em organizações diferentes e gerenciados por equipes diferentes.
• Use o tipo de link Remoto 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.

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. Escolha um dos seguintes tipos de link remoto:

   • Consome de/Produz para: quando quiser rastrear dependências de itens de trabalho definidos em organizações diferentes 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.

2. Na caixa de diálogo Adicionar vínculo, selecione o tipo de vínculo, insira a URL do item de trabalho remoto e selecione OK.

   No exemplo a seguir, usamos o tipo de link Remotamente relacionado para vincular à ID de item de trabalho 350, que existe na organização remotelinkingtest2, projeto RemoteLinking.

A guia de links mantém uma contagem de todos os links para o item de trabalho. O campo Contagem de Links Remotos mantém uma contagem do número de links adicionados a um item de trabalho que 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.

::: moniker-end

Vincular itens de trabalho a pull requests

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

   

2. Insira até cinco palavras-chave correspondentes ao tipo de item de trabalho, ID ou título para restringir a lista de itens de trabalho sugeridos.

   

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

Vincular itens de trabalho a objetos do GitHub

Ao conectar o Azure Boards com repositórios do GitHub, você pode vincular itens de trabalho a um de Confirmação do GitHub, Problemas do GitHub e Solicitação de Pull do GitHub. Dessa forma, você pode usar o GitHub para desenvolvimento de software enquanto usa o 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 e problemas do GitHub a itens de trabalho e Concluir automaticamente itens de trabalho com solicitações pull.

Vincular vários itens de trabalho a novos branches git

Em uma página de resultados de consulta ou de lista de pendências, selecionar vários itens de trabalho que você deseja vincular a um novo branch git, escolher o ícone de ações e, em seguida, Novo branch.... Para obter mais informações, confira Vincular itens de trabalho a objetos de desenvolvimento do Git.

Vincular itens de trabalho a builds

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

1. Na guia Vínculos de um item de trabalho, selecione Adicionar vínculo>Item existente.

2. Na caixa de diálogo Adicionar link, escolha um dos tipos de link de build – Build, Encontrado no build, Integrado no build – e especifique o número de build.

   Se você não souber o número de build (uma combinação do pipeline e do nome do build), poderá pesquisá-lo escolhendo o ícone .

   

3. Na caixa de diálogo Vincular builds, escolha os parâmetros para filtrar a 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 e 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.

   

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

5. Na caixa de diálogo Adicionar vínculo, selecione OK para concluir a operação.

   

Vincular itens de trabalho a implantações

Ao desenvolver software, você pode capturar quais alterações de código e builds dão suporte à conclusão de um item de trabalho. Dessa forma, sua equipe pode entender o trabalho 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, conforme ilustrado na imagem a seguir, são: Branch, Build, Conjunto de alterações, Commit, Encontrado no build, Integrado no build, PR, Item com controle de versão e Integrado no ambiente de lançamento.

Dica

Recomendamos que você conduza o desenvolvimento do item de trabalho no momento em que o criar. Você também pode adicionar a ID do item de trabalho ao criar branches, confirmações e solicitações de pull. O Git permite vincular itens de trabalho a confirmações usando o tipo de link Commit. Você pode fazer isso das seguintes maneiras.

• Adicione IDs de item de trabalho no Visual Studio Team Explorer antes de confirmar suas 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 impulsionar o desenvolvimento do git do item de trabalho.

Conforme mostrado na imagem a seguir, o controle Implantação mostra as informações de versão para duas fases de lançamento dos itens de trabalho que foram vinculados a uma solicitação de confirmação ou pull do Git para um pipeline de lançamento configurado para integração com Azure Boards.

Controle de implantação

Os formulários de item de trabalho fornecem dois controles para mostrar e ir rapidamente para objetos de desenvolvimento. O controle Implantação é descrito neste artigo e o controle desenvolvimento é descrito no desenvolvimento do Git de unidade de um item de trabalho.

O controle implantação é exibido por padrão nos formulários de item de trabalho para tipos de item de trabalho História do Usuário (Agile), Item de Pendência do Produto (Scrum), Problema (Básico), Requisito (CMMI), Recurso, Épico, Bug, Tarefa e Tipo de item de trabalho caso de teste. Ele também é habilitado automaticamente para tipos de item de trabalho personalizados que usam o processo Herdado. O controle Implantação exibe as informações de versão de dois estágios do pipeline de lançamento integrado ao Azure Boards. Esse controle mostra apenas os itens de trabalho que estão vinculados a uma solicitação de confirmação ou pull do Git para esse pipeline. Você também pode obter insights visuais sobre o status de um item de trabalho à medida que ele é implantado em diferentes ambientes de versão e ir rapidamente para cada estágio de lançamento e execução.

Itens de trabalho associados a confirmações no build mostram o status da versão. No entanto, somente os itens de trabalho dentro do mesmo projeto são vinculados ao local em que o pipeline de lançamento é definido.

Você pode ver os estágios em tempo real ao abrir um item de trabalho.

Para preencher o controle 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 conforme descrito em Configurar pipelines para dar suporte ao acompanhamento de trabalho, relatar status de implantação para o Boards.
3. Vincule itens de trabalho a uma solicitação de commit ou pull no repositório Git do Azure Repos. Para obter mais informações, consulte:
   • Impulsionar o desenvolvimento do Git por meio de um item de trabalho
   • Vincular a itens de trabalho a partir de outros objetos
4. Execute o pipeline.

Vincular itens de trabalho ao desenvolvimento de código do TFVC

O TFVC (Controle de Versão do Team Foundation) permite vincular itens de trabalho a conjuntos de alterações de controle de versão ou a arquivos de código-fonte com versão usando os tipos de link Conjunto de alterações e Item com controle de versão. Quando você faz check-in de alterações pendentes ou usa Meu Trabalho para verificar as alterações, os itens de trabalho são automaticamente vinculados às suas alterações.

Vincular itens de trabalho a testes

Os tipos de link relacionados ao teste vinculam itens de trabalho de gerenciamento de caso de teste uns aos outros ou a outros itens de trabalho. Usando o portal da Web ou o Microsoft Test Manager, é possível visualizar que casos de teste estão definidos para um conjunto de testes, e quais conjuntos de testes estão definidos para um plano de teste. Porém, esses objetos não estão vinculados uns aos outros 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, conforme descrito anteriormente.

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 das páginas de teste ou do Microsoft Test Manager.

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.

Em Teste, você pode adicionar planos de teste, conjuntos de testes e casos de teste, que são vinculados, mas não por meio de um tipo de link específico. Além disso, o sistema de teste cria e gerencia as associações de resultados de teste para casos de teste e planos de teste.

Vincular itens de trabalho a um site, compartilhamento de rede, storyboard ou documento

Você pode usar um tipo de vínculo de hiperlink ou Storyboard para vincular um item de trabalho a um site, compartilhamento de rede ou documento localizado em um compartilhamento de rede. Ambos os tipos de link são links unidirecionais. Para adicionar esses tipos de vínculo, use os mesmos controles descritos anteriormente para vincular itens de trabalho.

Ao usar o tipo de link do storyboard, você diferencia o link para especificar um storyboard ou documento que fornece especificações de item de trabalho. Use esse tipo de link para fornecer à equipe acesso ao arquivo compartilhado em que é possível adicionar comentários.

Exibir dependências e acompanhar o trabalho relacionado

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 exibições Backlogs e Boards mostram relações pai-filho entre itens de trabalho, permitindo que você veja as dependências rapidamente. • Rastreador de Dependência: o Rastreador de Dependências é 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 etapas a seguir.

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.

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.

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 vínculo 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 e 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 exemplos de consulta, confira Consultas de link e anexo.

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 exibir a hierarquia por meio da página Teste>Planos de Teste.

Usar a CLI do Azure para adicionar, remover ou mostrar links

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 é a fabrikam e a ID do projeto corresponde a cebd7ef5-4282-448b-9701-88c8637581b7. 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.

Vincular itens de trabalho

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

Sintaxe

Os parâmetros necessários incluem a ID do item de trabalho ao qual vincular e o tipo de link. Os tipos de link com suporte incluem Pai, Filho, Relacionado e Remoto Relacionado. Para ver uma lista de todos os tipos de link que você pode especificar, 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]

Exemplo

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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2805
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2807

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

Remover links de item de trabalho

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.

Sintaxe

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

Exemplo

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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2850
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2808
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2820
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2856
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2811
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2876
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2801
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2877
Child            https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2805 

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

Mostrar detalhes de links feitos para um só item de trabalho

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.

Sintaxe

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

Exemplo

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/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2932
Successor        https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2932
Remote Related   https://dev.azure.com/fabrikam-fiber5/847568d2-6541-4a99-a240-228510ccbff7/_apis/wit/workItems/1777
Parent           https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2930
Predecessor      https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_apis/wit/workItems/2933
Attached File    https://dev.azure.com/fabrikam/cebd7ef5-4282-448b-9701-88c8637581b7/_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.

Excluir links de item de trabalho

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

1. Abra o item de trabalho que tem links ou selecione-o em um resultado de consulta.
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 versão. 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.

Próximas etapas

Visualize o trabalho relacionado e outros objetos. Baixe a extensão de visualização de item de trabalho, disponível na guia Visual Studio Marketplace, Azure DevOps.

Artigos relacionados

• Referência de tipos de links
• Visão geral entre serviços
• Impulsionar o desenvolvimento do Git por meio de um item de trabalho
• Controlar dependências usando Planos de Entrega
• Usar o mapeamento para vincular itens de lista de pendências a recursos e épicos
• Modificar links em massa usando o Excel