Elementos LinksControlOptions

Artigo
11/18/2015

Você usa 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 exibir a lista de links em um item de trabalho. Quando você adiciona um controle de vínculos a um formulário de item de trabalho, você pode especificar filtros que restringem os tipos de links que os usuários podem exibir 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 itens de trabalho e outros objetos, como conjuntos de alterações, hiperlinks ou arquivos de controle de versão.
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 que você deseja incluir ou excluir tipos de item de elementos para especificar os tipos de link ou trabalhar. Para obter mais informações sobre como usar esses elementos, consulte Definir controles de link para restringir as relações de link.

O LinksControlOptions é um elemento filho do CONTROL elemento.

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 quando 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 seja exibido para a lista de relações de link em um item de trabalho. O tipo de elemento é o tipo complexo: LinksControlOptionsType.
WorkItemLinkFilters		Opcional LinksControlOptions elemento. Fornece um contêiner para uma ou mais Filter elementos que especificam o link filtragem critérios a serem usados para tipos de link que são definidos para a coleção de projetos de equipe e que criar relações entre itens de trabalho. O tipo de elemento é o tipo complexo: WorkItemLinkFiltersType.
	FilterType	Atributo WorkItemLinkFilters obrigatório. 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. Os valores válidos que você pode usar são: exclude: Use para não permitir 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 para permitir que os links a ser criado a partir de todos os tipos de link.
Filter		Necessá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 a serem incluídos ou excluídos do conjunto de links que podem ser criadas para o item de trabalho. O tipo de elemento é simples: WorkItemLinkFilterElementType.
	LinkType	Atributo Filter obrigatório. Especifica o nome de referência para um tipo de link. Os tipos válidos incluem os seguintes tipos de link definidos pelo sistema: Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related Além disso, você pode especificar o nome de referência para os tipos de link personalizado definido para a coleção de projetos de equipe. 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 vínculo. O tipo de elemento é simples: LinksControlFilterOnKind. Os valores válidos são: forwardname: Use para filtrar o nome de encaminhamento definido para um tipo de link. reversename: Use para filtrar no nome inverso definido para um tipo de link. Se não for especificado, os nomes e inverso são usados para filtrar o tipo de link. Dica Se a topologia de tipo de link rede, os nomes e inverso são os mesmos.Para obter mais informações, consulte Referência de elementos de tipo de link.
ExternalLinkFilters		Opcional LinksControlOptions elemento. Fornece um contêiner para uma ou mais Filter elementos que especificam os tipos de link que os usuários podem especificar para criar relações de objeto que 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	Atributo ExternalLinkFilters opcional. Define o método 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 não permitir links a ser criado a partir desses tipos de link que aparecem no 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 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 itens de trabalho externo são excluídos.
Filter		Necessá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 item de trabalho.
	LinkType	Atributo Filter obrigatório. 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 de item de trabalho
WorkItemTypeFilters		Opcional LinksControlOptions elemento. Fornece um contêiner para uma ou mais Filter elementos que especificam os critérios de filtro a ser aplicado a tipos de item de trabalho. O tipo de elemento é complexo: LinksControlWorkItemTypeFiltersElementType.
	Scope	Atributo WorkItemTypeFilters opcional. Define o escopo do filtro aplicado ao conjunto de tipos de itens de trabalho fornecidos no conjunto de Filter elementos. O tipo de elemento é simples: LinksControlWorkItemTypeFilterScopeKind. Os valores válidos que você pode usar são: all: Use para permitir que os links que será criada para todos os tipos de item de trabalho especificados na Filter marcas. project: Use para permitir links deve ser criada 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	Atributo WorkItemTypeFilters obrigatório. Define o método usado para filtrar o conjunto de tipos de itens de trabalho fornecidos no conjunto de Filter elementos. O tipo de elemento é simple: LinksControlWorkItemTypeFilterKind. Você pode usar os seguintes valores: exclude: Use para impedir que os tipos de itens de trabalho no Filter elementos. excludeAll: Use para impedir todos os tipos de item de trabalho. include: Use para permitir que os tipos de itens de trabalho no Filter elementos. includeAll: Use para permitir que todos os tipos de item de trabalho. Se você não especificar nenhum 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. O tipo de elemento é o tipo complexo: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	Atributo Filter obrigatório. Especifica o nome de referência de um tipo de item de trabalho a ser filtrada. O tipo de atributo é: typelib:NonEmptyPlainConstant. Comprimento mínimo: 1; comprimento máximo: 255. Valor do padrão: ^ [^ \ \] * $ Exemplo de valor padrão: tarefa
LinkColumns		Opcional LinksControlOptions elemento. Fornece um contêiner para uma ou mais LinkColumn elementos. O tipo de elemento é o tipo complexo: LinkColumnsType.
LinkColumn		Necessário LinkColumns elemento. Especifica os campos do 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 é o tipo complexo: LinkColumnType. Esta 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 listados define a ordem na qual os campos de coluna são exibidos no formulário de item de trabalho.
	RefName	Atributo LinkColumn opcional. Especifique RefName ou LinkAttribute, mas não ambos. Especifica o nome de referência que corresponde a um campo de item de trabalho válido para a coleção de projetos de equipe. O tipo de atributo é typelib:ReferenceFieldName.
	LinkAttribute	Atributo LinkColumn opcional. Especifique RefName ou LinkAttribute, mas não ambos. Especifica o nome de referência que corresponde a qualquer atributo para um tipo de link válido para a coleção de projetos de equipe. O tipo de atributo é typelib:ReferenceFieldName.

Elementos pai

Elemento	Descrição
Controle	Obrigatório. Define um campo, texto, hiperlinks ou outro elemento de controle apareça 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 e inverso dos tipos de link.
Especifica as restrições que governam a criação de relações de objetos a trabalhar itens, como o conjunto de alterações, hyperlink e assim por diante, com base nos tipos de link externo.
Especificar as restrições que governam a criação de relações com outros itens de trabalho com base no tipo de item de trabalho e, opcionalmente, o projeto de equipe em que os itens de trabalho são definidos.
Especifique os campos de coluna padrão que você deseja exibir as informações para a lista de links.

Exemplo

O exemplo a seguir especifica como habilitar a criação de vínculos cujo tipo é Microsoft.VSTS.Common.TestedBy e mostrar o Forward Name para esse 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, exibidos campos de coluna padrão para os links listados correspondem aos nomes amigáveis de seguir: ID, Work Item Type, título, atribuído a, estado e o campo de comentário definidos para a conexão. 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 Control elemento Type=”LinksControl” fornece uma barra de ferramentas, que contém os botões mostrados na ilustração a seguir:

Work item form link toolbar controls

Esses botões só ficam disponíveis após a execução de ações específicas:

O botão para criar um item de trabalho vinculado ao item de trabalho aberto () fica disponível somente depois que você salvar o item de trabalho aberto.
Os botões para abrir a lista de itens de trabalho em uma consulta () e em um cliente do Microsoft Office () ficam disponíveis somente quando pelo menos um item de trabalho é listado na guia controle de vínculos.
Os botões para abrir um item de trabalho (), edite um link () e excluir um vínculo () ficam disponíveis somente depois que você clicar em um ou mais itens de trabalho listados na guia controle de vínculos.

O controle de links exibido é o mesmo para ambos Acesso Web da Equipe e Team Explorer, exceto quando ele está configurado apenas renderizar Storyboard links. Nesse caso, a barra de ferramentas contém apenas os controles para adicionar um novo link, abra o item vinculado e exclua o link. Além disso, o Acesso Web da Equipe versão exibe o Iniciar storyboard link dentro do menu de controle.

Storyboard links 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 do esquema	Definição de tipo de Item de trabalho
Arquivo de validação	WorkItemTypeDefinition.xsd
Tipo de Elemento	LinksControlOptionsType
Pode estar vazio	Não aplicável

Consulte também

Conceitos

Referência de elementos de tipo de link

Especificar controles de formulários de itens de trabalho

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

Outros recursos

Definir um tipo de link personalizado

Compartilhar via