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, que descrevem sua relação. 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.
- 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 projetos diferentes (entre organizações)
- Vincular itens de trabalho para receber solicitações
- Vincular itens de trabalho a objetos do GitHub
- Vincular vários itens a novas ramificações do Git
- Vincular itens de trabalho a compilações
- Link work items to deployments (Ligar itens de trabalho a implementações)
- Vincular itens de trabalho ao desenvolvimento de código 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 de itens de trabalho vinculados
- Usar a CLI do Azure para adicionar, remover ou mostrar links
- Excluir links de item de trabalho
Neste artigo, saiba como executar as seguintes tarefas:
- 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 para receber solicitações
- Vincular itens de trabalho a objetos do GitHub
- Vincular vários itens a novas ramificações do Git
- Vincular itens de trabalho a compilações
- Link work items to deployments (Ligar itens de trabalho a implementações)
- Vincular itens de trabalho ao desenvolvimento de código 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 de 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 | Description |
---|---|
Administrador de Projeto ou Membro Colaborador | Você deve ser adicionado a um projeto como membro do grupo de segurança Colaboradores ou Administradores de Projeto. |
Acesso das partes interessadas | Para adicionar ou modificar itens de trabalho, você deve ter acesso de Stakeholder ou superior. Os usuários com acesso de partes interessadas para projetos públicos têm acesso total aos recursos de lista de pendências e quadro, como usuários com acesso Básico . Para obter mais informações, veja Referência rápida sobre o acesso de Interveniente. |
Membro contribuidor ou Permitir permanentes em | - Para exibir ou modificar itens de trabalho, você deve ter suas permissões Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó 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 Classic, você deve ter permissões para editar a versão. - Para vincular itens de trabalho a confirmações e solicitações pull, você deve ter suas permissões de Editar itens de trabalho neste nó definidas como Permitir para o Caminho de Área atribuído ao item de trabalho. Por padrão, o grupo de 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 | Description |
---|---|
Administrador de Projeto ou Membro Colaborador | Você deve ser adicionado a um projeto como membro do grupo de segurança Colaboradores ou Administradores de Projeto. |
Acesso das partes interessadas | Para adicionar ou modificar itens de trabalho, você deve ter acesso de Stakeholder ou superior. |
Membro contribuidor ou Permitir permanentes em | - Para exibir ou modificar itens de trabalho, você deve ter suas permissões Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó 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 Classic, você deve ter permissões para editar a versão. - Para vincular itens de trabalho a confirmações e solicitações pull, você deve ter suas permissões de Editar itens de trabalho neste nó definidas como Permitir para o Caminho de Área atribuído ao item de trabalho. Por padrão, o grupo de 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 | Description |
---|---|
Administrador de Projeto ou Membro Colaborador | Você deve ser adicionado a um projeto como membro do grupo de segurança Colaboradores ou Administradores de Projeto. |
Acesso das partes interessadas | Para adicionar ou modificar itens de trabalho, você deve ter acesso de Stakeholder ou superior. |
Membro contribuidor ou Permitir permanentes em | Para exibir ou modificar itens de trabalho, você deve ter suas permissões Exibir itens de trabalho neste nó e Editar itens de trabalho neste nó 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. |
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. |
Que tipos de links existem?
Os seguintes tipos de links ajudam a gerenciar as várias relações entre itens de trabalho e outros objetos.
Tipo de ligação | Column2 |
---|---|
Hiperligação | Conecta um item de trabalho a qualquer URL ou compartilhamento de rede |
Tipo de link externo | Conecta um item de trabalho a um objeto externo, como um objeto de código, compilação ou página wiki |
Tipo de link de trabalho remoto | Conecta itens de trabalho definidos em diferentes organizações |
Tipo de link do GitHub | Conecta um item de trabalho a uma solicitação de confirmação, emissão ou pull do repositório GitHub |
Tipo de link de trabalho | Vincula itens de trabalho, incluindo itens de trabalho de gerenciamento de casos de teste selecionados |
Para obter mais informações sobre tipos de link, incluindo pai/filho, relacionado, antecessor-sucessor e assim por diante, consulte Referência de tipo de link/Tipos de link de trabalho.
Vincular itens de trabalho a vários objetos
Para vincular itens de trabalho a vários objetos, execute as etapas a seguir.
- No portal da Web, abra o item de trabalho do qual deseja vincular ou crie um novo.
- Selecione a guia Links e, em seguida, selecione Vincular a.
- Na lista suspensa Tipo de link, selecione o tipo de link que você deseja criar.
- No campo Vincular a, insira ou selecione o objeto ao qual deseja vincular. Dependendo do tipo de link, você pode inserir ou selecionar os seguintes objetos. Selecione cada objeto para obter mais detalhes.
- (Opcional) Insira um comentário para descrever o link.
- Selecione OK para criar a ligação.
Gorjeta
Há outros recursos que você pode usar para vincular ou alterar rapidamente links que usam o tipo de link Pai/Filho (alguns recursos dependem da versão, consulte os artigos vinculados para obter detalhes).
- Para vincular itens da lista de pendências aos itens da lista de pendências do portfólio ou para alterar a estrutura do link 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 para fora () e alterar a estrutura de link de uma hierarquia de árvore, reparente e reordene itens de uma lista de pendências no portal da Web ou use uma consulta de árvore no Team Explorer.
- Para adicionar ou excluir itens de trabalho ou alterar a estrutura do link, você pode usar o Excel. Consulte 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 link para outra história de usuário, épico, recurso, bug, problema ou tarefa do portal da Web.
- Abra o item de trabalho que você deseja vincular a outro item de trabalho.
- No formulário de item de trabalho, selecione a seção Trabalho Relacionado.
- Selecione Adicionar link e, em seguida , Item existente.
- Na lista suspensa Tipo de link, selecione o tipo de link que deseja criar (por exemplo, Pai, Filho, Relacionado e assim por diante).
- 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 ID de 400.
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 você não souber as IDs ou quiser vincular a um item em um projeto diferente, selecione Mais ações.
- (Opcional) Se estiver a trabalhar a partir da página Resultados da Consulta, guarde em massa os itens de trabalho que modificou. Quando você trabalha a partir de uma lista de pendências, os itens de trabalho são salvos automaticamente.
Vincular vários itens de trabalho
No portal da Web, abra uma página de resultados de lista de pendências ou consulta e selecione vários itens de trabalho aos quais deseja adicionar um link.
Abra o menu de contexto ... de um dos itens de trabalho selecionados, escolha Adicionar link e, em seguida, escolha Item existente... ou Novo item....
No exemplo a seguir, selecionamos várias vezes a partir da lista de pendências do produto e escolhemos Item existente....
Alterar o tipo de link de um link existente
No portal da Web, abra seu item de trabalho e selecione Links.
Selecione Mais ações>Editar link.
Escolha o tipo de link para o qual alterar e, em seguida, selecione Salvar.
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.
Especifique o tipo de link, o tipo de item de trabalho e o título do novo item de trabalho. Selecione OK. Um item de trabalho do tipo selecionado é aberto.
Insira informações adicionais e Salve o item de trabalho.
(Opcional) Se estiver a trabalhar a partir da página Resultados da Consulta, guarde em massa os itens de trabalho que modificou.
Vincular itens de trabalho a itens de trabalho remoto (entre organizações)
As organizações que usam o 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 controlar dependências de itens de trabalho definidos em organizações diferentes e gerenciados por equipes diferentes.
- Use o tipo de link Relacionado Remoto 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 interdependê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 ID do Microsoft Entra para gerenciar usuários.
Escolha um dos seguintes tipos de link remoto:
- Consome de/produz para: Quando você deseja controlar dependências de itens de trabalho que são definidos em organizações diferentes e gerenciados por equipes 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.
Na caixa de diálogo Adicionar link, selecione o tipo de link, insira a URL do item de trabalho remoto e selecione OK.
No exemplo a seguir, usamos o tipo de link Relacionado Remoto para vincular ao item de trabalho ID 350 que existe na organização remotelinkingtest2 , projeto RemoteLinking .
A guia link mantém uma contagem de todos os links para o item de trabalho. O campo Contagem de Link Remoto manté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.
Vincular itens de trabalho para receber solicitações
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.Insira até cinco palavras-chave que correspondam 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 Vincular a itens de trabalho de solicitações pull, confirmações e comentários.
Ao conectar os Painéis do Azure aos repositórios do GitHub, você pode vincular itens de trabalho a um Compromisso do GitHub, Solicitação de Pull do GitHub, Ramificação do GitHub e Problema do GitHub. Dessa forma, você pode usar o GitHub para desenvolvimento de software enquanto usa os Painéis do Azure para planejar e acompanhar seu trabalho.
Ao conectar os Painéis do Azure com repositórios do GitHub, você pode vincular itens de trabalho a uma Confirmação do GitHub e a uma Solicitação Pull do GitHub. Dessa forma, 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 confirmações do GitHub, solicitações pull, ramificações e problemas para itens de trabalho e Preenchimento automático de itens de trabalho com solicitações pull.
Vincular vários itens de trabalho a novas ramificações do git
Em uma página de resultados de lista de pendências ou consulta, selecione vários itens de trabalho que você deseja vincular a uma nova ramificação do git, escolha 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 Git.
Vincular itens de trabalho a compilações
Execute as etapas a seguir para vincular itens de trabalho a compilações existentes. Essas compilações podem estar dentro do seu projeto ou para outros projetos em 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.
Na guia Links de um item de trabalho, selecione Adicionar link>Item existente.
Na caixa de diálogo Adicionar link , escolha um dos tipos de link de compilação — Build, Found in build, Integrated in build — e especifique o número da compilação.
Se você não souber o número da compilação — uma combinação do pipeline e do nome da compilação — poderá procurá-lo escolhendo o ícone.
Na caixa de diálogo Compilações de link, escolha os parâmetros para filtrar sua pesquisa de compilações.
Para vincular a uma compilação em um projeto diferente, primeiro escolha o projeto cuja compilação você deseja vincular.
Por exemplo, você pode especificar um número de compilação, selecionar um pipeline de compilação, um resultado de compilação — como Todos, bem-sucedido, parcialmente bem-sucedido, reprovado ou cancelado. Ou, com Todos selecionados para Resultado, escolha Localizar para listar as compilações disponíveis às quais vincular.
Escolha a compilação na lista à qual deseja vincular e, em seguida, selecione OK.
Na caixa de diálogo Adicionar link, selecione OK para concluir a operação.
Você pode vincular itens de trabalho a compilações existentes na caixa de diálogo Adicionar link .
Na guia Links de um item de trabalho, escolha Adicionar link>Item existente.
Na caixa de diálogo Adicionar link , escolha um dos tipos de link de compilação — Compilar, Encontrado na compilação, Integrado na compilação — e especifique o número da compilação.
Se você não souber o número da compilação — uma combinação do pipeline e do nome da compilação — poderá procurá-lo escolhendo o ícone.
Na caixa de diálogo Compilações de link, escolha os parâmetros para filtrar sua pesquisa de compilações.
Por exemplo, você pode especificar um número de compilação, selecionar um pipeline de compilação, um resultado de compilação — como Todos, bem-sucedido, parcialmente bem-sucedido, reprovado ou cancelado. Ou, com Todos selecionados para Resultado, escolha Localizar para listar as compilações disponíveis às quais vincular.
Escolha a compilação na lista à qual deseja vincular e, em seguida, selecione OK.
Na caixa de diálogo Adicionar link , escolha OK para concluir a operação.
Link work items to deployments (Ligar itens de trabalho a implementações)
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. Dessa forma, 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 esses links, conforme ilustrado na imagem a seguir, são: Branch, Build, Changeset, Commit, Found in build, Integrated in build, Pull Request, Versioned Item e Integrated in release environment.
Gorjeta
Recomendamos que você conduza o desenvolvimento a partir do item de trabalho no momento em que o cria. Você também pode adicionar a ID do item de trabalho ao criar ramificações, confirmações e solicitações pull. O Git permite vincular itens de trabalho a confirmações usando o tipo de link Confirmar . Pode fazê-lo das seguintes formas.
- Adicione IDs de item de trabalho no Visual Studio Team Explorer antes de confirmar suas 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 controle Development para conduzir seu desenvolvimento git a partir do item de trabalho.
Conforme mostrado na imagem a seguir, o controle de implantação exibe informações de liberação para dois estágios de versão. Ele inclui itens de trabalho vinculados a uma solicitação de confirmação ou pull do Git para um pipeline de liberação configurado para integração com os Painéis do Azure.
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 Deployment é descrito neste artigo e o controle Development é descrito em Drive Git development from a work item.
Por 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.
Os tipos de item de trabalho personalizados que usam o processo Herdado são habilitados automaticamente. O controle de Implantação exibe as informações de versão para dois estágios do pipeline de liberação integrado aos Painéis do Azure.
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 informações visuais sobre o status de um item de trabalho à medida que ele é implantado em diferentes ambientes de liberação e ir rapidamente para cada estágio de liberação e execução.
Os itens de trabalho associados a confirmações na compilação mostram o status da versão. Mas, apenas os itens de trabalho dentro do mesmo projeto são vinculados ao local onde o pipeline de liberação é definido.
Você pode ver os estágios em tempo real quando abre um item de trabalho.
Para preencher o controle de implantação , execute as seguintes etapas:
Nota
O controle de implantação requer a configuração de um pipeline de versão clássica. Ele não suporta links para estágios de liberação definidos para um pipeline YAML.
- Defina um pipeline de liberação clássico e configure os estágios de liberação conforme descrito em Definir seu pipeline de implantação contínua (CD) de vários estágios.
- Configure o pipeline conforme descrito em Configurar pipelines para dar suporte ao controle de trabalho, Relatar status de implantação para placas.
- Vincule itens de trabalho a uma solicitação de confirmação ou pull no repositório Git do Azure Repos. Para mais informações, consulte:
- Executar o pipeline.
Vincular itens de trabalho ao desenvolvimento de código TFVC
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 arquivos de código-fonte versionados usando os tipos de link Changeset e Versioned Item . Quando você faz check-in de alterações pendentes ou usa Meu Trabalho para fazer check-in de alterações, os itens de trabalho são automaticamente vinculados às alterações.
Vincular itens de trabalho a testes
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. Mas, esses objetos não sã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 link Caso de Teste/Etapas Compartilhadas . Para obter mais informações, consulte 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 hiperlink ou um tipo de link do 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 unidirecionais. Para adicionar esses tipos de link, 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 forneça especificações de item de trabalho. Use este tipo de link para fornecer à sua equipe acesso ao arquivo compartilhado onde eles podem adicionar seus 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 Painéis: As visualizações Listas de pendências e Painéis mostram as relações pai-filho entre itens de trabalho, permitindo que você veja 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 etapas a seguir.
- 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 sob seu tipo de link, com uma contagem dentro de cada grupo.
- (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.
Os links precedidos com o ponto de exclamação indicam que a compilação, liberaçã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.
Consulta de 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 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 e o conjunto secundário está vinculado ao conjunto primário. Não é possível consultar itens de trabalho em versões, mas é possível consultar itens de trabalho com links externos. Para reencontrar a sua pesquisa, adicione mais filtros de consulta.
Para obter exemplos de consulta, consulte Consultas de link e anexo.
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 exibir a hierarquia por meio da >página Planos de teste 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 relationship . 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 obter 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 cebd7ef5-4282-448b-9701-88c8637581b7. O formato da tabela é usado para mostrar a saída. Para outros formatos, consulte 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 suportados incluem Pai, Filho, Relacionado, Relacionado Remotamente. Para obter 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 dentro da mesma organização, você deve especificar o ID do item de trabalho ou a URL de destino. Para itens de trabalho definidos em uma organização remota, você deve especificar a URL de destino. Você pode especificar vários valores separando IDs ou URLs com uma vírgula.
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 atualmente definidos 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 único 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 suportados, exceto tipos de link remoto.
Você deve especificar o ID do item de trabalho de destino. Você pode especificar vários valores separando IDs ou URLs com uma vírgula.
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 atualmente definidos 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 criados para um único item de trabalho
Para exibir os itens de trabalho vinculados a um único item de trabalho, insira o comando az boards work-item relation show . Para obter 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 em 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 o URL de um ficheiro anexado para transferir o anexo.
Excluir links de item de trabalho
Execute as etapas a seguir para excluir um link de item de trabalho.
- Abra o item de trabalho que tem links ou selecione-o a partir de um resultado de consulta.
- Selecione a guia Links para ver a lista de links.
- Selecione a ligação que pretende eliminar e, em seguida, selecione Remover ligação.
- Confirme que deseja excluir o link.
Depois que um item de trabalho é vinculado a uma solicitação de confirmação ou receção, 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, convém removê-lo das compilações e versões.
Para remover o item de trabalho da participação em compilações e versões futuras, exclua o link para a solicitação de confirmação e recebimento mais recente.
Próximos passos
Visualize trabalhos relacionados e outros objetos. Baixe a extensão de visualização de item de trabalho, disponível no Visual Studio Marketplace, guia Azure DevOps.