Referência de elementos de tipo de link
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 Gerenciar dependências, vincular itens de trabalho para dar 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.
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
Gerenciar dependências, vincular itens de trabalho para dar suporte à rastreabilidade