Elementos de LinksControlOptions

Artigo
08/01/2011

Você pode usar o LinksControlOptions elemento para definir as opções para controlar quais links pode ser adicionado a um item de trabalho e as colunas padrão que você deseja que apareça para a lista de links em um item de trabalho. Quando você adiciona um controle de links para um formulário de item de trabalho, você pode especificar filtros restringem os tipos de links que os usuários podem ser o modo de exibição e criar e os tipos de itens de trabalho à qual os usuários podem criar vínculos. Especificamente, use os seguintes elementos conforme indicado:

WorkItemLinkFilters: Use para restringir os tipos de vínculos entre itens de trabalho no projeto de equipe atual.
ExternalLinkFilters: Use para restringir os tipos de links que podem ser criadas entre os itens de trabalho e outros objetos, como, por exemplo, conjuntos de alterações, hiperlinks ou arquivos de versão controlada.
WorkItemTypeFilters: Use para 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 Filter elementos para especificar os tipos de link ou trabalhar de tipos de item que você deseja incluir ou excluir. Para obter mais informações sobre como usar esses elementos, consulte Definir controles de Link para restringir os relacionamentos 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 atributos, elementos filho, e elementos pai.

Atributos e elementos filho

Elemento	Atributo	Descrição
LinksControlOptions		Opcional Control elemento ao type="LinksControl". Fornece um contêiner para elementos que definem quais links pode ser adicionado a um item de trabalho e as colunas padrão apareça para a lista de relacionamentos de link em um item de trabalho. O tipo de elemento é um tipo complexo: LinksControlOptionsType.
WorkItemLinkFilters		Opcional LinksControlOptions elemento. Fornece um contêiner para um ou mais Filter elementos que especificam o link filtragem os critérios usados para tipos de link que são definidos para a coleção de projeto de equipe e que a criação de relações entre itens de trabalho. O tipo de elemento é um tipo complexo: WorkItemLinkFiltersType.
	FilterType	Obrigatório WorkItemLinkFilters atributo. Define o método usado para filtrar o conjunto de tipos de link fornecido no conjunto de Filter elementos. O tipo de elemento é simples: LinksControlFilterKind. Valores válidos, você pode usar são: exclude: Use para impedir os links a ser criado a partir desses tipos de link listados na Filter elementos. excludeAll: Use para impedir todos os tipos de link. include: Use para permitir que somente esses tipos de link listados no Filter elementos. includeAll: Use esta opção para permitir que os links a ser criado a partir de todos os tipos de link.
Filter		Obrigatório WorkItemLinkFilters elemento quando o FilterType é exclude ou include. Quando o FilterType é excludeAll ou includeAll, não Filter elementos devem ser especificados. Especifica os tipos de links que devem ser incluídos ou excluídos do conjunto de links que podem ser criados para o item de trabalho. O tipo de elemento é simples: WorkItemLinkFilterElementType.
	LinkType	Obrigatório Filter atributo. Especifica o nome de referência para um tipo de link. O tipo de atributo é typelib:ReferenceFieldName. 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. O tipo de elemento é simples: LinksControlFilterOnKind. Os valores válidos são: forwardName: Use esta opção para filtrar o nome de encaminhamento definido para um tipo de link. revserseName: 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. Observação 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.
ExternalLinkFilters		Opcional LinksControlOptions elemento. Fornece um contêiner para um ou mais Filter elementos que especificam os tipos de link que os usuários podem especificar para criar relações de objetos que são não itens de trabalho, como conjuntos de alterações, hiperlinks e arquivos sob controle de versão. O tipo de elemento é complexo: ExternalLinkFiltersType.
	FilterType	Opcional ExternalLinkFilters atributo. Define o método que é usado para filtrar a lista de tipos de link fornecido no conjunto de Filter elementos. O tipo de elemento é simple: LinksControlFilterKind. Você pode usar os seguintes valores: exclude: Use para impedir os links a ser criado a partir desses tipos de link que aparecem na Filter elementos. excludeAll: Use para impedir todos os tipos de link. include: Use para permitir que somente esses tipos de link listados no Filter elementos. includeAll: Use esta opção para permitir que os links a ser criado a partir de todos os tipos de link. Se não for especificado, todos os links para os itens de trabalho externo são excluídos.
Filter		Obrigatório ExternalLinkFilters elemento quando o FilterType é exclude ou include. Quando o FilterType é excludeAll ou includeAll, não Filter elementos devem ser especificados. O tipo de elemento é complexo: 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	Obrigatório Filter atributo. Especifica o nome de referência para um tipo de link para excluir ou incluir. O tipo de atributo é simple: ExternalLinkTypeName. 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
WorkItemTypeFilters		Opcional LinksControlOptions elemento. Fornece um contêiner para um ou mais Filter elementos que especificam os critérios de filtro para aplicar a funcionar em tipos de item. O tipo de elemento é complexo: LinksControlWorkItemTypeFiltersElementType.
	Scope	Opcional WorkItemTypeFilters atributo. Define o escopo do filtro aplicado ao conjunto de tipos de item de trabalho fornecidos no conjunto de Filter elementos. O tipo de elemento é simples: LinksControlWorkItemTypeFilterScopeKind. Valores válidos, você pode usar são: all: Use para permitir que os links a serem criados para todos os tipos de item de trabalho especificados no Filter marcas. project: Use esta opção para permitir que os links a ser criado apenas 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 itens de trabalho são permitidas.
	FilterType	Obrigatório WorkItemTypeFilters atributo. Define o método que é usado para filtrar o conjunto de tipos de item de trabalho fornecidos no conjunto de Filter elementos. O tipo de elemento é simple: LinksControlWorkItemTypeFilterKind. Você pode usar os seguintes valores: exclude: Use para impedir os tipos de item de trabalho no Filter elementos. excludeAll: Use para impedir todos os tipos de item de trabalho. include: Use para permitir que os tipos de item de trabalho no Filter elementos. includeAll: Use esta opção para permitir que todos os tipos de item de trabalho. Se você não especificar qualquer um desses valores, links para todos os tipos de item de trabalho são permitidas.
Filter		Opcional WorkItemTypeFilters elemento quando o FilterType é exclude ou include. Quando o FilterType é excludeAll ou includeAll, você não deve especificar qualquer Filter elementos. Especifica os tipos de itens de trabalho a serem incluídos ou excluídos do conjunto de tipos de item de trabalho que pode ser vinculado a. O tipo de elemento é um tipo complexo: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Obrigatório Filter atributo. Especifica o nome de referência de um tipo de item de trabalho a serem filtrados. O tipo de atributo é: typelib:NonEmptyPlainConstant. Comprimento mínimo: 1; comprimento máximo: 255. Valor padrão: ^[^\\]*$ Exemplo de valor padrão: Tarefa
LinkColumns		Opcional LinksControlOptions elemento. Fornece um contêiner para um ou mais LinkColumn elementos. O tipo de elemento é um tipo complexo: LinkColumnsType.
LinkColumn		Obrigatório LinkColumns elemento. Especifica os campos de item de trabalho e os atributos de tipo de link exibidos para a lista de links definidos para um item de trabalho. O tipo de elemento é um tipo complexo: LinkColumnType. Esta lista de coluna é a exibição padrão. O usuário pode adicionar e remover colunas da lista de link. A ordem na qual o LinkColumn elementos são listados define a ordem na qual os campos de coluna são exibidos no formulário de item de trabalho.
	RefName	Opcional LinkColumn atributo. Especificar RefName ou LinkAttribute, mas não ambos. Especifica o nome de referência correspondente a um campo de item de trabalho válida para a coleção de projeto de equipe. O tipo de atributo é typelib:ReferenceFieldName.
	LinkAttribute	Opcional LinkColumn atributo. Especificar RefName ou LinkAttribute, mas não ambos. Especifica o nome de referência correspondente a qualquer atributo para um tipo de vínculo válido para a coleção de projeto de equipe. O tipo de atributo é typelib:ReferenceFieldName.

Elementos pai

Elemento	Descrição
CONTROLE	Obrigatório. Define um campo, o 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 CONTROL elemento onde ControlType="LinksControl". Você pode usar o LinksControlOptions elemento para suportar as seguintes ações:

Especifica as restrições que governam a criação de relações com outros itens de trabalho com base no tipo de link e, opcionalmente, os nomes dos tipos de link de direta e inversas.
Especifica as restrições que governam a criação de relações de objetos, além de trabalhar itens, como, por exemplo, o conjunto de alterações, hiperlink e assim por diante, com base nos tipos de link externo.
Especificar as restrições que governam a creationg de relações com outros itens de trabalho com base no tipo de item de trabalho e, opcionalmente, o projeto de equipe, onde os itens de trabalho são definidos.
Especifique os campos de coluna padrão que você deseja exibir informações para a lista de links.

Exemplo

O exemplo a seguir especifica como habilitar a criação de links cujo tipo é Microsoft.VSTS.Common.TestedBy e mostrar o Forward Name para este tipo de link. As opções de filtro não permitem a criação de links para todos os tipos de link externo. Além disso, o campos de coluna padrão exibida para os links listados correspondem aos seguintes nomes amigáveis: ID, 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 os relacionamentos 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>

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

Namespace	https://schemas.microsoft.com/VisualStudio/2008/WorkItemTracking/TypeDef
Nome de esquema	Definição de tipo de Item de trabalho
Arquivo de validação	WorkItemTypeDefinition.xsd
Tipo de elemento	LinksControlOptionsType
Pode ficar vazio	Não aplicável.

Consulte também

Conceitos

Trabalhando com tipos de Link

Especificando os controles de formulário de Item de trabalho

Outros recursos

Personalizando itens de trabalho como estão relacionados por meio de tipos de Link

Definir controles de Link para restringir os relacionamentos de Link

Histórico de alterações

Date	History	Motivo
Janeiro de 2011	Substituídos os links para tópicos que foram removidos.	Aprimoramento de informações.
Julho de 2010	Adicionado a uma lista completa de nomes de referência que você pode usar com o ExternalLinkFilters elemento.	Correção de bug de conteúdo.
Junho de 2010	Revisado as descrições para o ExternalLinkFilters e WorkItemTypeFilters elementos.	Correção de bug de conteúdo.

Janeiro de 2011

Substituídos os links para tópicos que foram removidos.

Aprimoramento de informações.

Julho de 2010

Adicionado a uma lista completa de nomes de referência que você pode usar com o ExternalLinkFilters elemento.

Correção de bug de conteúdo.

Junho de 2010

Revisado as descrições para o ExternalLinkFilters e WorkItemTypeFilters elementos.