Definir controles de link para restringir as relações de link

Artigo
06/10/2015

Você pode controlar quais itens de trabalho se vinculam, personalizando o formulário de trabalho. Especificamente, você pode controlar os tipos de links e itens de trabalho que os usuários podem exibir e adicionar a um controle de links. Por exemplo, talvez você queira adicionar uma guia ao seu formulário que ajude você a gerenciar recursos dependentes. Nessa guia, você pode adicionar o controle de links e restringir as relações de link que os membros da equipe podem exibir e fazer a partir desse controle para incluir somente links para outros recursos.

Você usa o atributo de LinksControl Type do elemento de Control para permitir que os usuários criem relações de link entre itens de trabalho e outros objetos no banco de dados de Team Foundation . Você pode usar elementos filhos de LinksControlOptions para definir as opções para controlar links que os membros da equipe podem adicionar a um item de trabalho e que tipos de item de trabalho ou objetos podem ser vinculados. Além disso, você pode definir as colunas padrão que você deseja que apareçam para a lista de links nesse controle.

Para obter um resumo das limitações de link definidas para modelos de processo do TFS, consulte Vincular controles, restrições e referência de campo. Para obter mais informações sobre tipos de link, consulte Referência de elementos de tipo de link.

Neste tópico

Especificando o controle de links
Controlando relações de link
Restringindo Relações de Itens de Trabalho
Restringindo Relações de Link a Conjuntos de Alterações, Hiperlinks e Outros Itens de Não Trabalho
Restringindo Relações de Link a Tipos de Itens de Trabalho
Especificar as colunas padrão a serem exibidas

Especificando o controle de links

Você usa a opção de LinksControl para permitir que usuários adicionem, visualizem e gerenciem as relações de link em um formulário de item de trabalho. Usando este controle, você pode abrir, editar, adicionar e remover links.

Você pode personalizar um formulário de modo que uma guia exiba somente os links pai e filho e outra guia exiba todos os tipos de link restantes. No exemplo a seguir, uma guia rotulada como "Todos os Links" é criada e pode ser usada por membros da equipe para adicionar todos os tipos de link. Além disso, as colunas padrão que aparecem para a exibição dos links são ID, tipo de item de trabalho, título, atribuído a, estado, e o campo de comentário do link.

Controle de Links

Exemplo de controle de vínculos adicionado a um formulário de item de trabalho

<Tab Label="All Links">
   <Control Type="LinksControl" Name="All" >
      <LinksControlOptions>
         <LinkColumns>
            <LinkColumn RefName="System.ID" />
            <LinkColumn RefName="System.WorkItemType" />
            <LinkColumn RefName="System.Title" />
            <LinkColumn RefName="System.AssignedTo" />
            <LinkColumn RefName="System.State" />
            <LinkColumn LinkAttribute="System.Links.Comment" />
         </LinkColumns>
      </LinksControlOptions>
   </Control>
</Tab>

De volta ao topo

Controlando relações de link

Ao adicionar um controle de link em um formulário de item de trabalho, você pode especificar filtros que restringem os tipos de links e itens de trabalho que os membros da equipe podem adicionar quanto usam o controle. A tabela a seguir descreve os elementos filho opcionais que controlam as relações de link.

Elemento	Descrição
WorkItemLinkFilters	Restringe os tipos de link que podem ser usados para vinculação aos itens de trabalho.
ExternalLinkFilters	Restringe os tipos de link que podem ser usados para vincular a um objeto que não é um tipo de item de trabalho, como conjunto de alterações, hiperlink o item de controle de versão.
WorkItemTypeFilters	Restringe os tipos de item de trabalho aos quais um usuário pode se vincular e os projetos de equipe nos quais esses itens de trabalho são definidos.
Filter	Especifica os tipos de link ou os tipos de item de trabalho que você deseja incluir ou excluir.

De volta ao topo

Restringindo Relações de Itens de Trabalho

Você usa WorkItemLinkFilters e elementos filho de Filter para definir quais tipos de link o controle de links deve incluir ou excluir. Você usa esse elemento para restringir os tipos de links que podem ser selecionados pelo controle de links para formar relações a itens de trabalho que são definidos no mesmo projeto. A sintaxe para esses elementos é como segue.

<WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
</WorkItemLinkFilters>

Atributo	Descrição
FilterType	Atributo WorkItemLinkFilters obrigatório. Define o método usado para filtrar o conjunto de tipos de links que é fornecidos no conjunto de elementos Filter. É possível usar os seguintes valores válidos: exclude: use para impedir a criação de links a partir dos tipos de link que são listados nos elementos de Filter. excludeAll: use para não permitir todos os tipos de link. include: use para permitir somente os tipos de link que estão listados nos elementos Filter. includeAll: use para permitir a criação de links a partir de todos os tipos de link.
LinkType	Atributo Filter obrigatório. Especifica o nome da referência para um tipo de link. Para obter mais informações, consulte Referência de elementos de tipo de link.
FilterOn	Atributo Filter opcional. Especifica o tipo de filtro a ser aplicado ao tipo de link. É possível usar os seguintes valores válidos: forwardname: Use para filtrar no nome seguinte definido para um tipo de link. reversename: use para filtrar no nome reverso definido para um tipo de link. Se não for especificado, os nomes seguintes e reversos são usados para filtrar o tipo de link. Se a topologia de tipo de link é Rede, os nomes seguintes e reversos são os mesmos. Para obter mais informações, consulte Referência de elementos de tipo de link.

FilterType

Atributo WorkItemLinkFilters obrigatório.

Define o método usado para filtrar o conjunto de tipos de links que é fornecidos no conjunto de elementos Filter. É possível usar os seguintes valores válidos:

exclude: use para impedir a criação de links a partir dos tipos de link que são listados nos elementos de Filter.
excludeAll: use para não permitir todos os tipos de link.
include: use para permitir somente os tipos de link que estão listados nos elementos Filter.
includeAll: use para permitir a criação de links a partir de todos os tipos de link.

LinkType

Atributo Filter obrigatório.

Especifica o nome da referência para um tipo de link. Para obter mais informações, consulte Referência de elementos de tipo de link.

FilterOn

Atributo Filter opcional.

Especifica o tipo de filtro a ser aplicado ao tipo de link. É possível usar os seguintes valores válidos:

forwardname: Use para filtrar no nome seguinte definido para um tipo de link.
reversename: use para filtrar no nome reverso definido para um tipo de link.

Se não for especificado, os nomes seguintes e reversos são usados para filtrar o tipo de link. Se a topologia de tipo de link é Rede, os nomes seguintes e reversos são os mesmos. Para obter mais informações, consulte Referência de elementos de tipo de link.

Exemplo: excluindo de dois tipos de link de item de trabalho

Você pode definir um controle de vínculo que permite relações de vínculo para todos os tipos de link, com exceção de um tipo de link requisito padrão e do tipo de link do sistema de hierarquia, usando o seguinte exemplo de código.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="exclude">
         <Filter LinkType="MyLinks.LinkTypes.Requirement" /> 
         <Filter LinkType="System.LinkTypes.Hierarchy" /> 
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
. . .
</Control>

De volta ao topo

Restringindo Relações de Link a Conjuntos de Alterações, Hiperlinks e Outros Itens de Não Trabalho

Você usa ExternalLinkFilters e elementos filho de Filter para definir quais tipos de link para itens que são externos ao projeto de equipe o controle de links deve incluir ou excluir. A sintaxe para esses elementos é como segue.

<ExternalLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="externalLinkName" />
</ExternalLinkFilters>

Atributo	Descrição
FilterType	Atributo ExternalLinkFilters opcional. Define o método usado para filtrar o conjunto de tipos de links que são fornecidos no conjunto de elementos Filter. É possível usar os seguintes valores válidos: exclude: use para não permitir a criação de links a partir dos tipos de link que são listados nos elementos de Filter. excludeAll: use para não permitir todos os tipos de link. include: use para permitir somente os tipos de link que estão listados nos elementos Filter. includeAll: use para permitir a criação de links a partir de todos os tipos de link. Se não for especificado, todos os links para itens de trabalho externos são excluídos.
LinkType	Atributo Filter obrigatório. Especifica o nome da referência para um tipo de link a ser excluído ou incluído. É possível especificar os seguintes tipos de link: Corrigido no conjunto de alterações Anexo de Resultado Arquivo de código fonte Resultado do Teste Hyperlink do item de trabalho

FilterType

Atributo ExternalLinkFilters opcional.

Define o método usado para filtrar o conjunto de tipos de links que são fornecidos no conjunto de elementos Filter. É possível usar os seguintes valores válidos:

exclude: use para não permitir a criação de links a partir dos tipos de link que são listados nos elementos de Filter.
excludeAll: use para não permitir todos os tipos de link.
include: use para permitir somente os tipos de link que estão listados nos elementos Filter.
includeAll: use para permitir a criação de links a partir de todos os tipos de link.

Se não for especificado, todos os links para itens de trabalho externos são excluídos.

LinkType

Atributo Filter obrigatório.

Especifica o nome da referência para um tipo de link a ser excluído ou incluído. É possível especificar os seguintes tipos de link:

Corrigido no conjunto de alterações
Anexo de Resultado
Arquivo de código fonte
Resultado do Teste
Hyperlink do item de trabalho

Exemplo: exclua todos os links de não itens de trabalho

O exemplo a seguir define um controle de links que inclui todos os tipos de link em itens de trabalho, como relacionado e pai/filho, mas exclui tipos de link em itens que não são de trabalho, como conjuntos de alterações, hiperlinks e resultados de teste.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="includeAll" /> 
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
</Control>

O exemplo a seguir define um controle de link que permite que os usuários especifiquem somente o tipo de link do conjunto de alterações e vinculem apenas a conjuntos de alterações.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="excludeAll"/>
      <ExternalLinkFilters FilterType="include" /> 
         <Filter LinkType="Fixed in Changeset" />
      </ExternalLinkFilters> 
 </LinksControlOptions>
. . .
</Control>

De volta ao topo

Restringindo Relações de Link a Tipos de Itens de Trabalho

Você usa elementos filho de WorkItemTypeFilters e de Filter para restringir os tipos de itens de trabalho que um controle de links pode vincular. Você pode restringir relações de link para o projeto de equipe ou por tipo de item de trabalho. A sintaxe para esses elementos é como segue.

<WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" >
   <Filter WorkItemType="workItemTypeReferenceName" />
</WorkItemTypeFilters>

Atributo	Descrição
Scope	Atributo WorkItemTypeFilters opcional. Define o escopo do filtro aplicado ao conjunto de tipos de item de trabalho fornecidos no conjunto de elementos Filter. É possível usar os seguintes valores válidos: all: use para permitir a criação de links para todos os tipos de item de trabalho que são especificados nos elementos de Filter. project: use para permitir que links sejam criados somente para os tipos de item de trabalho definidos para o projeto atual. Se não for especificado, links para todos os tipos de itens de trabalho são excluídos.
FilterType	Atributo WorkItemTypeFilters obrigatório. Define o método usado para filtrar o conjunto de tipos de links que é fornecidos no conjunto de elementos Filter. É possível usar os seguintes valores válidos: exclude: use para não permitir os tipos de item de trabalho que são listados nos elementos Filter. excludeAll: use para não permitir todos os tipos de item de trabalho. include: use para permitir os tipos de item de trabalho que são listados nos elementos Filter. includeAll: Use para permitir todos os tipos de item de trabalho.
WorkItemType	Atributo Filter obrigatório. Especifica o nome da referência para um tipo de item de trabalho.

Scope

Atributo WorkItemTypeFilters opcional.

Define o escopo do filtro aplicado ao conjunto de tipos de item de trabalho fornecidos no conjunto de elementos Filter. É possível usar os seguintes valores válidos:

all: use para permitir a criação de links para todos os tipos de item de trabalho que são especificados nos elementos de Filter.
project: use para permitir que links sejam criados somente para os tipos de item de trabalho definidos para o projeto atual.

Se não for especificado, links para todos os tipos de itens de trabalho são excluídos.

FilterType

Atributo WorkItemTypeFilters obrigatório.

Define o método usado para filtrar o conjunto de tipos de links que é fornecidos no conjunto de elementos Filter. É possível usar os seguintes valores válidos:

exclude: use para não permitir os tipos de item de trabalho que são listados nos elementos Filter.
excludeAll: use para não permitir todos os tipos de item de trabalho.
include: use para permitir os tipos de item de trabalho que são listados nos elementos Filter.
includeAll: Use para permitir todos os tipos de item de trabalho.

WorkItemType

Atributo Filter obrigatório.

Especifica o nome da referência para um tipo de item de trabalho.

Exemplo: limitando relações de link a itens de trabalho de tarefa

O exemplo a seguir define um controle de links que permite que somente relações hierárquicas sejam formadas para tarefas que são definidas no projeto de equipe.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="System.LinkTypes.Hierarchy" />
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll"/>
      <WorkItemTypeFilters Scope ="project" FilterType="include" />
         <Filter WorkItemType="Task" />
      </WorkItemTypeFilters> 
   </LinksControlOptions>
. . .
</Control>

De volta ao topo

Especificar as colunas padrão a serem exibidas

Você usa elementos filho de LinkColumns e de LinkColumn para especificar as colunas padrão a serem exibidas no controle de links. Você pode especificar qualquer o nome da referência para um campo de item de trabalho ou um atributo de link. A sintaxe para esses elementos é como segue.

<LinkColumns>
   <LinkColumn RefName="reference name" | LinkAttribute=" link attribute name" />
</LinkColumns>

A ordem em que os elementos são listados define a ordem em que os campos de coluna são exibidos no formulário de item de trabalho. Para obter uma lista de nomes de referência e de atributos de link, consulte Referência de campo de item de trabalho do Visual Studio ALM. A sintaxe a seguir define a exibição de quatro colunas: ID, Estado, Título e o Comentário do atributo de link.

<Control Type="LinksControl">
. . .
   <LinksControlOptions>
      <LinkColumns>
         <LinkColumn RefName="System.ID" />
         <LinkColumn RefName="System.State" />
         <LinkColumn RefName="System.Title" />
         <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

De volta ao topo