Elementos de LinksControlOptions

Artigo
03/12/2013

Você usa o elemento de LinksControlOptions para definir as opções para controlar links que podem ser adicionados a um item de trabalho e colunas padrão que você deseja que apareça para a lista de links de um item de trabalho.Quando você adiciona um controle links para um formulário de item de trabalho, você pode especificar os filtros que restringe os tipos de links que os usuários podem ser exibição e criar e os tipos de itens de trabalho que os usuários podem criar links.Especificamente, você usa os seguintes elementos conforme indicado:

WorkItemLinkFilters: Uso restringir os tipos de links entre itens de trabalho no projeto de equipe atual.
ExternalLinkFilters: O uso restringir os tipos de links que podem ser criados entre itens de trabalho e outros objetos, como conjuntos de alterações, hiperlinks, ou a versão controlaram arquivos.
WorkItemTypeFilters: O uso restringir as relações de link que os usuários podem criar com base no tipo de item de trabalho e se o item de trabalho é definido no projeto de equipe atual.

Em cada um desses elementos, você pode especificar os elementos de Filter para especificar os tipos de link ou os tipos de itens de trabalho que você deseja incluir ou excluir.Para obter mais informações sobre como usar esses elementos, consulte Definir controles de link para restringir as relações de link.

Um elemento LinksControlOptions é um filho do elemento CONTROL.

Hierarquia de esquema

<xs:element name="LinksControlOptions" type="LinksControlOptionsType" minOccurs="0"/> <xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/> <xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/> <xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" /> <xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/> <xs:element name="WorkItemTypeFilters" type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" /> <xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/> <xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" /> <xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>

<LinksControlOptions> <WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll"> <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" /> </WorkItemLinkFilters> <ExternalLinkFilters FilterType ="include | exclude | includeAll | excludeAll"> <Filter LinkType="externalLinkName"/> </ExternalLinkFilters> <WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" /> <Filter WorkItemType="workItemTypeReferenceName"/> </WorkItemTypeFilters> <LinkColumns> <LinkColumn RefName="reference name" | LinkAttribute="link attribute name"/> </LinkColumns> </LinksControlOptions>

Atributos e elementos

As seções a seguir descrevem elementos filho, atributos, e elementos pai.

Elementos filhos e atributos

Elemento	Atributo	Descrição
LinksControlOptions		Elemento opcional de Control quando type="LinksControl". Fornece um recipiente para os elementos que definem links que podem ser adicionados a um item de trabalho e colunas padrão para aparecer para a lista de relações de link em um item de trabalho. O tipo de elemento é tipo complexo: LinksControlOptionsType.
WorkItemLinkFilters		Elemento opcional de LinksControlOptions . Fornece um recipiente para um ou mais elementos de Filter que especificam os critérios de filtragem de link para usar para tipos de link que são definidos para a coleção de projeto de equipe e que criam relações entre itens de trabalho. O tipo de elemento é tipo complexo: WorkItemLinkFiltersType.
	FilterType	Atributo necessário de WorkItemLinkFilters . Define o método usado para filtrar o conjunto de tipos de link fornecidos no conjunto de elementos de Filter .O tipo de elemento é tipo simples: LinksControlFilterKind. Os valores válidos que você pode usar são: exclude: Uso não permitir links para ser criados estes tipos de link listados nos elementos de Filter . excludeAll: Uso não permitir todos os tipos de link. include: Uso permitir somente os tipos de link listados nos elementos de Filter . includeAll: Uso permitir que os links são criados de todos os tipos de link.
Filter		Elemento necessário de WorkItemLinkFilters quando FilterType for exclude ou include. Quando FilterType é excludeAll ou includeAll, nenhum elemento de Filter deve ser especificado. Especifica os tipos de links que devem ser incluídos ou excluída do conjunto de links que podem ser criados para o item de trabalho.O tipo de elemento é tipo simples: WorkItemLinkFilterElementType.
	LinkType	Atributo necessário de Filter . Especifica o nome da referência para um tipo de link.Os tipos válidos incluem tipos de link definidos sistema seguir: Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related Além disso, você pode especificar o nome da referência para os tipos de link personalizados definidos para a coleção de projeto de equipe.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.O tipo de elemento é tipo simples: LinksControlFilterOnKind. Os valores válidos são: forwardname: Uso filtragem no nome frente definido para um tipo de link. reversename: Uso filtragem no nome invertido definido para um tipo de link. Se não for especificado, então os nomes dianteiros e reversa são usados para filtrar o tipo de link. Observação 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.
ExternalLinkFilters		Elemento opcional de LinksControlOptions . Fornece um recipiente para um ou mais elementos de Filter que especificam os tipos de link que os usuários podem especificar para criar relacionamentos a objetos que não são itens de trabalho, como conjuntos de alterações, hiperlinks, e arquivos sob controle de versão.O tipo de elemento é complexa: ExternalLinkFiltersType.
	FilterType	Atributo opcional de ExternalLinkFilters . Define o método usado para filtrar a lista de tipos de link fornecidos no conjunto de elementos de Filter .O tipo de elemento é simples: LinksControlFilterKind. Você pode usar os seguintes valores: exclude: Uso não permitir links para ser criados estes tipos de link que aparecem nos elementos de Filter . excludeAll: Uso não permitir todos os tipos de link. include: Uso permitir somente os tipos de link listados nos elementos de Filter . includeAll: Uso permitir que os links são criados de todos os tipos de link. Se não for especificado, todos os links para itens de trabalho externos são excluídos.
Filter		Elemento necessário de ExternalLinkFilters quando FilterType for exclude ou include. Quando FilterType é excludeAll ou includeAll, nenhum elemento de Filter deve ser especificado. O tipo de elemento é complexa: ExternalLinkFilterElementType. Especifica o nome dos tipos de link que serão incluídos ou excluídos do conjunto de links que os usuários podem criar para o item de trabalho.
	LinkType	Atributo necessário de Filter . Especifica o nome da referência para um tipo de link para excluir ou incluir.O tipo do atributo é simples: ExternalLinkTypeName.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
WorkItemTypeFilters		Elemento opcional de LinksControlOptions . Fornece um recipiente para um ou mais elementos de Filter que especificam os critérios de filtragem para aplicar para trabalhar tipos de item. O tipo de elemento é complexa: LinksControlWorkItemTypeFiltersElementType.
	Scope	Atributo opcional de WorkItemTypeFilters . Define o escopo de filtro aplicado ao conjunto de tipos de item de trabalho fornecidos no conjunto de elementos de Filter .O tipo de elemento é tipo simples: LinksControlWorkItemTypeFilterScopeKind. Os valores válidos que você pode usar são: all: Uso permitir que os links são criados a todos os tipos de itens de trabalho especificados nas marcas de Filter . project: Uso permitir que os links são criados somente 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 item de trabalho fornecidos no conjunto de elementos de Filter .O tipo de elemento é simples: LinksControlWorkItemTypeFilterKind. Você pode usar os seguintes valores: exclude: Uso não permitir os tipos de itens de trabalho em elementos de Filter . excludeAll: Uso não permitir todos os tipos de itens de trabalho. include: Uso permitir os tipos de itens de trabalho em elementos de Filter . includeAll: Uso permitir a todos os tipos de itens de trabalho. Se você não especificar qualquer um dos valores, links para todos os tipos de itens de trabalho são permitidos.
Filter		Elemento opcional de WorkItemTypeFilters quando FilterType for exclude ou include. Quando FilterType é excludeAll ou includeAll, você não deve especificar quaisquer elementos de Filter . Especifica os tipos de itens de trabalho que devem ser incluídos ou excluída do conjunto de tipos de item de trabalho que pode ser associado.O tipo de elemento é tipo complexo: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Atributo necessário de Filter . Especifica o nome da referência de um tipo de item de trabalho a ser filtro.O tipo do atributo é: typelib:NonEmptyPlainConstant. Comprimento mínimo: 1; comprimento máximo: 255. Valor de padrão: ^ [\ de ^ \ *$] Exemplo do valor de padrão: Tarefa
LinkColumns		Elemento opcional de LinksControlOptions . Fornece um recipiente para um ou mais elementos de LinkColumn .O tipo de elemento é tipo complexo: LinkColumnsType.
LinkColumn		Elemento de LinkColumns necessário. Especifica os campos de item de trabalho e atributos de tipo de link exibidos para a lista de links definidos para um item de trabalho.O tipo de elemento é tipo complexo: LinkColumnType. Esta lista de colunas é a exibição padrão.O usuário pode adicionar e remover colunas de link listar. A ordem em que os elementos de LinkColumn são listados define a ordem em que os campos de coluna são exibidos no formulário de item de trabalho.
	RefName	Atributo opcional de LinkColumn .Especificar RefName ou LinkAttribute, mas não ambos. Especifica o nome da referência que corresponde a um campo válido de item de trabalho para a coleção de projeto de equipe.O tipo do atributo é typelib:ReferenceFieldName.
	LinkAttribute	Atributo opcional de LinkColumn .Especificar RefName ou LinkAttribute, mas não ambos. Especifica o nome da referência que corresponde a qualquer atributo para um tipo de link válido para a coleção de projeto de equipe.O tipo do atributo é typelib:ReferenceFieldName.

Elementos pai

Elemento	Descrição
Controle	Obrigatório.Define um campo, texto, o hiperlink, ou outro elemento de controle seja exibido no formulário de item de trabalho.

Comentários

LinksControlOptions é um elemento filho opcional de elemento de Control onde ControlType="LinksControl".Você pode usar o elemento de LinksControlOptions para oferecer suporte às seguintes ações:

Especificar restrições que regem a criação de relacionamentos em outros itens de trabalho baseados no tipo de link e, opcionalmente, os nomes dianteiros e reversa de tipos de link.
Especificar restrições que regem a criação de relações a objetos diferentes de itens de trabalho, como o conjunto de alterações, hiperlink, e assim por diante, com base em tipos de link externo.
Especificar restrições que regem a criação de relacionamentos em outros itens de trabalho baseados no tipo de item de trabalho e, opcionalmente, projeto de equipe onde os itens de trabalho são definidos.
Especificar os campos padrão da coluna que você deseja exibir informações para a lista de link.

Exemplo

O exemplo a seguir especifica como habilitar a criação de links cujo tipo é Microsoft.VSTS.Common.TestedBy e mostrar Forward Name para este tipo de link.As opções de filtro recusam a criação de links para todos os tipos de link externo.Além disso, os campos exibidos padrão de coluna para links listados correspondem aos seguintes nomes amigáveis: Identificação, tipo de item de trabalho, título, atribuído a, estado, e o campo de comentário definido para o link.Para obter mais exemplos, consulte Definir controles de link para restringir as relações de link.

<Control Type="LinksControl" Name="TestedBy" Label="&amp;Work items testing this bug:" LabelPosition="Top">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="Microsoft.VSTS.Common.TestedBy" FilterOn="forwardname" />
      </WorkItemLinkFilters>
      <WorkItemTypeFilters FilterType="include">
          <Filter WorkItemType="Test Case" />
      </WorkItemTypeFilters>
          <ExternalLinkFilters FilterType="excludeAll"/>
      <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>

Botões da barra de ferramentas de LinksControl

Cada elemento de Control de Type=”LinksControl” fornece uma barra de ferramentas, que contém botões mostrados na ilustração seguinte:

Controles de barra de ferramentas do formulário link do item de trabalho

Esses botões ficam disponíveis somente após você executa uma ação específica:

O botão para criar um item de trabalho que é vinculado ao item de trabalho aberto () se torna disponível somente após você salvar o item de trabalho aberto.
Os botões para abrir a lista de itens de trabalho em uma consulta () e um cliente do Microsoft Office () se tornam disponíveis somente quando pelo menos um item de trabalho é listado na guia de controle de links.
Os botões para abrir um item de trabalho (,) para editar um link (), e para excluir um link () se tornam disponíveis somente após você clicar em um ou mais itens de trabalho listados na guia de controle de links.

O controle de links que é exibido é o mesmo para ambos Team Web Access e Team Explorer, exceto quando é configurado para processar somente links de Storyboard .Nesse caso, a barra de ferramentas contém somente os controles para adicionar um novo link, abra o item vinculado, e para excluir o link.Além disso, a versão de Team Web Access exibe o link de Inicie o uso de storyboars no menu de controle.

Controle do storyboard links no Team Web Access

Definições de esquema

LinksControlOptionsType
WorkItemLinkFiltersType
WorkItemLinkFilterElementType
ExternalLinkFiltersType
ExternalLinkFilterElementType
LinksControlFilterKind
LinksControlFilterOnKind
ExternalLinkTypeName
LinksControlWorkItemTypeFiltersElementType
LinksControlWorkItemTypeFilterElementType
LinksControlWorkItemTypeFilterScopeKind
LinksControlWorkItemTypeFilterKind
LinkColumnsType
LinkColumnType

LinksControlOptionsType

<xs:complexType name="LinksControlOptionsType">
   <xs:all>
      <xs:element name="LinkColumns" type="LinkColumnsType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemLinkFilters" type="WorkItemLinkFiltersType" minOccurs="0" maxOccurs="1"/>
      <xs:element name="ExternalLinkFilters" type="ExternalLinkFiltersType" minOccurs="0" maxOccurs="1" />
      <xs:element name="WorkItemTypeFilters" type="LinksControlWorkItemTypeFiltersElementType" minOccurs="0" maxOccurs="1" />
   </xs:all>
</xs:complexType>

WorkItemLinkFiltersType

<xs:complexType name="WorkItemLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="WorkItemLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

WorkItemLinkFilterElementType

<xs:complexType name="WorkItemLinkFilterElementType" >
   <xs:attribute name="LinkType" type="typelib:ReferenceFieldName" use="required" />
   <xs:attribute name="FilterOn" type="LinksControlFilterOnKind" use="optional" />
</xs:complexType>

ExternalLinkFiltersType

<xs:complexType name="ExternalLinkFiltersType" >
   <xs:sequence>
      <xs:element name="Filter" type="ExternalLinkFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="FilterType" type="LinksControlFilterKind" use="required" />
</xs:complexType>

ExternalLinkFilterElementType

<xs:complexType name="ExternalLinkFilterElementType" >
   <xs:attribute name="LinkType" type="ExternalLinkTypeName" use="required" />
</xs:complexType>

LinksControlFilterKind

<xs:simpleType name="LinksControlFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
      <xs:enumeration value="excludeAll" />
   </xs:restriction>
</xs:simpleType>

LinksControlFilterOnKind

<xs:simpleType name="LinksControlFilterOnKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="forwardname" />
      <xs:enumeration value="reversename" />
   </xs:restriction>
</xs:simpleType>

ExternalLinkTypeName

<xs:simpleType name="ExternalLinkTypeName">
   <xs:restriction base="xs:string">
      <xs:minLength value="1"/>
      <xs:maxLength value="128"/>
   </xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFiltersElementType

<xs:complexType name="LinksControlWorkItemTypeFiltersElementType" >
   <xs:sequence>
      <xs:element name="Filter" type="LinksControlWorkItemTypeFilterElementType" minOccurs="0" maxOccurs="unbounded"/>
   </xs:sequence>
      <xs:attribute name="Scope" type="LinksControlWorkItemTypeFilterScopeKind" use="optional" />
      <xs:attribute name="FilterType" type="LinksControlWorkItemTypeFilterKind" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterElementType

<xs:complexType name="LinksControlWorkItemTypeFilterElementType" >
   <xs:attribute name="WorkItemType" type="typelib:NonEmptyPlainConstant" use="required" />
</xs:complexType>

LinksControlWorkItemTypeFilterScopeKind

<xs:simpleType name="LinksControlWorkItemTypeFilterScopeKind">
   <xs:restriction base="xs:string">
   <xs:enumeration value="project" />
   <xs:enumeration value="all" />
</xs:restriction>
</xs:simpleType>

LinksControlWorkItemTypeFilterKind

<xs:simpleType name="LinksControlWorkItemTypeFilterKind">
   <xs:restriction base="xs:string">
      <xs:enumeration value="include" />
      <xs:enumeration value="exclude" />
      <xs:enumeration value="includeAll" />
   </xs:restriction>
</xs:simpleType>

LinkColumnsType

<xs:complexType name="LinkColumnsType" >
   <xs:sequence>
      <xs:element name="LinkColumn" type="LinkColumnType" minOccurs="1" maxOccurs="unbounded"/>
   </xs:sequence>
</xs:complexType>

LinkColumnType

<xs:complexType name="LinkColumnType" >
   <!-- Must be one or the other, but not both -->
      <xs:attribute name="LinkAttribute" type="typelib:ReferenceFieldName" use="optional" />
      <xs:attribute name="RefName" type="typelib:ReferenceFieldName" use="optional" />
</xs:complexType>

Informações de elemento

Namespace	https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef
Nome de esquema	Definição de tipo de item de trabalho
Validação Arquivo	WorkItemTypeDefinition.xsd
Tipo de elemento	LinksControlOptionsType
Pode ser deixado	Não aplicável.

Consulte também

Conceitos

Referência de elementos de tipo de link

Especificar controles de formulário de item de trabalho

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

Outros recursos

Definir um tipo de link personalizado

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.

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.

Partilhar via