Referência de elementos LinkTypes

Azure DevOps Server 2022 – Azure DevOps Server 2019 | TFS 2018

Importante

Este tópico fornece uma referência de tipos de link definidos para Azure DevOps Services e TFS. Para o modelo de processo XML local, você pode adicionar tipos de link personalizados. Não há suporte para tipos de link personalizados para modelos de processo XML hospedado ou herança. Para obter uma visão geral dos modelos de processo e das personalizações com suporte, consulte Personalizar sua experiência de acompanhamento de trabalho.

Você usa tipos de link diferentes para formar relacionamentos de link entre diferentes WITs (Work Item Types, tipos de item de trabalho). Há três categorias de tipos de link: definidos pelo sistema, definidos pelo processo e definidos pelo usuário ou personalizados. Os tipos de link definidos nos processos padrão dão suporte a relações de vínculo entre os WITs de gerenciamento de teste.

Cada tipo de link 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), dá suporte a uma topologia de árvore ou hierárquica e impede a criação de referências circulares entre itens de trabalho.

Você pode personalizar um tipo de link existente ou criar um tipo de link para atender aos requisitos de acompanhamento do projeto. Antes de começar a adicionar ou modificar um tipo de link, você deve avaliar os tipos de link disponíveis e como eles são usados em seu projeto. Consulte Gerenciar dependências, vincular itens de trabalho. Os links são adicionados por meio do formulário de item de trabalho, que contém o controle de links. Consulte controles, restrições e campos do Link.

Observação

Não é possível personalizar os tipos de link definidos pelo sistema que correspondem aos links Relacionados, Pai-Filho e Successor-Predecessor.

Talvez você queira modificar ou criar um tipo de link por um dos seguintes motivos:

  • Altere os rótulos de link usados para corresponder às convenções de nomenclatura da sua equipe.
  • Adicione um tipo de link para acompanhar uma relação específica que seja exclusiva para o processo de sua equipe.

O tipo de link é especificado em um arquivo XML de definição de tipo que você importa para uma coleção de projetos. Para personalizar ou criar um tipo de link, use o witadmin importlinktype para importar o arquivo de definição de tipo de link para a coleção de projetos que hospeda seu projeto. Com a ferramenta de linha de comando witadmin , você pode desativar, excluir, exportar, importar, listar e reativar tipos de link. Consulte Gerenciar tipos de link.

Estrutura da sintaxe

Você pode definir tipos de link adicionais adicionando-os aos tipos de link definidos para uma coleção de projetos.

É possível definir tipos de link válidos para usar no processo com base na estrutura que o esquema de definição de tipo de link fornece. Um tipo de link é definido pela sintaxe XML a seguir no arquivo XML de tipos de link.

<LinkTypes>  
      <LinkType ReferenceName="LinkTypeName" ForwardName="ForwardName" ReverseName="ReverseName" Topology="TopologyType" />  
</LinkTypes>  

As descrições na tabela a seguir aplicam-se à sintaxe anterior:

Atributo Descrição
ReferenceName     Nome do tipo de link. Esse nome é usado internamente ao criar um link entre dois itens de trabalho.
ForwardName Nome do link no item de trabalho de origem. Esse nome aparece ao adicionar links ao item de trabalho de origem.
ReverseName Nome do link no item de trabalho de destino. Esse nome aparece quando uma listagem dos links no item de trabalho de destino aparece.
TopologyType Especifica a topologiaDirectedNetwork, Network, Tree ou Dependency. As três primeiras topologias são direcionais e você as utiliza para definir relacionamentos subordinados ou sequenciais. Você usa a Rede para definir relações entre pares ou onde não existe subordinação implícita.

A direcionalidade do link é determinada pelas atribuições feitas aos atributos ForwardName e ReverseName . Se você criar um link personalizado e atribuir o mesmo nome aos nomes de encaminhamento e inverso, deverá definir o tipo de link como Rede , pois ele é a única topologia não direcional.

Requisitos

Cada tipo de link tem um nome de referência e dois nomes amigáveis opcionais, ou nomes de rótulo, que devem ser únicos dentro da coleção de projeto. Cada nome de tipo de link deve cumprir os seguintes requisitos:

  • Os nomes podem ter até 254 caracteres Unicode
  • Os nomes não devem estar vazios
  • Os nomes não podem ter espaços em branco à esquerda ou à direita
  • Os nomes não podem conter caracteres de barra invertida (\)
  • Os nomes não podem conter dois espaços em branco consecutivos.

Os tipos de topologia descritos na tabela a seguir determinam as restrições impostas ao uso de cada tipo de link.

Tipo de topologia

Ilustração

Dependência: você pode usar links de dependência para criar relações entre itens de trabalho que têm direcionalidade e restringir relações circulares. O nome do link é diferente nos pontos finais.
Uso de exemplo: use um link de dependência para registrar os recursos que devem ser concluídos para fornecer um requisito do usuário. Você não pode criar um link dependente entre dois itens de trabalho que estão vinculados aos mesmos itens de trabalho por meio de links dependentes.

Topologia de dependência

Rede Direcionada: você pode usar links de rede direcionados para criar relações entre itens de trabalho que indicam direcionalidade. O nome do link é diferente nos pontos finais. Relacionamentos circulares são permitidos.

Uso de exemplo: use um link de rede direcionado para registrar uma relação entre dois recursos que podem compartilhar dependências e que você deseja distinguir um do outro de alguma forma.

Topologia de rede direcionada

Rede: você pode usar links de rede para criar relações básicas entre itens de trabalho que não são restritivos. O link é o mesmo em ambos os pontos de extremidade. Relacionamentos circulares são permitidos.

Uso de exemplo: use um link de rede, como Relacionado, para registrar uma relação entre dois recursos que podem compartilhar dependências.

Topologia de rede

Árvore: você pode usar links de árvore para criar relações hierárquicas entre itens de trabalho. Links em árvore dão suporte a visualizações hierárquicas de vários níveis, têm direcionalidade e restringem relacionamentos circulares. O nome do link é diferente nos pontos finais. Os links de árvore são o único tipo de link com suporte na consulta Árvore de Itens de Trabalho . Com links pai/filho, você não pode atribuir dois pais a um filho.

Uso de exemplo: use um link de árvore para registrar tarefas e subtarefas de sua equipe que devem ser concluídas para fornecer uma história de usuário ou um item de lista de pendências. Ou mapeie itens de backlog para recursos e recursos para épicos.

Topologia de árvore

Observação

Disponibilidade do recurso: a criação de um tipo de link personalizado só tem suporte para o modelo de processo XML local. Você não pode adicionar tipos de link personalizados ao usar o modelo de processo XML hospedado.

Para criar um tipo de link personalizado, defina o arquivo de definição XML do tipo de link de acordo com a sintaxe fornecida anteriormente neste tópico e importe-o usando o witadmin importlinktype. Cada tipo de link definido pelo processo está associado a um arquivo de definição XML. Esses arquivos são definidos na WorkItem Tracking\LinkTypes pasta do conjunto de processos de arquivos e pastas.

Por exemplo, a sintaxe a seguir define o tipo de link Microsoft.VSTS.Common.TestedBy fornecido por meio do arquivo TestedBy.xml:

<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
   <LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>

Quando você cria ou atualiza um projeto, as definições de tipo de link definidas para o processo de referência são importadas para a coleção de projetos.

Usando o portal da Web ou o Gerenciador de Testes, você pode exibir quais casos de teste são definidos para um pacote de testes e quais conjuntos de testes são definidos para um plano de teste. No entanto, esses objetos não estão vinculados uns aos outros por meio de tipos de link.

Além de definir tipos de link, você pode personalizar a definição de tipo de item de trabalho para aceitar ou proibir links específicos com base no tipo de link. Use o LinksControlOptions elemento para definir as opções que controlam quais links podem ser adicionados a um item de trabalho e a quais tipos de item de trabalho. Além disso, você pode especificar as colunas padrão que deseja exibir para a lista de links em um item de trabalho. Para obter mais informações, consulte Definir controles de link para restringir relações de vínculo.

Para interagir programaticamente com tipos de link, consulte a API de Tipos de Link de Artefato.