Partilhar via

Guia de referência para tipos de link

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

Use diferentes tipos de link para gerenciar relações entre itens de trabalho e outros artefatos, como compilações, confirmações e solicitações pull. Este artigo descreve os seguintes tipos de link.

  • 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, 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.

Um campo específico mantém uma contagem de links para os primeiros quatro tipos de link, como Contagem de Link Relacionado, Contagem de Hiperlinks, Contagem de Links Externos e Contagem de Links Remotos.

  • 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, compilação ou página wiki
  • Tipo de link do GitHub: conecta um item de trabalho a uma solicitação commit ou pull do repositório GitHub.

Um campo específico mantém uma contagem de links para os três primeiros tipos de links, como Contagem de links relacionados, Contagem de hiperlinks e Contagem de links externos.

Os tipos de ligação têm restrições topológicas. Use as orientações nas tabelas a seguir para escolher um tipo de link com base nas consultas e relatórios que você planeja criar. Para saber mais sobre topologias, consulte Topologias e restrições de tipo de link.

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

Cada tipo de link de trabalho define rótulos, topologia e restrições usados quando você constrói links entre itens de trabalho. Por exemplo, o tipo de link pai-filho define dois rótulos: Pai e Filho. O tipo de link usa uma topologia de árvore e impede referências circulares entre itens de trabalho.

Captura de ecrã que mostra um diagrama conceptual de um tipo de ligação de item de trabalho.

A Contagem de Ligações Relacionadas de um item de trabalho é igual à soma de todas as ligações definidas com um tipo de ligação de trabalho.

A tabela a seguir descreve os tipos de link de 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

Utilização

Affecta-Afectado por (somente CMMI) Captura de ecrã que mostra um diagrama conceptual do tipo de ligação Affecta.Captura de ecrã que mostra um diagrama conceptual do tipo de ligação Afectado por.

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

Use esse link direcional para criar links entre itens de trabalho sem criar loops fechados. As pessoas normalmente o usam para rastrear solicitações de alteração vinculadas a requisitos.

Restrições e recomendações:

  • Vincule uma solicitação de alteração a apenas um requisito usando Affects. Vincule os requisitos a quantas solicitações de alteração filho forem necessárias usando Afetado por.
  • Use apenas Affects-Affected em ligações para associar itens de trabalho no mesmo projeto. Recomendamos isso quando você planeja usar o Excel para modificar ou atualizar dados de item de trabalho.

Filho-pai
Captura de ecrã que mostra um diagrama conceptual do tipo de ligação Filho.
Captura de ecrã que mostra um diagrama conceitual do tipo de link pai.

Sistema.TiposDeLigação.Hierarquia-ParaFrente
System.LinkTypes.Hierarchy-Reverse
Tipo de topologia: Árvore
Categoria do link: Definido pelo sistema

Use este link direcional para criar relações um-para-muitos entre um único pai e um ou mais itens filho. Use-o para organizar itens de trabalho dentro de uma hierarquia. Você pode criar essa hierarquia entre itens da lista de pendências usando a função de mapeamento ou entre itens e tarefas da lista de pendências usando a lista de pendências da sprint ou o Quadro de tarefas.

Os usos típicos incluem:

  • Mantenha as relações de resumo das tarefas. Os links pai-filho representam tarefas resumidas e suas tarefas subordinadas.
  • Vincule tarefas a PBIs, histórias de usuários ou requisitos. Suporta 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. Consulte Adicionar ou modificar em massa os itens de trabalho com o Excel.
  • Um item de trabalho pode ter apenas um único pai. Um item de trabalho dos pais pode ter muitos filhos.
  • Use apenas links pai-filho para vincular itens de trabalho no mesmo projeto. Recomendamos isso quando você planeja usar o Excel para modificar ou atualizar dados de item de trabalho.

Duplicate-Duplicate de Captura deecrã que mostra um diagrama conceptual do tipo de link Duplicado.Captura de ecrã que mostra um diagrama conceptual do tipo de link Duplicar de.

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

Utilize esta ligação direcionada para criar relações um-para-muitos para rastrear tarefas, bugs ou outros itens de trabalho que se duplicam mutuamente.

Restrições e recomendações:

  • Um item de trabalho pode ter apenas uma duplicata.
  • Use apenas os links "Duplicar" ou "Duplicar de" para ligar itens de trabalho no mesmo projeto. Recomendamos isso quando você planeja usar o Excel para modificar ou atualizar dados de item de trabalho.

Sub-Referências Referenciadas
Captura de tela que mostra um diagrama conceitual do tipo de link Referenciado por. Captura de tela que mostra um diagrama conceitual do tipo de link Referências.

Microsoft.VSTS.TestCase.
ParâmetroPartilhadoReferenciadoPor
Tipo de topologia: Dependência
Categoria do link: Definida pelo processo

Use isso para vincular casos de teste a parâmetros compartilhados e para dar suporte à repetição de um teste com dados diferentes. Geralmente, não se adiciona este tipo de link a um controlador de links com escopo.

Relacionados
Captura de tela que mostra um diagrama conceitual do tipo Link relacionado.

System.LinkTypes.Relacionado
Tipo de topologia: Rede
Categoria do link: Definido pelo sistema

Use esse link não direcional para criar relações entre itens de trabalho. Use-o para vincular itens de trabalho no mesmo nível (por exemplo, duas histórias de usuário que se sobrepõem). O tipo de link relacionado cria relações simples com poucas restrições.

  • Relacione itens de trabalho que estão no mesmo nível.
  • Vincule itens de trabalho definidos em diferentes projetos e gerenciados por diferentes equipes.
  • Encontre e visualize itens de trabalho e seus itens relacionados em uma visão de duas camadas.
  • Crie relações simples com poucas restrições.

Sucessor-Antecessor
Captura de ecrã que mostra um diagrama conceptual da dependência do Sucessor. Captura de ecrã que mostra um diagrama conceptual da dependência do Predecessor.

System.LinkTypes.Dependency
Tipo de topologia: Dependência
Categoria do link: Definido pelo sistema
Escolha Predecessor ao vincular a um item de trabalho que deve ser concluído antes do item atual. Escolha Sucessor ao vincular a um item de trabalho que deve ser concluído após o item atual.

Use este link direcional para controlar tarefas que devem ser concluídas antes que outras iniciem. As tarefas vinculadas aparecem como links predecessor-sucessor nos Painéis do Azure.

  • Acompanhe as tarefas que devem ser concluídas antes que outras possam começar.
  • Apoie relacionamentos um-para-muitos.
  • Localize itens de trabalho precedentes e sucessores em uma consulta de links diretos em duas camadas.

Restrições e recomendações:

  • Um erro aparece quando você tenta criar relações circulares.
  • Crie links predecessor-sucessor somente para itens de trabalho dentro do mesmo projeto quando você planeja exportar para o Excel. Você pode criar links predecessor-sucessor entre projetos, mas a exportação/importação do Excel incluirá apenas itens para o projeto que define a consulta.

Testado por testes
Captura de tela que mostra um diagrama conceitual do tipo de link Testado por. Captura de tela que mostra um diagrama conceitual do tipo de link Testes.

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

Vincule casos de teste a itens de trabalho, como bugs, histórias de usuários, requisitos e PBIs. Use isso para rastrear casos de teste que validam histórias de usuário (Agile), PBIs (Scrum) ou requisitos (CMMI). Para o Azure DevOps local, vários relatórios SQL dependem desses links. Consulte atividades da equipa de revisão para apoiar relatórios úteis.

Passos do Teste Case-Shared
Captura de ecrã que mostra um diagrama conceptual do link de Caso de Teste para Etapas Partilhadas. Captura de ecrã que mostra um diagrama conceptual do link de Etapas Partilhadas para Caso de Teste.

Microsoft.VSTS.TestCase.
Passo Partilhado Referenciado Por
Tipo de topologia: Dependência
Categoria do link: Definida pelo processo

Use isso para vincular casos de teste com etapas compartilhadas. Compartilhe etapas entre casos de teste para evitar a duplicação da mesma sequência de etapas.

Um hiperlink vincula um item de trabalho a qualquer URL. A Contagem de Hiperlinks controla o número de hiperlinks em um item de trabalho.

Captura de tela que mostra um diagrama conceitual de um hiperlink.

Nome do Link

Ferramenta suportada

Tipo de artefato

Utilização

Hiperligação

Acompanhamento de itens de trabalho

Hiperligação

Use isso para vincular um item de trabalho a uma URL. Hipervínculo de item de trabalho é o nome deste tipo de ligação na API de Tipos de Ligação de Artefato.

Os tipos de link externo são definidos pelo sistema e vinculam itens de trabalho a outros objetos armazenados no Azure DevOps. A Contagem de Link Externo de um item de trabalho é igual à soma de todos os links definidos com tipos de links externos.

Captura de tela que mostra um diagrama conceitual de tipos de link externo.

Observação

Use um tipo de link externo somente para vincular a um objeto DevOps do Azure. Para vincular itens de trabalho a objetos fora do Azure DevOps, use um hiperlink.

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

A tabela a seguir descreve os tipos de link externo que você pode escolher ao adicionar um link de um item de trabalho ou caso de teste. Você também 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 suportada

Tipo de artefato

Utilização

Alerta de Segurança

Segurança Avançada

Segurança Avançada

Usado para vincular um item de trabalho a um alerta de Segurança Avançada.

Filial

Git

Filial

Use para vincular um item de trabalho a uma ramificação.

Pipelines/Construção

Construir

Construir

Use para vincular um item de trabalho a uma compilação.

Conjunto de alterações (ou Fixo no conjunto de alterações)

Controle de versão

Conjunto de alterações

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

Compromisso (ou Corrigido no Compromisso)

Git

Compromisso

Use para vincular um item de trabalho a uma confirmação.

Encontrado na compilação

Pipelines/Construção

Construir

Use para vincular um item de trabalho a uma compilação.

Integrado na compilação

Construir

Pipeline de construção

Use para vincular um item de trabalho a uma compilação.

Integrado em ambiente de lançamento

Lançamento

Pipeline de lançamento

Utilize para vincular um lançamento a um item de trabalho. O sistema cria esse tipo quando um utilizador habilita Relatar estado de implantação para Trabalho para uma definição de versão.

Solicitação de Pull

Git

PullRequestId

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

Anexo de resultados

Gestão de Testes

TcmResultAttachment

Use 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 Microsoft Test Manager.

Arquivo de código-fonte

Controle de versão

ÚltimaVersãoDoItem

Utilize para vincular um item de trabalho a um ficheiro no controlo de versão do Team Foundation (TFVC).

Roteiro gráfico

Requerimentos

Roteiro gráfico

Use para vincular um item de trabalho a um arquivo do PowerPoint ou outro arquivo que contenha informações de storyboard em uma rede.

Etiqueta

Git

Etiqueta

Use para vincular um item de trabalho a uma tag definida para um git commit ou repositório. Para saber mais, consulte Trabalhar no prompt de comando do Git.

Resultado do teste

Gestão de Testes

TcmResultado

Use 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 Microsoft Test Manager.

Item versionado

Controle de versão

ÚltimaVersãoDoItem

Use para vincular um item de trabalho a um arquivo ou conjunto de alterações definido em um repositório TFVC. Ficheiro de código-fonte é o nome deste tipo de ligação na API de tipos de ligação de artefacto.

Wiki

Wiki

Wiki

Use para vincular um item de trabalho a uma página wiki. Suporte para TFS 2018.2 e versões posteriores.

Os tipos de link do GitHub são definidos pelo sistema e vinculam itens de trabalho a objetos do GitHub, conforme mostrado aqui.

Captura de tela que mostra um diagrama conceitual dos tipos de link do GitHub.

Importante

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

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

Nome do Link

Tipo de artefato

Utilização

Confirmação do GitHub

Confirmação do repositório GitHub

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

Problema do GitHub

Problema do repositório GitHub

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

Solicitação pull do GitHub

Solicitação pull do repositório GitHub

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

Os tipos de link de trabalho remoto suportam a vinculação de itens de trabalho definidos em organizações diferentes, desde que a mesma ID do Microsoft Entra gerencie essas organizações (consulte Conectar sua organização à ID do Microsoft Entra).

A Contagem de Ligações Remotas de um item de trabalho é igual à soma de todas as ligações definidas com um tipo de ligações de trabalho remoto.

Nome

Nome de referência

Utilização

Consome De-Produzido para
(Topologia de dependência) Captura de tela que mostra um diagrama conceitual da topologia Consumes De.Captura de tela que mostra um diagrama conceitual da topologia Produzido para.

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

Use esse link direcional para criar dependências entre itens de trabalho definidos em organizações diferentes, desde que o mesmo ID do Microsoft Entra os gerencie. As pessoas normalmente usam isso para rastrear solicitações de alteração vinculadas a requisitos através dos limites da organização.

Relacionado com Remoto
Captura de ecrã que mostra um diagrama conceptual da topologia remota relacionada.

System.LinkTypes.Remote.Related
Tipo de topologia: Rede
Categoria do link: Definido pelo sistema

Use este link não direcional para relacionar itens de trabalho definidos em organizações diferentes, desde que o mesmo ID do Microsoft Entra os gerencie.

Crie tipos de link personalizados, exporte e importe definições de tipo de link e exclua, ative, desative ou reative tipos de link personalizados. See:

Você pode listar tipos de link usando ferramentas de linha de comando suportadas.

az boards item de trabalho relação lista-tipo

Liste os tipos de link suportados pela sua organização com o comando az boards work-item relation list-type ou na Work Item Relation Types - List REST API. Para obter detalhes, consulte Introdução à CLI do Azure DevOps.

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

Parâmetros opcionais

  • org: 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 predefinido ou coletado usando git config. Exemplo: --org https://dev.azure.com/MyOrganizationName/.

Exemplo

O comando seguinte lista os tipos de ligação de itens de trabalho em 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 para os tipos de link Produz Para e Consome De estão listadas 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 os tipos de link suportados para sua coleção de projetos usando a ferramenta de witadmin listlinktypes linha de comando ou o comando Work Item Relation Types - List REST API.

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, por isso incluem um nome de ida e de volta.

Nome de referência, referenceName

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

acyclic

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

directional

Indica se o tipo de link é direcional (true) ou não (false). Os tipos de ligação direcionais são definidos em pares com um componente avançado e um componente recuado. Para obter mais informações, consulte 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 de linha de comando Gerenciar tipo de link. Os tipos de ligação 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 implementações locais usando a ferramenta de linha de comando "Gerenciar tipo de link".

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

remote

Indica se o tipo de link oferece suporte à vinculação a um item de trabalho remoto (true) ou não (False). Os tipos de vínculo 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 está restrito a um único destino (true).

topology

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

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

url

Lista os atributos do tipo de link no formato json.

Conteúdo relacionado

  • Last updated on