Referência de elementos LinkTypes

Azure DevOps Services | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 – TFS 2013

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 em modelos de processo de herança ou XML hospedado. Para ter 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: definidas pelo sistema, definidas pelo processo e definidas pelo usuário ou personalizadas. Os tipos de link definidos nos processos padrão suportam 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 Vincular controles, restrições e campos.

Observação

Você não pode personalizar os tipos de link definidos pelo sistema que correspondem aos links Related, Parent-Child e Successor-Predecessor.

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

  • Altere os rótulos de link que são usados para corresponder às convenções de nomen entre suas equipes.
  • Adicione um tipo de link para acompanhar uma relação específica exclusiva ao processo da 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 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 atopologiaDirectedNetwork,Network,Treeou Dependency. As três primeiras topologias são direcionais e você as utiliza para definir relacionamentos subordinados ou sequenciais. Você usa 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 ForwardNamee ReverseName. Se você criar um link personalizado e atribuir o mesmo nome aos nomes de encaminhamento e reverso, deverá definir o tipo de link como Rede porque é 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 à frente ou à frente
  • Os nomes não podem conter caracteres de 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 de extremidade.
Exemplo de uso:use um link de dependência para registrar os recursos que devem ser concluídos para fornecer um requisito do usuário. Não é possível criar um link dependente entre dois itens de trabalho vinculados aos mesmos itens de trabalho por meio de links dependentes.

Dependency topology

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 de extremidade. 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 entre si de alguma forma.

Directed network topology

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

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

Network topology

Á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 de extremidade. Links de árvore são o único tipo de link com suporte na consulta Itens de Árvore de Trabalho. Com links pai/filho, você não pode atribuir dois pais a um filho.

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

Tree topology

Observação

Disponibilidade derecursos: a criação de um tipo de link personalizado só tem suporte para o modelo de processo XML local. Não é possível 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 witadmin importlinktype. Cada tipo de link definido pelo processo é 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 WorkItem Tracking\LinkTypes.

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 Test Manager, você pode exibir quais casos de teste são definidos para um conjunto de testes e quais conjunto de testes são definidos para um plano de teste. No entanto, esses objetos não sã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 elemento para definir as opções que controlam quais links podem ser adicionados a um item de trabalho e a LinksControlOptions quais tipos de item de trabalho. Além disso, você pode especificar as colunas padrão que deseja que apareçam 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 API de tipos de link de artefato.