Trabalhando com tipos de Link

Artigo
08/01/2011

Você pode usar um tipo de link para definir os rótulos do link, o tipo de topologia e restrições que são usadas quando os vínculos entre itens de trabalho são construídos. Por exemplo, o tipo de link pai-filho define dois rótulos (pai e filho), oferece suporte hierárquico ou topologia da árvore e impede que referências circulares sejam criados entre itens de trabalho.

Para personalizar ou criar um tipo de link, você pode importar um arquivo XML para a coleção de projeto de equipe que contém a definição de tipo de link. Tipos de link são adicionados ao conjunto de tipos de link são definidos para a coleção. Tipos de link existentes são sobrescritos com as novas informações com base no nome de referência que você especificar.

Conteúdo do Tópico

Estrutura de sintaxe
Requisitos para os tipos de Link
Tipos de Link definido pelo sistema
Tipos de link definidos pelos modelos de processo do MSF
Topologias e restrições de link
Definição de esquema do tipo de link

Estrutura de sintaxe

Você pode definir os tipos de link adicional, adicionando-os tipos de link são definidos para uma coleção de projeto de equipe. Você pode definir os tipos de vínculo válido para uso no seu processo de acordo com a 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 a sintaxe anterior:

Atributo	Descrição
Nome da referência	Nome do tipo de link. Este nome é usado internamente, quando você cria um vínculo entre dois itens de trabalho.
ForwardName	Nome do link ao item de trabalho de origem. Esse nome aparece quando você adicionar links para o item de trabalho de origem.
ReverseName	Nome do link ao item de trabalho de destino. Esse nome aparece quando é exibida uma listagem dos links no item de trabalho de destino.
TopologyType	Especifica o DirectedNetwork, Network, Tree, ou Dependency topologia. As primeiras três topologias são direcionais e usá-los para definir relacionamentos subordinados ou seqüenciais. Você pode usar Network para definir relacionamentos entre os peers ou onde não existe nenhum subordinação implícita.

A direcionalidade de link é determinada pelas atribuições feitas a ForwardName e ReverseName atributos. Se você cria um link personalizado e atribuir o mesmo nome dos nomes direta e inversa, você deve definir o tipo de link para Network porque ele é a topologia de apenas não bidirecional.

Requisitos para os tipos de Link

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

Cada tipo de link tem um nome de referência e dois de nomes amigáveis opcionais ou rótulos de nome, o que devem ser exclusivos dentro da coleção do projeto. Cada nome de tipo de link deve atender aos seguintes requisitos:

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

Tipos de Link definido pelo sistema

A tabela a seguir resume os tipos de link são definidos pelo sistema. Esses tipos de link não devem ser substituídos ou modificados de maneira alguma.

Encaminhar nome	Nome inverso	Nome de referência de tipo de link	Topologia
Sucessoras	Predecessora	System.LinkTypes.Dependency	Dependência
Filho	Pai	System.LinkTypes.Hierarchy	Tree
Relacionados	Relacionados	System.LinkTypes.Related	Network

Tipos de link definidos pelos modelos de processo do MSF

A tabela a seguir lista os tipos de link são criados quando você cria um projeto de equipe usando um modelo de processo de Microsoft Solutions Framework (MSF). Esses tipos de link projetados especificamente para oferecer suporte a interação com o rastreamento de itens de trabalho em Team Foundation e Microsoft Test Manager.

Encaminhar nome	Nome inverso	Nome de referência de tipo de link	Topologia
Testado pela	Tests (Testes)	Microsoft.VSTS.Common.TestedBy	Dependência
Caso de teste	Etapas compartilhadas	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Dependência

Quando você usa um modelo de processo do MSF para criar um projeto de equipe, cada um dos tipos de link listados anteriormente neste tópico são adicionados à coleção de projeto de equipe. Arquivos de definição de tipo de link são definidos na pasta Tracking\LinkTypes do item de trabalho do arquivo Template.zip. A seguinte definição para o tipo de link de Microsoft.VSTS.Common.TestedBy é definida 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>

Quando você cria um projeto de equipe usando o modelo de processo correspondente, a definição de tipo de link é importada para a coleção de projeto.

Topologias e restrições de link

A topologia que é atribuída a um tipo de link determina as restrições que são adicionadas para seu uso. Na tabela a seguir, você pode exibir os tipos diferentes de topologia:

Tipo de topologia	Ilustração
Rede: Você pode usar os links de rede para criar relações básicas entre os itens de trabalho não-restritivos. O link é a mesma em ambos os pontos de extremidade. Relações circulares são permitidas. Exemplo de uso: Use um link de rede, como, por exemplo, relacionadas, para registrar uma relação entre dois recursos que podem compartilhar as dependências.
Direcionado a rede: Você pode usar os links de rede direcionado para criar relações entre itens de trabalho que indicam a direcionalidade. O nome do link é diferente nos pontos de extremidade. Relações circulares são permitidas. Exemplo de uso: Use um link de rede direcionado para registrar uma relação entre dois recursos que podem compartilhar as dependências e que você queira fazer distinção entre si de alguma maneira.
Dependência: Você pode usar os links de dependência para criar relações entre itens de trabalho que têm a direcionalidade e restringir relações circulares. O nome do link é diferente nos pontos de extremidade. Na ilustração, você não pode criar um link dependente para um item de trabalho contém relações de link dependentes para os mesmos itens de trabalho. Exemplo de uso: Use o link de dependência para registrar os recursos que devem ser concluídos para oferecer um requisito de usuário.
Árvore: Você pode usar os links de árvore para criar vários níveis relações hierárquicas entre os itens de trabalho. Links de árvore exibições hierárquicas de vários níveis de suporte, tem direcionalidade e restringem relações circulares. O nome do link é diferente nos pontos de extremidade. Links de árvore são o único tipo de link é compatível com o Árvore de itens de trabalho consulta. Na ilustração, você não pode atribuir dois pais para um filho. Exemplo de uso: Use um link de árvore para registrar as tarefas e subtarefas de sua equipe que devem ser concluídas para oferecer 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>