LinksControlOptions (Elementos)

  • Artículo

El elemento LinksControlOptions se usa para definir las opciones que controlan los vínculos que se pueden agregar a un elemento de trabajo y las columnas predeterminadas que desea que aparezcan para la lista de vínculos en un elemento de trabajo. Al agregar un control de vínculos a un formulario de elemento de trabajo, puede especificar filtros que restringen los tipos de vínculos que los usuarios pueden ver y crear y los tipos de elementos de trabajo en los que los usuarios pueden crear vínculos. Específicamente, se utilizan los elementos siguientes como se indica:

  • WorkItemLinkFilters: utilícelo para restringir los tipos de vínculos entre los elementos de trabajo en el proyecto de equipo actual.

  • ExternalLinkFilters: utilícelo para restringir los tipos de vínculos que se pueden crear entre los elementos de trabajo y otros objetos, como conjuntos de cambios, hipervínculos o archivos de control de versiones.

  • WorkItemTypeFilters: utilícelo para restringir las relaciones de vínculos que los usuarios pueden crear según el tipo de elemento de trabajo y si el elemento de trabajo se define en el proyecto de equipo actual.

En cada uno de estos elementos, puede especificar los elementos Filter para especificar los tipos de vínculo o los tipos de elemento de trabajo que desea incluir o excluir. Para obtener más información sobre el uso de estos elementos, vea Definir controles de vínculos para restringir las relaciones de los vínculos.

El elemento LinksControlOptions es un elemento secundario del elemento CONTROL.

Jerarquía del esquema

WITD

   WORKITEMTYPE

       FORM

           Diseño

               Grupo

               Columna

               Tab

                     Control

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

En las secciones siguientes se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos y elementos secundarios

Elemento

Atributo

Descripción

LinksControlOptions

 

Elemento Control opcional cuando type="LinksControl".

Proporciona un contenedor para los elementos que definen qué vínculos se pueden agregar a un elemento de trabajo y las columnas predeterminadas que aparecen para la lista de relaciones de vínculos de un elemento de trabajo.

El tipo de elemento es el tipo complejo: LinksControlOptionsType.

WorkItemLinkFilters

 

Elemento LinksControlOptions opcional.

Proporciona un contenedor para uno o más elementos Filter que especifican los criterios de filtro del vínculo que se van a usar para los tipos de vínculo definidos para la colección de proyectos de equipo y que crean relaciones entre los elementos de trabajo.

El tipo de elemento es el tipo complejo: WorkItemLinkFiltersType.

 

FilterType

El atributo WorkItemLinkFilters es obligatorio.

Define el método utilizado para filtrar el conjunto de tipos de vínculo proporcionado en el conjunto de elementos Filter. El tipo de elemento es el tipo simple: LinksControlFilterKind.

Los valores válidos que puede utilizar son:

  • exclude: utilícelo para impedir la creación de vínculos a partir de esos tipos de vínculo enumerados en los elementos Filter.

  • excludeAll: utilícelo para impedir todos los tipos de vínculo.

  • include: utilícelo para permitir solo esos tipos de vínculo enumerados en los elementos Filter.

  • includeAll: utilícelo para permitir la creación de vínculos a partir de todos los tipos de vínculo.

Filter

 

Elemento WorkItemLinkFilters obligatorio cuando FilterType es exclude o include.

Cuando FilterType es excludeAll o includeAll, no se debería especificar ningún elemento Filter.

Especifica los tipos de vínculos que se deben a incluir o excluir del conjunto de vínculos que se pueden crear para el elemento de trabajo. El tipo de elemento es el tipo simple: WorkItemLinkFilterElementType.

 

LinkType

El atributo Filter es obligatorio.

Especifica el nombre de referencia de un tipo de vínculo. El tipo de atributo es typelib:ReferenceFieldName. Para obtener más información, vea Trabajar con tipos de vínculos.

 

FilterOn

Atributo Filter opcional.

Especifica el tipo de filtro que se va a aplicar al tipo de vínculo. El tipo de elemento es el tipo simple: LinksControlFilterOnKind.

Los valores válidos son:

  • forwardName: utilícelo para filtrar en el nombre de vínculo hacia delante definido para un tipo de vínculo.

  • revserseName: utilícelo para filtrar en el nombre de vínculo inverso definido para un tipo de vínculo.

Si no se especifica, los nombres hacia delante e inversos se utilizan para filtrar el tipo de vínculo.

NotaNota
Si la topología del tipo de vínculo es Red, los nombres de vínculos hacia delante e inversos son los mismos.Para obtener más información, vea Trabajar con tipos de vínculos.

ExternalLinkFilters

 

Elemento LinksControlOptions opcional.

Proporciona un contenedor para uno o más elementos Filter que especifican los tipos de vínculo que los usuarios pueden especificar para crear relaciones con los objetos que no son elementos de trabajo, como conjuntos de cambios, hipervínculos y archivos bajo el control de versiones. El tipo de elemento es complejo: ExternalLinkFiltersType.

 

FilterType

Atributo ExternalLinkFilters opcional.

Define el método utilizado para filtrar la lista de tipos de vínculo proporcionada en el conjunto de elementos Filter. El tipo de elemento es simple: LinksControlFilterKind.

Puede utilizar los siguientes valores:

  • exclude: utilícelo para impedir la creación de vínculos a partir de esos tipos de vínculo que aparecen en los elementos Filter.

  • excludeAll: utilícelo para impedir todos los tipos de vínculo.

  • include: utilícelo para permitir solo esos tipos de vínculo enumerados en los elementos Filter.

  • includeAll: utilícelo para permitir la creación de vínculos a partir de todos los tipos de vínculo.

Si no se especifica, se excluyen todos los vínculos a los elementos de trabajo externos.

Filter

 

Elemento ExternalLinkFilters obligatorio cuando FilterType es exclude o include.

Cuando FilterType es excludeAll o includeAll, no se debería especificar ningún elemento Filter.

El tipo de elemento es complejo: ExternalLinkFilterElementType.

Especifica el nombre de los tipos de vínculo que se incluirán o excluirán del conjunto de vínculos que los usuarios pueden crear para el elemento de trabajo.

 

LinkType

El atributo Filter es obligatorio.

Especifica el nombre de referencia de un tipo de vínculo que se va a excluir o incluir. El tipo de atributo es simple: ExternalLinkTypeName. Puede especificar los siguientes tipos de vínculo:

  • Corregido en el conjunto de cambios

  • Datos adjuntos de resultados

  • Archivo de código fuente

  • Resultado de pruebas

  • Hipervínculo del elemento de trabajo

WorkItemTypeFilters

 

Elemento LinksControlOptions opcional.

Proporciona un contenedor para uno o más elementos Filter que especifican los criterios de filtro que se van a aplicar a los tipos de elemento de trabajo.

El tipo de elemento es complejo: LinksControlWorkItemTypeFiltersElementType.

 

Scope

Atributo WorkItemTypeFilters opcional.

Define el ámbito del filtro aplicado al conjunto de tipos de elemento de trabajo proporcionado en el conjunto de elementos Filter. El tipo de elemento es el tipo simple: LinksControlWorkItemTypeFilterScopeKind.

Los valores válidos que puede utilizar son:

  • all: utilícelo para permitir crear vínculos a todos los tipos de elemento de trabajo especificados en las etiquetas Filter.

  • project: utilícelo para permitir crear vínculos solo a los tipos de elemento de trabajo que se definieron para el proyecto actual.

Si no se especifica, se permiten vínculos a todos los tipos de elemento de trabajo.

 

FilterType

El atributo WorkItemTypeFilters es obligatorio.

Define el método utilizado para filtrar el conjunto de tipos de elemento de trabajo proporcionado en el conjunto de elementos Filter. El tipo de elemento es simple: LinksControlWorkItemTypeFilterKind.

Puede utilizar los siguientes valores:

  • exclude: utilícelo para no permitir los tipos de elemento de trabajo en los elementos Filter.

  • excludeAll: utilícelo para no permitir todos los tipos de elemento de trabajo.

  • include: utilícelo para permitir los tipos de elemento de trabajo en los elementos Filter.

  • includeAll: utilícelo para permitir todos los tipos de elemento de trabajo.

Si no especifica ninguno de estos valores, se permiten vínculos a todos los tipos de elemento de trabajo.

Filter

 

Elemento WorkItemTypeFilters opcional cuando el atributo FilterType es exclude o include.

Cuando FilterType es excludeAll o includeAll, no debería especificar ningún elemento Filter.

Especifica los tipos de elementos de trabajo que se incluirán o excluirán en el conjunto de tipos de elemento de trabajo al que se pueden vincular. El tipo de elemento es el tipo complejo: LinksControlWorkItemTypeFilterElementType.

 

WorkItemType

El atributo Filter es obligatorio.

Especifica el nombre de referencia de un tipo de elemento de trabajo que se desea filtrar. El tipo de atributo es: typelib:NonEmptyPlainConstant.

Longitud mínima: 1; longitud máxima: 255.

Valor de modelo: ^[^\\]*$

Ejemplo de un valor de modelo: Tarea

LinkColumns

 

Elemento LinksControlOptions opcional.

Proporciona un contenedor para uno o más elementos LinkColumn. El tipo de elemento es el tipo complejo: LinkColumnsType.

LinkColumn

 

Elemento LinkColumns obligatorio.

Especifica los campos de elemento de trabajo y atributos de tipo de vínculo mostrados para la lista de vínculos definida para un elemento de trabajo. El tipo de elemento es el tipo complejo: LinkColumnType.

Esta lista de columnas es la presentación predeterminada. El usuario puede agregar y quitar columnas en la lista de vínculos.

El orden en el que se enumeran los elementos LinkColumn define el orden en el que se muestran los campos de columna en el formulario de elemento de trabajo.

 

RefName

Atributo LinkColumn opcional. Especifique RefName o LinkAttribute, pero no ambos.

Especifica el nombre de referencia que corresponde a un campo de elemento de trabajo válido de la colección de proyectos de equipo. El tipo de atributo es typelib:ReferenceFieldName.

 

LinkAttribute

Atributo LinkColumn opcional. Especifique RefName o LinkAttribute, pero no ambos.

Especifica el nombre de referencia que corresponde a cualquier atributo de un tipo de vínculo válido de la colección de proyectos de equipo. El tipo de atributo es typelib:ReferenceFieldName.

Elementos primarios

Elemento

Descripción

Control

Obligatorio. Define un campo, texto, hipervínculo u otro elemento de control que aparecerá en el formulario de elemento de trabajo.

Comentarios

LinksControlOptions es un elemento secundario opcional del elemento Control donde ControlType="LinksControl". Puede utilizar el elemento LinksControlOptions para admitir las acciones siguientes:

  • Especifique las restricciones que rigen la creación de relaciones con otros elementos de trabajo basadas en el tipo de vínculo y, opcionalmente, los nombres hacia delante e inversos de los tipos de vínculo.

  • Especifique las restricciones que rigen la creación de relaciones con objetos que no son elementos de trabajo, como un conjunto de cambios, hipervínculo, etc., basadas en los tipos de vínculo externos.

  • Especifique las restricciones que rigen la creación de relaciones con otros elementos de trabajo basadas en el tipo de elemento de trabajo y, opcionalmente, el proyecto de equipo donde se definen esos elementos de trabajo.

  • Especifique los campos de columna predeterminados en los que desea mostrar información de la lista de vínculos.

Ejemplo

En el ejemplo siguiente se especifica cómo habilitar la creación de vínculos cuyo tipo es Microsoft.VSTS.Common.TestedBy y muestra Forward Name para este tipo de vínculo. Las opciones de filtro no permiten la creación de vínculos a todos los tipos de vínculo externos. Además, los campos de columna predeterminados mostrados para los vínculos enumerados corresponden a los siguientes nombres descriptivos: Identificador, Tipo de elemento de trabajo, Título, Asignado a, Estado y el campo Comentario definidos para el vínculo. Para obtener más ejemplos, vea Definir controles de vínculos para restringir las relaciones de los vínculos.

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

Definiciones de esquema

  • LinksControlOptionsType

  • WorkItemLinkFiltersType

  • WorkItemLinkFilterElementType

  • ExternalLinkFiltersType

  • ExternalLinkFilterElementType

  • LinksControlFilterKind

  • LinksControlFilterOnKind

  • ExternalLinkTypeName

  • LinksControlWorkItemTypeFiltersElementType

  • LinksControlWorkItemTypeFilterElementType

  • LinksControlWorkItemTypeFilterScopeKind

  • LinksControlWorkItemTypeFilterKind

  • LinkColumnsType

  • LinkColumnsType

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>

LinkColumnsType

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

Información del elemento

Espacio de nombres

https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/typedef

Nombre de esquema

Definición del tipo de elemento de trabajo

Archivo de validación

WorkItemTypeDefinition.xsd

Tipo de elemento

LinksControlOptionsType

Puede estar vacío

No es aplicable

Vea también

Conceptos

Trabajar con tipos de vínculos

Especificar controles de formulario de elemento de trabajo

Otros recursos

Personalizar la forma en que los elementos de trabajo se relacionan a través de los tipos de vínculos

Definir controles de vínculos para restringir las relaciones de los vínculos

Historial de cambios

Fecha

Historial

Motivo

Mayo de 2011

Se corrigió la letra de varios elementos XML. La definición de esquema para el seguimiento de elementos de trabajo establece todos los elementos secundarios del elemento FORM con la convención Camel y escribe los demás elementos en mayúsculas.

Corrección de errores de contenido.

Enero de 2011

Vínculos reemplazados de los temas que se han quitado.

Mejora de la información.

Julio de 2010

Se agregó una lista completa de nombres de referencia que puede utilizar con el elemento ExternalLinkFilters.

Corrección de errores de contenido.

Junio de 2010

Revisadas las descripciones de los elementos WorkItemTypeFilters y ExternalLinkFilters.

Corrección de errores de contenido.