Compartilhar via

Guia de referência para tipos de link

Azure DevOps Services | Azure DevOps Server 2022 | Azure DevOps Server 2020

Você pode usar diferentes tipos de link para gerenciar as várias relações entre itens de trabalho e outros artefatos, como builds, confirmações e solicitações de pull. Este artigo descreve os seguintes tipos de link.

  • Tipo de link de trabalho: Vincula itens de trabalho, incluindo itens específicos de trabalho de gerenciamento de caso de teste
  • Hiperlink: 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, build 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, problema ou pull do repositório GitHub.

Um campo específico mantém uma contagem de links para os quatro primeiros tipos de link, como Contagem de Vínculos Relacionados, Contagem de Hiperlinks, Contagem de Link Externo e Contagem de Link Remoto.

  • Tipo de link de trabalho: vincula itens de trabalho, incluindo itens de trabalho de gerenciamento de casos de teste selecionados
  • Hiperlink: 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, build ou página wiki
  • Tipo de link do GitHub: conecta um item de trabalho a uma solicitação de confirmação ou pull do repositório GitHub.

Um campo específico mantém uma contagem de links para os três primeiros tipos de link, como Contagem de Links Relacionados, Contagem de Hiperlinks e Contagem de Links Externos.

Os tipos de link estão sujeitos a restrições com base em sua topologia. Use as diretrizes fornecidas nas tabelas a seguir para escolher qual tipo de link usar com base nos tipos de consultas e relatórios que você deseja criar. Para saber mais sobre as diferentes topologias, consulte tipos de topologias de link e restrições.

Os tipos de vínculo de trabalho são definidos pelo sistema, definidos pelo processo ou definidos pelo usuário (personalizado). Os links listados na tabela a seguir são definidos pelo sistema.

Cada tipo de link de trabalho define os rótulos de link, o tipo de topologia e as restrições usadas quando os links entre itens de trabalho são construídos. Por exemplo, o tipo de link pai-filho define dois rótulos: Pai e Filho. O tipo de link também dá suporte a uma topologia hierárquica ou de árvore e impede que referências circulares sejam criadas entre itens de trabalho.

Um diagrama é a imagem conceitual de um tipo de link para item de trabalho.

A Contagem de Vínculos Relacionados de um item de trabalho corresponde à soma de todos os links definidos com um tipo de link de trabalho.

A tabela a seguir descreve os tipos de link do item de trabalho que você pode especificar para definir o escopo de um controle de links usando o elemento XML WorkItemLinksFilter.

Nome

Nome de Referência

Usage

Affects-Afetado por (somente CMMI) O diagrama é uma imagem conceitual do tipo de link Affects.O diagrama é uma imagem conceitual do tipo de link Afetado por.

Microsoft.VSTS.Common.Affects-Forward
Microsoft.VSTS.Common.Affects-Reverse
Tipo de topologia: Dependência
Categoria de link: definido pelo processo

Use esse link direcional para criar links entre qualquer conjunto de itens de trabalho, mas não os que criariam loops fechados. Normalmente usado para controlar solicitações de alteração feitas aos requisitos.

Restrições e recomendações:

  • Você pode vincular uma solicitação de alteração a apenas um requisito usando Affects. É possível vincular requisitos às solicitações de alteração filhas necessárias usando Afetado por.
  • Use apenas Affects-Affected para links que conectam itens de trabalho no mesmo projeto. Recomendamos essa ação se você planeja usar o Excel para modificar ou atualizar dados de item de trabalho.

Pai-filho
Diagrama é uma imagem conceitual de um tipo de link Filho.
O diagrama é uma imagem conceitual de um tipo de vínculo pai.

System.LinkTypes.Hierarchy-Forward
System.LinkTypes.Hierarchy-Reverse
Tipo de topologia: Árvore
Categoria de link: definido pelo sistema

Use esse link direcional para criar relações de um para muitos entre um pai e um ou mais itens filho. Use para organizar o item de trabalho em uma hierarquia. Você pode criar rapidamente essa hierarquia entre itens de lista de pendências usando a função de mapeamento ou entre itens de lista de pendências e tarefas usando a lista de pendências de sprint ou o quadro de tarefas.

Os usos típicos incluem:

  • Mantenha relacionamentos de resumo de tarefa. Vínculos de pai-filho são criados para tarefas de resumo e suas tarefas subordinadas.
  • Vincule tarefas a PBIs, histórias de usuário ou requisitos. Oferece suporte a relatórios de Visão geral da lista de pendências, Visão geral de histórias e Visão geral de requisitos.

Restrições e recomendações:

  • Use o Excel para editar em massa itens de trabalho e links pai-filho. Confira Adicionar ou modificar itens de trabalho em massa com o Excel.
  • Um item de trabalho pode ter apenas um Pai. Um item de trabalho pai pode ter muitos filhos.
  • Use apenas links pai-filho para vincular itens de trabalho no mesmo projeto. Recomendamos essa ação se você planeja usar o Excel para modificar ou atualizar dados de item de trabalho.

Duplicate-Duplicate deDiagrama é uma imagem conceitual de Duplicata de avanço de árvore.Diagrama é uma imagem conceitual de Duplicata de árvore inversa.

System.LinkTypes.Duplicate-Forward
System.LinkTypes.Duplicate-Reverse
Tipo de topologia: Árvore
Categoria de link: definido pelo sistema

Use esse link direcional para criar relações de um para muitos entre um pai e um ou mais itens filho. Use para controlar tarefas, bugs ou outros itens de trabalho que são duplicados uns dos outros.

Restrições e recomendações:

  • Um item de trabalho pode ter apenas uma Duplicata.
  • Use links do tipo Duplicado ou Duplicado de apenas para vincular itens de trabalho no mesmo projeto. Recomendamos essa ação se você planeja usar o Excel para modificar ou atualizar dados de item de trabalho.

Referenciado por referências
Diagrama é uma imagem conceitual do tipo de link testado. Diagrama é uma imagem conceitual do tipo de link teste.

Microsoft.VSTS.TestCase.
ParâmetroCompartilhadoReferenciadoPor
Tipo de topologia: Dependência
Categoria de link: definido pelo processo

Use para vincular casos de teste a parâmetros compartilhados. Use para vincular casos de teste a parâmetros compartilhados para dar suporte à capacidade de repetir um teste com dados diferentes. Em geral, você não adicionaria esse tipo de link a um controle de links delimitados.

Relacionado
Diagrama é uma imagem conceitual do tipo de link Relacionado.

System.LinkTypes.Related
Tipo de topologia: rede
Categoria de link: definido pelo sistema

Use esse link não direcional para criar links entre qualquer conjunto de itens de trabalho. Use para vincular itens de trabalho que estão no mesmo nível, como duas histórias de usuário que definem recursos que se sobrepõem uns aos outros. O tipo de link relacionado cria relações simples com poucas restrições.

  • Relacionar itens de trabalho que estão no mesmo nível, como duas histórias de usuário que definem recursos que se sobrepõem uns aos outros.
  • Vincule itens de trabalho definidos em projetos diferentes e gerenciados por equipes diferentes.
  • Encontre e visualize itens de trabalho e seus itens de trabalho relacionados em uma exibição de dois níveis.
  • Crie relações simples com poucas restrições.

Sucessor-Predecessor
O diagrama é uma imagem conceitual da dependência sucessora, para frente. O diagrama é uma imagem conceitual da dependência predecessora, reversa.

System.LinkTypes.Dependency

Tipo de topologia: Dependência
Categoria de link: definido pelo sistema
Escolha o tipo de link Predecessor ao vincular a um item de trabalho que deve ser concluído antes do item de trabalho do qual você está vinculando. Escolha o tipo de link Sucessor ao vincular a um item de trabalho que deve ser concluído depois do item de trabalho do qual você está vinculando.

Use esse link direcional para criar links entre qualquer conjunto de itens de trabalho, mas não os que criariam loops fechados. Use para acompanhar as tarefas que devem ser concluídas antes que outras possam ser iniciadas. As tarefas vinculadas são representadas como links predecessor-sucessor no Azure Boards.

  • Acompanhe as tarefas que devem ser concluídas para que outras possam ser iniciadas.
  • Dá suporte a relacionamentos de um para muitos.
  • Encontre e exiba itens de trabalho predecessores e seus itens de trabalho sucessores em uma visualização de consulta com links diretos em duas camadas.

Restrições e recomendações:

  • Um erro é exibido quando você tenta criar links que definem relações circulares.
  • Crie links predecessor-sucessor apenas para itens de trabalho que estão dentro do mesmo projeto. Você pode criar links predecessor-sucessor entre itens de trabalho definidos em projetos diferentes. Mas, se você exportar uma consulta para o Excel, somente os itens de trabalho definidos para o projeto para o qual a consulta é definida serão importados.

Testado por Testes
Diagrama é uma imagem conceitual do tipo de link testado. Diagrama é uma imagem conceitual do tipo de link teste.

Microsoft.VSTS.Common.TestedBy-Forward
Microsoft.VSTS.Common.TestedBy-Reverse
Tipo de topologia: Dependência
Categoria de link: definido pelo processo

Vincule casos de teste a itens de trabalho, como bugs, histórias de usuário, requisitos e itens de lista de pendências do produto. Use para acompanhar casos de teste que testam histórias de usuário (Agile), itens de backlog do produto (Scrum) ou requisitos (CMMI). Também é possível vincular a outros tipos de item de trabalho, como bugs, problemas ou tarefas. Para o Azure DevOps local, há vários relatórios SQL que dependem desses links. Consulte As atividades da equipe de Revisão para dar suporte a relatórios úteis.

Etapas de Teste Case-Shared
Diagrama é uma imagem conceitual do tipo de link testado. Diagrama é uma imagem conceitual do tipo de link teste.

Microsoft.VSTS.TestCase.
PassoCompartilhadoReferenciadoPor
Tipo de topologia: Dependência
Categoria de link: definido pelo processo

Use para vincular casos de teste com etapas compartilhadas. Compartilhe etapas entre casos de teste para evitar a necessidade de criar várias entradas da mesma sequência de etapas.

Um hiperlink pode vincular um item de trabalho a qualquer URL. A Contagem de Hiperlinks rastreia o número de hiperlinks para um item de trabalho.

Diagrama é uma imagem conceitual de um Hiperlink.

Nome do link

Ferramenta com suporte

Tipo de artefato

Usage

Hiperlink

Acompanhamento do item de trabalho

Hiperlink

Usado para vincular um item de trabalho a uma URL. Hiperlink de item de trabalho é o nome desse tipo de link na API de Tipos de Link de Artefato.

Os tipos de link externos são tipos de link definidos pelo sistema que dão suporte à vinculação de itens de trabalho a outros objetos armazenados no Azure DevOps, conforme mostrado na imagem a seguir. A Contagem de Link Externo de um item de trabalho corresponde à soma de todos os links definidos com um tipo de link externo.

Diagrama é uma imagem conceitual do tipo de link externo.

Observação

Você só pode usar um tipo de link externo para vincular a um objeto do Azure DevOps. Para vincular itens de trabalho a outros objetos fora do Azure DevOps, use um hiperlink.

A tabela a seguir descreve os tipos de link externos que você pode escolher ao adicionar um tipo de link de um item de trabalho ou caso de teste.

A tabela a seguir descreve os tipos de link externos que você pode escolher ao adicionar um tipo de link de um item de trabalho ou caso de teste. Além disso, você pode especificar um desses tipos de link para definir o escopo de um controle de links usando o elemento XML ExternalLinksFilter.

Nome do link

Ferramenta com suporte

Tipo de artefato

Usage

Ramo

Git

Ramo

Usado para vincular um item de trabalho a um branch.

Pipelines/Build

Construir

Construir

Usado para vincular um item de trabalho a um build.

Conjunto de alterações (ou Corrigido no Conjunto de Alterações)

VersionControl

Conjunto de alterações

Usado para vincular um item de trabalho a um conjunto de alterações.

Commit (ou Corrigido no Commit)

Git

Fazer commit

Usado para vincular um item de trabalho a um commit.

Encontrado no build

Pipelines/Build

Construir

Usado para vincular um item de trabalho a um build.

Integrado à compilação

Construir

Pipeline de build

Usado para vincular um item de trabalho a um build.

Integrado ao ambiente de versionamento

Liberação

Pipeline de lançamento

Usado para vincular uma liberação a um item de trabalho. O sistema cria um link desse tipo quando um usuário habilita a opção Relatar status da implantação para Trabalho para uma definição da versão.

Solicitação de pull

Git

PullRequestId

Usado para vincular um item de trabalho a uma solicitação de pull.

Anexo de resultado

Gerenciamento de testes

TcmResultAttachment

Usado para vincular um item de trabalho a um anexo associado a um resultado de teste. Esses links aparecem quando você associa um item de trabalho a um resultado de teste do Test ou do Microsoft Test Manager.

Arquivo de código-fonte<

VersionControl

VersãoMaisRecenteDoItem

Usado para vincular um item de trabalho a um arquivo no controle de versão do Team Foundation (TFVC).

Storyboard

Requisitos

Storyboard

Usado para vincular um item de trabalho a um arquivo do PowerPoint ou outro arquivo que contém informações sobre story boarding em uma rede.

Etiqueta

Git

Etiqueta

Usado para vincular um item de trabalho a uma tag definida para um commit git ou um repositório git. Para obter mais informações, consulte Trabalhar no prompt de comando do Git.

Resultado do teste

Gerenciamento de testes

TcmResult

Usado para vincular um item de trabalho a um resultado de teste. Esses links aparecem quando você associa um item de trabalho a um resultado de teste do Test ou do Microsoft Test Manager.

Item versionado

VersionControl

VersãoMaisRecenteDoItem

Usado para vincular um item de trabalho a um arquivo ou conjunto de alterações definido em um repositório TFVC. Arquivo de código-fonte é o nome desse tipo de link na API de Tipos de Link de Artefato.

Wiki

Wiki

Wiki

Usado para vincular um item de trabalho a uma página wiki. Compatível com o TFS 2018.2 e versões posteriores.

Os tipos de link do GitHub são definidos pelo sistema e dão suporte à vinculação de itens de trabalho a objetos do GitHub, conforme mostrado na imagem a seguir.

Diagrama é uma imagem conceitual do tipo de link do GitHub.

Importante

Você só pode vincular artefatos do GitHub a repositórios conectados ao Azure Boards.

A tabela a seguir descreve os tipos de link do GitHub que você pode escolher ao adicionar um tipo de link de um item de trabalho.

Nome do link

Tipo de artefato

Usage

Commit do GitHub

Commit do repositório do GitHub

Usado para vincular um item de trabalho a uma confirmação do GitHub.

Problema do GitHub

Problema do repositório GitHub

Usado para vincular um item de trabalho a um problema do GitHub.

Solicitação de Pull do GitHub

Solicitação de pull do repositório GitHub

Usado para vincular um item de trabalho a uma solicitação de pull do GitHub.

Os tipos de link de trabalho remoto são tipos de link definidos pelo sistema que dão suporte à vinculação de itens de trabalho definidos em organizações diferentes, desde que a mesma ID do Microsoft Entra os gerencie, conforme descrito em Conectar sua organização à ID do Microsoft Entra.

A Contagem de Links Remotos de um item de trabalho corresponde à soma de todos os links definidos com um tipo de link de trabalho remoto.

Nome

Nome de Referência

Usage

Consome de-Produzido para
(Topologia de dependência) Diagrama é uma imagem conceitual de Consome da topologia.Diagrama é uma imagem conceitual da topologia Produzido Para.

System.LinkTypes.Remote.Dependency-Forward
System.LinkTypes.Remote.Dependency-Reverse
Tipo de topologia: Dependência
Categoria de link: definido pelo sistema

Use esse link direcional para criar links entre itens de trabalho que têm dependências e são definidos em organizações diferentes, desde que a mesma ID do Microsoft Entra os gerencie. Normalmente usado para controlar solicitações de alteração feitas aos requisitos.

Relacionado remotamente
O diagrama é uma imagem conceitual da topologia relacionada remotamente.

System.LinkTypes.Remote.Related
Tipo de topologia: rede
Categoria de link: definido pelo sistema

Use esse link não direcional para criar links entre itens de trabalho definidos em organizações diferentes, desde que a mesma ID do Microsoft Entra os gerencie.

Você pode criar um tipo de link personalizado, exportar e importar definições de tipos de link e excluir, ativar, desativar e reativar tipos de links. Veja os artigos a seguir:

Para obter uma lista de tipos de link, você pode usar uma das ferramentas de linha de comando com suporte.

az boards work-item relation list-type

Você pode listar tipos de link compatíveis com sua organização com o comando az boards work-item relation list-type ou o comando Work Item Relation Types – List REST API. Para obter mais informações, consulte Introdução à CLI do Azure DevOps.

az boards work-item relation list-type [--org]

Parâmetros opcionais

  • org: a URL da organização do Azure DevOps. Você pode configurar a organização padrão usando az devops configure -d organization=ORG_URL. Obrigatório se não estiver configurado como padrão ou selecionado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo

O comando a seguir lista os tipos de vínculo de item de trabalho no formato de tabela definidos para a organização Fabrikam.

az boards work-item relation list-type --org fabrikam --output table
Name                  ReferenceName                                                Enabled    Usage
--------------------  -----------------------------------------------------------  ---------  ------------
Produces For          System.LinkTypes.Remote.Dependency-Forward                   True       workItemLink
Consumes From         System.LinkTypes.Remote.Dependency-Reverse                   True       workItemLink
Duplicate             System.LinkTypes.Duplicate-Forward                           True       workItemLink
Duplicate Of          System.LinkTypes.Duplicate-Reverse                           True       workItemLink
Referenced By         Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Forward  True       workItemLink
References            Microsoft.VSTS.TestCase.SharedParameterReferencedBy-Reverse  True       workItemLink
Tested By             Microsoft.VSTS.Common.TestedBy-Forward                       True       workItemLink
Tests                 Microsoft.VSTS.Common.TestedBy-Reverse                       True       workItemLink
Test Case             Microsoft.VSTS.TestCase.SharedStepReferencedBy-Forward       True       workItemLink
Shared Steps          Microsoft.VSTS.TestCase.SharedStepReferencedBy-Reverse       True       workItemLink
Successor             System.LinkTypes.Dependency-Forward                          True       workItemLink
Predecessor           System.LinkTypes.Dependency-Reverse                          True       workItemLink
Child                 System.LinkTypes.Hierarchy-Forward                           True       workItemLink
Parent                System.LinkTypes.Hierarchy-Reverse                           True       workItemLink
Related               System.LinkTypes.Related                                     True       workItemLink
Remote Related        System.LinkTypes.Remote.Related                              True       workItemLink
Attached File         AttachedFile                                                 True       resourceLink
Hyperlink             Hyperlink                                                    True       resourceLink
Artifact Link         ArtifactLink                                                 True       resourceLink

O formato json padrão fornece informações adicionais sobre os atributos definidos para os tipos de link. Por exemplo, as informações dos tipos de link Produz para e Consome de são listadas conforme indicado a seguir.

  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": true,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Reverse",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Produces For",
    "referenceName": "System.LinkTypes.Remote.Dependency-Forward",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Forward"
  },
  {
    "attributes": {
      "acyclic": true,
      "directional": true,
      "editable": false,
      "enabled": true,
      "isForward": false,
      "oppositeEndReferenceName": "System.LinkTypes.Remote.Dependency-Forward",
      "remote": true,
      "singleTarget": true,
      "topology": "dependency",
      "usage": "workItemLink"
    },
    "name": "Consumes From",
    "referenceName": "System.LinkTypes.Remote.Dependency-Reverse",
    "url": "https://dev.azure.com/mseng/_apis/wit/workItemRelationTypes/System.LinkTypes.Remote.Dependency-Reverse"
  },

witadmin listlinktypes

Você pode listar tipos de link com suporte para sua coleção de projetos usando a witadmin listlinktypes ferramenta de linha de comando ou o comando Tipos de Relação de Item de Trabalho – Listar API REST.

Aqui está uma lista dos tipos de link para a coleção padrão fabrikam-sever:

C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer>witadmin listlinktypes /collection:http://fabrikam-server/DefaultCollection

Reference Name: Microsoft.VSTS.TestCase.SharedParameterReferencedBy
Names: Referenced By, References
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.Common.TestedBy
Names: Tested By, Tests
Topology: Dependency
Is Active: True

Reference Name: Microsoft.VSTS.TestCase.SharedStepReferencedBy
Names: Test Case, Shared Steps
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Duplicate
Names: Duplicate, Duplicate Of
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Dependency
Names: Successor, Predecessor
Topology: Dependency
Is Active: True

Reference Name: System.LinkTypes.Hierarchy
Names: Child, Parent
Topology: Tree
Is Active: True

Reference Name: System.LinkTypes.Related
Name: Related
Topology: Network
Is Active: True

A tabela a seguir fornece descrições para cada um dos atributos de tipo de link retornados pela CLI do Azure Boards ou pela API REST.

Atributo

Descrição

Nomes, name

Especifica o nome amigável atribuído aos tipos de link. Os links direcionais são definidos em pares, portanto, incluem um nome direto e reverso.

Nome da referência, referenceName

Especifica o nome atribuído ao tipo de link ou ao par de tipos de link.

acyclic

Indica se o tipo de link permite ou (true) ou restringe relações circulares (false). Por exemplo, links de tipo de árvore restringem relações circulares. Para obter mais informações, consulte a referência de elementos LinkTypes.

directional

Indica se o tipo de link é direcional (true) ou não (false). Os tipos de link direcional são definidos em pares com um componente avançado e reverso. Para obter mais informações, consulte a referência de elementos LinkTypes.

editable

Indica se o tipo de link é editável (true) ou não (false). Você só pode adicionar e editar tipos de link personalizados para implantações locais usando witadmin a ferramenta Gerenciar tipo de link de linha de comando. Os tipos de link do sistema sempre têm editable=false.

Está Ativo, enabled

Indica se o tipo de link está ativo (true) ou não (false). Você só pode usar tipos de link personalizados para implantações locais usando a witadmin ferramenta Gerenciar tipo de link de linha de comando.

isForward

Indica se o tipo de link especifica o link de encaminhamento (true) ou não (False) dentro de um par de tipos de link.

oppositeEndReferenceName

Especifica o nome de referência do tipo de link que define o link na direção oposta de um par de tipos de links.

remote

Indica se o tipo de link dá suporte à vinculação a um item de trabalho remoto (true) ou não (False). Os tipos de link com remote=false exigem que o item de trabalho de destino resida na mesma organização ou coleção que o item de trabalho de origem.

singleTarget

Indica se o tipo de link permite mais de um destino (false) ou se é restrito a um único destino (true).

topology

Especifica o tipo de topologia: dependency, networke tree. Para descrições, consulte topologias de tipos de link e restrições.

usage

Especifica o tipo de uso: resourceLink or o valor workItemLink. The workItemLink indica um tipo de link que vincula dois itens de trabalho. O resourceLink valor indica um tipo de link usado para vincular um item de trabalho a um recurso, como uma URL ou um anexo.

url

Lista os atributos do tipo de link no formato json.

Conteúdo relacionado