Referência de elementos de tipo de link

Artigo
06/09/2015

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 diferentes de tipos de link: definidos pelo sistema, definidos pelo modelo de processo e definidos pelo usuário. Os tipos de link definidos nos modelos de processo padrão dão suporte a relacionamentos de link entre os WITs do 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.

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 projeto que hospeda o projeto de equipe.

Estrutura da sintaxe

É possível definir tipos de link adicionais incluindo-os nos tipos de link definidos para uma coleção de projeto de equipe. É 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 seguinte sintaxe XML 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 topologia de DirectedNetwork, Network, Tree ou Dependency. As três primeiras topologias são direcionais e você as utiliza para definir relacionamentos subordinados ou sequenciais. Você usa Network para definir relacionamentos entre pares ou quando não há uma subordinação implícita.

Vincular direcionalmente é determinado pelas atribuições feitas aos atributos ForwardName e ReverseName. Se você criar um link personalizado e atribuir o mesmo nome aos nomes de avanço e reverso, deve definir o tipo de link para Network porque é a única topologia não direcional.

Requisitos

LINKTYPES é um conjunto de elementos LINKTYPE armazenados e usados por uma coleção de projeto de equipe.

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 no início ou no fim.
Os nomes não devem conter caracteres de barra invertida (\).
Os nomes não podem conter dois espaços em branco consecutivos.

Tipos de link definidos pelo sistema

A tabela a seguir resume os tipos de link definidos pelo sistema. Você não pode mudar esses tipos de link.

Nome de avanço	Nome reverso	Nome de referência	Topologia
Sucessor	Predecessor	System.LinkTypes.Dependency	Dependência
Filho	Pai	System.LinkTypes.Hierarchy	Árvore
Relacionado	Relacionado	System.LinkTypes.Related	Rede

Há também tipos de link adicionais usados para vincular itens de trabalho a outros objetos no projeto de equipe ou outros elementos, como uma página da Web ou um local de rede. Por exemplo, o tipo de link Storyboard vincula itens de trabalho a storyboards ou qualquer arquivo localizado em um compartilhamento de rede. Para saber mais, veja Vincular itens de trabalho para oferecer suporte à rastreabilidade.

Tipos de link definidos por modelo de processo

Ao criar um projeto de equipe usando um dos modelos de processo padrão que o TFS fornece, os seguintes tipos de link são adicionados ao projeto de equipe. Esses tipos de link são especificamente projetados para dar suporte à interação com os itens de trabalho de rastreamento em Team Foundation e Microsoft Test Manager.

Tipos de item de trabalho de gerenciamento de teste

Nome de avanço	Nome reverso	Nome de referência do tipo de link	Topologia
Afeta (veja Observação 1)	Afetado por	Microsoft.VSTS.Common.Affects	Dependência
Referido por (veja Observação 2)	Referências	Microsoft.VSTS.TestCase.SharedParameterReferencedBy	Dependência
Testado por	Testes	Microsoft.VSTS.Common.TestedBy	Dependência
Caso de teste	Etapas compartilhadas	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Dependência

Notas

O tipo de link Afeta/Afetado por vincula solicitações de mudança a requisitos. Esse tipo de link somente é adicionada a projetos de equipe criados com um modelo de processo CMMI.
O tipo de link Referido por/Faz referência a vincula um Parâmetro compartilhado com um Caso de teste para dar suporte a executar testes com dados diferentes. Esse tipo de link é adicionado a um projeto de equipe ao atualizar o projeto de equipe usando o Assistente de Configurar recursos ou criar um projeto d equipe baseado em modelos de processo TFS 2013.2 ou versão posterior.

Os arquivos de definição de tipo de link são definidos na pasta WorkItem Tracking\LinkTypes do arquivo Template.zip. A definição a seguir para o tipo de link Microsoft.VSTS.Common.TestedBy é fornecida no 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>

Ao criar um projeto de equipe usando o modelo de processo correspondente, a definição de tipo de link é importada para a coleção de projeto.

Restrições e topologias do link

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
Rede: é possível usar links de rede para criar relacionamentos básicos 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 um relacionamento entre dois recursos que podem compartilhar dependências.
Rede direcionada: você pode usar link de rede direcionados para criar relacionamentos entre itens de trabalho que indicam a direcionalidade. O nome do link é diferente nos pontos de extremidade. Relacionamentos circulares são permitidos. Exemplo de uso: use um link de rede direcionado para registrar um relacionamento entre dois recursos que podem compartilhar dependências e que você deseja distinguir um do outro de alguma forma.
Dependência: é possível usar links de dependência para criar relacionamentos entre itens de trabalho que tenham direcionalidade e para restringir relacionamentos circulares. O nome do link é diferente nos pontos de extremidade. Na ilustração, não é possível criar um link dependente para um item de trabalho que contenha relacionamentos de link dependente para os mesmos itens de trabalho. Exemplo de uso: use um link de dependência para registrar os recursos que devem ser concluídos para entregar um requisito do usuário.
Árvore: é possível usar links em árvore para criar relacionamentos hierárquicos de vários níveis entre os 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 em árvore são o único tipo de link com suporte na consulta Árvore de itens de trabalho. Na ilustração, não é possível atribuir dois pais a um filho. Exemplo de uso: use um link em árvore para registrar tarefas e subtarefas da sua equipe que devem ser concluídas para entregar um recurso.

Definição de esquema de tipos de link

O código a seguir lista a definição de esquema para tipos de link:

<?xml version="1.0" encoding="utf-8"?>
<xs:schema 
  id="WorkItemLinkTypeDefinition" 
  elementFormDefault="unqualified" 
  attributeFormDefault="unqualified" 
  xmlns:xs="http://www.w3.org/2001/XMLSchema" 
  targetNamespace="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns:mstns="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/WorkItemLinkTypeDefinition.xsd" 
  xmlns:typelib="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib"
  version="1.0">
   <xs:import namespace="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/typelib"/>
  <xs:simpleType name="TopologyTypes">
    <xs:restriction base="xs:string">
      <xs:enumeration value="Network" />
      <xs:enumeration value="DirectedNetwork" />
      <xs:enumeration value="Dependency" />
      <xs:enumeration value="Tree" />
    </xs:restriction>
  </xs:simpleType>
  <xs:complexType name="LinkTypeType">
    <xs:attribute name="ReferenceName" type="typelib:ReferenceName" use="required" />
    <xs:attribute name="Topology" type="TopologyTypes" use="optional" />
    <xs:attribute name="ForwardName" type="typelib:FriendlyName" use="optional" />
    <xs:attribute name="ReverseName" type="typelib:FriendlyName" use="optional" />
  </xs:complexType>
  <xs:complexType name="LinkTypesType">
    <xs:sequence>
       <xs:element name="LinkType" type="LinkTypeType" minOccurs="1" maxOccurs="unbounded" />
      </xs:sequence>
      </xs:complexType>
   <xs:element name="LinkTypes" type="LinkTypesType" />
</xs:schema>

Perguntas e respostas

P: Como adicionar um tipo de link personalizado?

R: Defina um arquivo de definição XML conforme o conteúdo fornecido neste tópico e depois use witadmin importlinktype para importar o arquivo de definição de tipo de link para a coleção de projeto que hospeda o projeto de equipe.

P: Que tipo de link é usado para vincular casos de teste a conjuntos de teste e testar conjuntos de teste para planos de teste?

R: Usando o Team Web Access ou o Test Manager, é possível visualizar que casos de teste são definidos para um conjunto de testes, e que conjuntos de testes são definidos para um plano de teste. Porém, esses objetos não estão vinculados uns aos outros por meio de tipos de link.

Consulte também

Conceitos

Personalizar objetos de acompanhamento de trabalho para dar suporte aos processos da sua equipe

Outros recursos

Vincular itens de trabalho para oferecer suporte à rastreabilidade

Compartilhar via