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

  • Artigo

Você pode controlar quais itens de trabalho links entre si 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 em um controle de links.Por exemplo, convém adicionar um guia para seu formulário que ajuda 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 esse controle para incluir somente links para outros recursos.

Você usa o atributo de LinksControlType do elemento de Control para permitir que os usuários para criar 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 ou objetos de trabalho podem adicionar.Além disso, você pode definir as colunas padrão que você deseja que apareça para a lista de links nesse controle.

Para um resumo das limitações de link que são definidas para o modelo de processo para Microsoft solutions Framework (MSF) a programação de software agile v5.0, consulte Referência de campo, restrições e vincular controles.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

  • Relações de link de controle

  • Relações de link a restrição de itens de trabalho

  • Relações de restrição de link para conjuntos de alterações, a hiperlinks, e outros itens de trabalho que

  • Relações de restrição de link aos tipos de itens de trabalho

  • Especificando as colunas padrão para exibir

Você usa a opção de LinksControl permitir que usuários adicionem, para exibir, e para gerenciar o link as relações em um item de trabalho forms.Usando esse controle, você pode abrir, editar, adicione, remova e links.

Você pode personalizar um formulário de modo que uma guia exibe somente os links pai e filho e outro guia exibe todos os tipos de link restantes.No exemplo a seguir, um guia que é rotulado “todos os links” é criado que os membros da equipe podem usar 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, o estado, e o campo de comentário de link.

Controle de links

Exemplo de controle de links 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

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

Elemento

Descrição

WorkItemLinkFilters

Restringe os tipos de links que podem ser usados para vincular para trabalhar itens.

ExternalLinkFilters

Restringe os tipos de links que podem ser usados para vincular a um objeto que não é um tipo de item de trabalho, como um conjunto de alterações, hiperlink, ou o item de controle de versão.

WorkItemTypeFilters

Restringe os tipos de itens de trabalho que um usuário pode vincular, e a equipe projetos na qual os itens de trabalho são definidos.

Filter

Especifica os tipos de link ou os tipos de itens de trabalho que você deseja incluir ou excluir.

De volta ao topo

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

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

Atributo

Descrição

FilterType

Atributo necessário de WorkItemLinkFilters .

Define o método usado para filtrar o conjunto de tipos de link que é fornecido no conjunto de elementos de Filter .Você pode usar os seguintes valores válidos:

  • exclude: Uso evitar a criação de links estes tipos de link que estão listados nos elementos de Filter .

  • excludeAll: Uso não permitir todos os tipos de link.

  • include: Uso permitir somente os tipos de link que estão listados nos elementos de Filter .

  • includeAll: Uso permitir a criação de links de todos os tipos de link.

LinkType

Atributo necessário de Filter .

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 opcional de Filter .

Especifica o tipo de filtro para aplicar o tipo de link.Você pode usar os seguintes valores válidos:

  • forwardname: Uso filtragem no nome para que é definido para um tipo de link.

  • reversename: Uso filtragem no nome invertido que é definido para um tipo de link.

Se não especificado, os nomes dianteiros e reversa são usados para filtrar o tipo de link.Se a topologia de tipo de link é rede, os nomes dianteiros e reversa 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 links que permite relações de link para todos os tipos de link a não ser que um tipo de link de descarte alfandegária e o tipo de link da hierarquia do sistema 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

Você usa ExternalLinkFilters e elementos filho de Filter para definir os tipos de link para itens que são externos ao projeto de equipe o controle de links devem incluir ou excluir.A sintaxe para esses elementos é da seguinte maneira.

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

Atributo

Descrição

FilterType

Atributo opcional de ExternalLinkFilters .

Define o método usado para filtrar o conjunto de tipos de link que são fornecidos no conjunto de elementos de Filter .Você pode usar os seguintes valores válidos:

  • exclude: Uso não permitir a criação de links estes tipos de link que estão listados nos elementos de Filter .

  • excludeAll: Uso não permitir todos os tipos de link.

  • include: Uso permitir somente os tipos de link que estão listados nos elementos de Filter .

  • includeAll: Uso permitir a criação de links 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 necessário de Filter .

Especifica o nome da referência para um tipo de link para excluir ou incluir.Você pode especificar os seguintes tipos de link:

  • Fixo em conjunto de alterações

  • Anexo de resultado

  • Arquivos de código-fonte

  • Resultado de teste

  • Hyperlink Workitem

Exemplo: Excluir todos os links de item de trabalho que

O exemplo a seguir define um controle links que inclui todos os tipos de link para trabalhar itens, como relacionado e o pai/filho, mas não exclui itens de trabalho dos tipos de link, 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 o link somente aos 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

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

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

Atributo

Descrição

Scope

Atributo opcional de WorkItemTypeFilters .

Define o escopo de filtro que é aplicado ao conjunto de tipos de item de trabalho que é fornecido no conjunto de elementos de Filter .Você pode usar os seguintes valores válidos:

  • all: Uso permitir a criação de links para todos os tipos de itens de trabalho que são especificados nos elementos de Filter .

  • project: Uso permitir a criação de links apenas 2 esses tipos de item de trabalho que são definidos para o projeto atual.

Se não especificado, links para todos os tipos de itens de trabalho são permitidos.

FilterType

Atributo necessário de WorkItemTypeFilters .

Define o método usado para filtrar o conjunto de tipos de link que é fornecido no conjunto de elementos de Filter .Você pode usar os seguintes valores válidos:

  • exclude: Uso não permitir os tipos de itens de trabalho que estão listados nos elementos de Filter .

  • excludeAll: Uso não permitir todos os tipos de itens de trabalho.

  • include: Uso permitir os tipos de itens de trabalho que estão listados nos elementos de Filter .

  • includeAll: Uso permitir a todos os tipos de itens de trabalho.

WorkItemType

Atributo necessário de Filter .

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

Exemplo: Limitando relações de link para encarregar itens de trabalho

O exemplo a seguir define um controle links que permite que somente as relações hierárquicas são formadas as 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

Especificando as colunas padrão para exibir

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

<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 atributos de link, consulte Referência de campos de item de trabalho para o Visual Studio ALM.A sintaxe a seguir define a exibição de quatro colunas: Identificação, estado, título, e o comentário de atributo 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

Consulte também

Referência

Elementos de LinksControlOptions

Conceitos

Referência de campo, restrições e vincular controles

Referência de elementos de tipo de link

Especificar controles de formulário de item de trabalho

Alterar Histórico

Date

History

Razão

Em setembro de 2012

Corrigir a estrutura dos casos de sintaxe.Todos os valores enumerados diferenciam maiúsculas de minúsculas.

Correção de bug de conteúdo.