Share via

Adicionar definições de tipo de link para um modelo de processo

  • Artigo

Você pode definir tipos adicionais de links que os membros da equipe podem criar entre itens de trabalho para um projeto de equipe. Um tipo de link define os rótulos e as regras que regem as relações ou os links entre os itens de trabalho daquele tipo. Os tipos de link que você especifica suplementam os tipos padrão para links hierárquicos, dependentes e relacionados. Você especifica o arquivo de definição para cada tipo de link em um arquivo separado, ou você pode especificar todos eles em um arquivo. Você especifica os arquivos de definição a serem carregados no elemento taskxml do plug-in WorkItemTracking.

Os modelos de processo do Team Foundation Server (TFS) definem dois tipos de links referenciados nas definições de vários tipos de itens de trabalho. Eles existem além dos tipos de link definidos pelo sistema. Para obter mais informações, consulte Referência de elementos de tipo de link.

As definições de tipo para links devem ser carregadas antes das definições de tipo para itens de trabalho. Para obter mais informações, consulte Definir dependências para grupos de tarefas e tarefas em arquivos de plug-in.

Depois que um projeto de equipe é criado, você pode adicionar, remover, renomear, e alterar os tipos de links para uma coleção de projeto de equipe, usando a ferramenta de linha de comando witadmin. Para obter mais informações, consulte Gerenciar tipos de link [witadmin].

Você deve especificar cada definição de tipo de link usando o elemento de LinkType. Além disso, cada definição deve estar de acordo com a definição de esquema para os tipos de link que estão definidos no arquivo workitemlinktypedefinition-01.xsd. É possível baixar os arquivos de esquema para trabalho de acompanhamento da seguinte página no site da Microsoft: Esquemas de modelo de processo e de item de trabalho para o Visual Studio Team Foundation.

O exemplo a seguir mostra a estrutura de sintaxe que define um tipo de link TestedBy.

<?xml version="1.0" encoding="utf-8"?>
<LinkTypes>
  <LinkType ReferenceName="Microsoft.VSTS.Common.TestedBy" ForwardName="Tested By" ReverseName="Tests" Topology="Dependency" />
</LinkTypes>

Você pode personalizar ou criar arquivos de definição para tipos de links na pasta de LinkTypes. Para obter mais informações sobre como definir um tipo de link, consulte Definir um tipo de link personalizado.

De volta ao topo

Para carregar uma definição de tipo de link no modelo de processo, especifique o elemento LINKTYPE dentro do elemento taskxml. O atributo de nome de arquivo é um caminho relativo do arquivo de definição para o tipo de link. Por exemplo, a sintaxe a seguir especifica que o arquivo TestedBy.xml será carregado.

<LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />

O exemplo a seguir mostra como especificar uma tarefa que cria os dois tipos de links definidos no modelo de processo para o MSF for Agile Software Development v5.0. Esses tipos correspondem aos tipos de link SharedStep e TestedBy.

<task id="LinkTypes" name="LinkType definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item link types created">
   <taskXml>
      <LINKTYPES>
         <LINKTYPE fileName="WorkItem Tracking\LinkTypes\SharedStep.xml" />
         <LINKTYPE fileName="WorkItem Tracking\LinkTypes\TestedBy.xml" />
      </LINKTYPES>
   </taskXml>
</task>

De volta ao topo

Referência do elemento LINKTYPES

A tabela a seguir descreve os elementos que você usa para carregar definições de tipo de link. Você especifica esses elementos em um elemento do contêiner taskXml no arquivo de plug-in WorkItemTracking.

Dica

Você especifica o arquivo que define os tipos de link a serem carregados usando o elemento LINKTYPE (WorkItemTracking).Você especifica o nome de um tipo de link a ser definido usando o elemento LinkType (Definition).

Elemento

Sintaxe

Descrição

LINKTYPE

 
<LINKTYPE fileName="LinkTypeFilePathName" />

Elemento filho necessário de LINKTYPES.

Especifica o caminho e o nome de um arquivo que contém uma definição de tipo de link para carregar.

LINKTYPES

 
<LINKTYPES>
     <LINKTYPE />
 . . .
</LINKTYPES>

Elemento filho opcional do plug-in de WorkItemTracking.

Contém uma coleção de elementos LINKTYPE em que cada um especifica um arquivo de definição a ser carregado.

Consulte também

Referência

Gerenciar tipos de link [witadmin]

Conceitos

Definir objetos para acompanhar itens de trabalho usando o plug-in de acompanhamento de item de trabalho

Outros recursos

Definir um tipo de link personalizado