Definir controles de Link para restringir os relacionamentos de Link

  • Artigo

Você pode controlar qual trabalho itens estão vinculadas ao personalizar 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 um controle de links. Por exemplo, convém adicionar uma guia ao formulário que ajuda você a gerenciar os recursos dependentes. Naquela guia, você pode adicionar os links, controlam e restringem as relações de link que os membros da equipe podem exibir e fazer do que o controle para incluir apenas contém links para outros recursos.

Você pode usar o CONTROL elemento LinksControl Type atributo para permitir aos usuários criar relações de link entre itens de trabalho e outros objetos a Team Foundation banco de dados. Você pode usar o LinksControlOptions elementos filho para definir as opções para controlar quais membros da equipe de links podem adicionar um item de trabalho e quais tipos de item de trabalho ou objetos, eles podem link. Além disso, você pode definir as colunas padrão que você deseja exibir a lista de links desse controle.

Para obter um resumo das restrições do link que são definidos para o modelo de processo para o Microsoft Solutions Framework (MSF) para a v 5.0 do Agile Software Development, consulte Vinculando itens de trabalho (Agile). Para obter mais informações sobre os tipos de link, consulte Trabalhando com tipos de Link.

Neste tópico

  • Especificando o controle de Links

  • Controlando as relações de Link

  • Restringindo o Link relacionamentos aos itens de trabalho

  • Restringindo o Link relações Changesets, hiperlinks e outros itens de não trabalho

  • Restringindo os relacionamentos de Link para os tipos de itens de trabalho

  • Especificando as colunas padrão para exibição

Você pode usar o LinksControl opção para permitir aos usuários adicionar, exibir e gerenciar relacionamentos de link em um formulário de item de trabalho. Usando esse controle, você pode abrir, editar, adicionar e remover links.

Você pode personalizar um formulário para que uma guia exibe somente os links pai e filho e outra guia exibe todos os outros tipos de link. No exemplo a seguir, uma guia rotulada como "Todos os Links" é criado o que os membros podem usar para adicionar todos os tipos de link da equipe. Além disso, as colunas padrão que aparecem para a exibição de links são ID, o tipo de Item de trabalho, título, atribuído A, estado e o campo de comentário de Link.

Controle de links

Exemplo de controle de vínculos adicionado ao 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>

Voltar ao topo

Quando você adiciona um controle de link para um formulário de item de trabalho, você pode especificar filtros restringem os tipos de links e itens de trabalho que os membros da equipe podem adicionar quando eles usam o controle. A tabela a seguir descreve os elementos filho opcional que controlam os relacionamentos de link.

Elemento

Descrição

WorkItemLinkFilters

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

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, por exemplo, um conjunto de alterações, o hiperlink ou o item de controle de versão.

WorkItemTypeFilters

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

Filter

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

Voltar ao topo

Você pode usar o WorkItemLinkFilters e o Filter elementos filho para definir quais tipos de link, o controle de links deve incluir ou excluir. Você pode usar esse elemento para restringir os tipos de links que podem ser selecionados pelo controle de links para as relações do formulário 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

Obrigatório WorkItemLinkFilters atributo.

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

  • exclude: Use para impedir a criação de links desses tipos de link que estão listados na Filter elementos.

  • excludeAll: Use para impedir todos os tipos de link.

  • include: Use para permitir que esses tipos de link listados a Filter elementos.

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

LinkType

Obrigatório Filter atributo.

Especifica o nome de referência para um tipo de link. Para obter mais informações, consulte Trabalhando com tipos de Link.

FilterOn

Opcional Filter atributo.

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

  • forwardName: Use esta opção para filtrar o nome de encaminhamento que é definido para um tipo de link.

  • reverseName: Use esta opção para filtrar o nome inverso é definido para um tipo de link.

Se não for especificado, os nomes direta e inversas são usados para filtrar o tipo de link. Se a topologia de tipo de link é uma rede, os nomes de direta e inversas são os mesmos. Para obter mais informações, consulte Trabalhando com tipos de Link.

Exemplo: Excluindo os dois tipos de Link de Item de trabalho

Você pode definir um controle de links que permite que a link relacionamentos para todos os tipos de link, exceto de um tipo de link de requisito personalizado e o tipo de link de hierarquia do sistema usando o exemplo de código a seguir.

<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>

Voltar ao topo

Você pode usar o ExternalLinkFilters e o Filter elementos filho para definir qual link de tipos de itens que são externas ao projeto de equipe o controle de links devem incluir ou excluir. A sintaxe para esses elementos é como segue.

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

Atributo

Descrição

FilterType

Opcional ExternalLinkFilters atributo.

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

  • exclude: Use para impedir a criação de links desses tipos de link que estão listados na Filter elementos.

  • excludeAll: Use para impedir todos os tipos de link.

  • include: Use para permitir que esses tipos de link listados a Filter elementos.

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

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

LinkType

Obrigatório Filter atributo.

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

  • Corrigido no conjunto de alterações

  • Anexo de resultado

  • Arquivo de código fonte

  • Resultado de teste

  • Hiperlink do item de trabalho

Exemplo: Excluir todos os Links de Item de trabalho não

O exemplo a seguir define um controle de links que inclui todos os tipos de link para itens de trabalho, tais como relacionados e pai/filho, mas exclui tipos de link de não trabalho itens, como, por exemplo, 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 aos usuários especificar somente o tipo de link do changeset e o link apenas para conjuntos de alterações.

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

Voltar ao topo

Você pode usar o WorkItemTypeFilters e Filter trabalham de elementos filho para restringir os tipos de itens ao qual um controle de links podem link. Você pode restringir os relacionamentos 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

Opcional WorkItemTypeFilters atributo.

Define o escopo do filtro é aplicado ao conjunto de tipos de item de trabalho que é fornecido no conjunto de Filter elementos. Você pode 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 no Filter elementos.

  • project: Use esta opção para permitir a criação de links somente para esses tipos de item de trabalho que são definidos para o projeto atual.

Se não for especificado, os links para todos os tipos de item de trabalho são permitidas.

FilterType

Obrigatório WorkItemTypeFilters atributo.

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

  • exclude: Use para impedir os tipos de item de trabalho que estão listados na Filter elementos.

  • excludeAll: Use para impedir todos os tipos de item de trabalho.

  • include: Use para permitir que os tipos de item de trabalho que estão listados na Filter elementos.

  • includeAll: Use esta opção para permitir que todos os tipos de item de trabalho.

WorkItemType

Obrigatório Filter atributo.

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

Exemplo: Limitando as relações de Link para itens de trabalho da tarefa

O exemplo a seguir define um controle de links que permite que somente os relacionamentos hierárquicos sejam formadas a 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>

Voltar ao topo

Especificando as colunas padrão para exibição

Você pode usar o LinkColumns e LinkColumn elementos filho para especificar as colunas padrão para exibir no controle de links. Você pode especificar o nome de referência para um campo de item de trabalho ou um atributo de vínculo. A sintaxe para esses elementos é como segue.

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

A ordem na qual os elementos são listados define a ordem na qual os campos de coluna são exibidos no formulário de item de trabalho. Para obter uma lista de nomes de referência e os atributos de link, consulte Usando os campos de sistema e definidas pelos modelos de processo do MSF. A sintaxe a seguir define a exibição de quatro colunas: ID, estado, título e o atributo de link de comentário.

<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>

Voltar ao topo

Consulte também

Referência

Elementos de LinksControlOptions

Conceitos

Vinculando itens de trabalho (Agile)

Trabalhando com tipos de Link

Especificando os controles de formulário de Item de trabalho

Histórico de alterações

Date

History

Motivo

Julho de 2010

Adicionado a lista completa de nomes de referência que estão disponíveis para uso com o ExternalLinkFilters elemento. Fez outras pequenas revisões no texto para fins de esclarecimento.

Aprimoramento de informações.