Referência de elementos de tipo de link

Artigo
02/25/2013

Use um tipo de link para definir os rótulos do link, tipo de topologia e restrições que são usadas quando os links entre itens de trabalho são construídos.Por exemplo, o tipo de vínculo pai-filho define dois rótulos (pai e filho), 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 para o tipo de link.Tipos de link são adicionados ao conjunto de tipos de link definido para a coleção.Tipos de link existentes serão substituídos com as novas informações com base no nome de referência que você especificar.

Neste tópico

Estrutura de sintaxe
Requisitos para 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 tipos de link adicionais adicionando-os tipos de link definidos para uma coleção de projeto de equipe.Você pode definir tipos de link válido para uso no seu processo com base na estrutura que fornece o esquema de definição de tipo de link.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 se aplicam a sintaxe anterior:

Atributo	Descrição
Nome da referência	Nome do tipo de link.Esse nome é usado internamente quando você cria um vínculo entre dois itens de trabalho.
ForwardName	Nome do link no item de trabalho de origem.Esse nome aparece quando você adicionar links para o item de trabalho de origem.
ReverseName	Nome do link no item de trabalho de destino.Esse nome aparece quando é exibida uma listagem de links no item de trabalho de destino.
TopologyType	Specifies the DirectedNetwork, Network, Tree, or Dependency topology.As primeiras três topologias são direcionais e usá-las para definir relações subordinadas ou seqüenciais.Usar Network para definir relacionamentos entre colegas ou onde não existe nenhuma subordinação implícita.

Link direcionalidade é 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 a topologia somente não-direcional.

Requisitos para tipos de Link

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

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

Nomes podem ter até 254 caracteres Unicode.
Nomes não pode ser vazios.
Nomes não podem ter espaços em branco à direita ou à esquerda.
Nomes não podem conter caracteres de barra invertida (\).
Nomes não podem conter dois espaços em branco consecutivos.

Tipos de Link definido pelo sistema

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

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

Além disso, o Storyboard vincular itens de trabalho do tipo links para qualquer arquivo localizado em um compartilhamento de rede ou storyboards.Para mais informações, consulte Elementos de LinksControlOptions.

Tipos de link definidos pelos modelos de processo do MSF

A tabela a seguir lista os tipos de link são criados quando você criar um projeto de equipe usando um modelo de processo Microsoft Solutions Framework (MSF).Esses tipos de link são projetados especificamente para dar suporte à interação com 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 pelo	Testes	Microsoft.VSTS.Common.TestedBy	Dependência
Caso de teste	Etapas compartilhadas	Microsoft.VSTS.TestCase.SharedStepReferencedBy	Dependência

Cada um dos tipos de link listados neste tópico são adicionados à coleção de projeto de equipe ao usar um modelo de processo MSF para criar um projeto de equipe.Arquivos de definição de tipo de link são definidos na pasta de trabalho Tracking\LinkTypes 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 o projeto de equipe usando o modelo de processo correspondente, a definição de tipo de vínculo é importada para a coleção do projeto.

Topologias e restrições de link

A topologia é atribuída a um tipo de link determina as restrições são adicionadas para seu uso.A 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 é o mesmo em ambos os pontos finais.Relações circulares são permitidas. Exemplo de uso: usar um link de rede, como relacionadas, para registrar um relacionamento entre dois recursos que podem compartilhar as dependências.
Direcionado a rede: você pode usar links de rede direcionado para criar relações entre itens de trabalho que indicam a direção.O nome do link é diferente nos pontos finais.Relações circulares são permitidas. Exemplo de uso: usar um link de rede direcionado para registrar um relacionamento entre dois recursos que podem compartilhar as dependências e o que você deseja diferenciar entre si de alguma maneira.
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. Na ilustração, você não pode criar um link dependente para um item de trabalho contém relações dependentes de link para os mesmos itens de trabalho. Exemplo de uso: usar um link de dependência para registrar os recursos que devem ser concluídos para entregar um requisito do usuário.
Árvore: você pode usar 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 finais.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: usar um link de árvore para tarefas e subtarefas de sua equipe devem ser concluídas para fornecer um recurso de registro.

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>