Elementos LinksControlOptions

Artículo
11/18/2015

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ínculo que los usuarios pueden ver y crear, y los tipos de elemento de trabajo a los que los usuarios pueden crear los vínculos. En concreto, los elementos siguientes se usan tal como se indica debajo:

WorkItemLinkFilters: se usa para restringir los tipos de vínculo entre elementos de trabajo del proyecto de equipo actual.
ExternalLinkFilters: se usa para restringir los tipos de vínculo que se pueden crear entre elementos de trabajo y otros objetos, como archivos de control de versiones, hipervínculos o conjuntos de cambios.
WorkItemTypeFilters: se usa 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 ha definido en el proyecto de equipo actual.

En cada uno de estos elementos, puede especificar elementos Filter para indicar los tipos de vínculo o de elementos de trabajo que quiere incluir o excluir. Para obtener más información sobre cómo usar 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

<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 siguientes secciones 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 los vínculos que se pueden agregar a un elemento de trabajo y las columnas predeterminadas que aparecen para la lista de vínculos de un elemento de trabajo. El tipo de elemento es 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 complejo: WorkItemLinkFiltersType.
	FilterType	El atributo WorkItemLinkFilters es obligatorio. Define el método usado para filtrar el conjunto de tipos de vínculo proporcionado en el conjunto de elementos Filter. El tipo de elemento es simple: LinksControlFilterKind. Los valores válidos que puede usar son los siguientes: exclude: se usa para no permitir que se creen vínculos a partir de los tipos de vínculo indicados en los elementos Filter. excludeAll: se usa para no permitir ningún tipo de vínculo. include: se usa para permitir solo los tipos de vínculo indicados en los elementos Filter. includeAll: se usa para permitir que se creen todos los tipos de vínculo.
Filter		El elemento WorkItemLinkFilters es obligatorio cuando el valor de FilterType es exclude o include. Cuando el valor de FilterType es excludeAll o includeAll, no deben especificarse elementos Filter. Especifica los tipos de vínculo que se van a incluir o excluir del conjunto de vínculos que se pueden crear para el elemento de trabajo. El tipo de elemento es simple: WorkItemLinkFilterElementType.
	LinkType	El atributo Filter es obligatorio. Especifica el nombre de referencia para un tipo de vínculo. Los tipos válidos incluyen los siguientes tipos de vínculo definidos por el sistema: Storyboard System.LinkTypes.Dependency System.LinkTypes.Hierarchy System.LinkTypes.Related Además, puede especificar el nombre de referencia de los tipos de vínculo personalizados definidos para la colección de proyectos de equipo. Para obtener más información, consulte Referencia de elemento de tipo de vínculo.
	FilterOn	Atributo Filter opcional. Especifica el tipo de filtro que se aplicará al campo. El tipo de elemento es simple: LinksControlFilterOnKind. Los valores válidos son: forwardname: se usa para filtrar según el nombre directo definido para un tipo de vínculo. reversename: se usa para filtrar según el nombre inverso definido para un tipo de vínculo. Si no se especifica, se usan tanto el nombre directo como el inverso para filtrar el tipo de vínculo. Nota Si la topología del tipo de vínculo es red, los nombres directo e inverso son los mismos.Para obtener más información, consulte Referencia de elemento de tipo de vínculo.
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 establecer para crear relaciones con objetos que no sean elementos de trabajo, como los conjuntos de cambios, hipervínculos y archivos bajo control de versiones. El tipo de elemento es complejo: ExternalLinkFiltersType.
	FilterType	Atributo ExternalLinkFilters opcional. Define el método usado para filtrar la lista de tipos de vínculo proporcionada en el conjunto de elementos Filter. El tipo de elemento es simple: LinksControlFilterKind. Puede usar los valores siguientes: exclude: se usa para no permitir que se creen vínculos a partir de los tipos de vínculo que aparecen en los elementos Filter. excludeAll: se usa para no permitir ningún tipo de vínculo. include: se usa para permitir solo los tipos de vínculo indicados en los elementos Filter. includeAll: se usa para permitir que se creen todos los tipos de vínculo. Si no se especifica, se excluyen todos los vínculos a elementos de trabajo externos.
Filter		El elemento ExternalLinkFilters es obligatorio cuando el valor de FilterType es exclude o include. Cuando el valor de FilterType es excludeAll o includeAll, no deben especificarse elementos Filter. El tipo de elemento es complejo: ExternalLinkFilterElementType. Especifica el nombre de los tipos de vínculo que se van a incluir o excluir 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 para incluir o excluir un tipo de vínculo. 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 de 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 simple: LinksControlWorkItemTypeFilterScopeKind. Los valores válidos que puede usar son los siguientes: all: se usa para permitir que se creen vínculos a todos los tipos de elemento de trabajo especificados en las etiquetas Filter. project: se usa para permitir que solo se creen vínculos a los tipos de elemento de trabajo que se definen para el proyecto actual. Si no se especifica, se permiten vínculos a todos los tipos de elementos de trabajo.
	FilterType	El atributo WorkItemTypeFilters es obligatorio. Define el método usado para filtrar el conjunto de elementos de trabajo proporcionado en el conjunto de elementos Filter. El tipo de elemento es simple: LinksControlWorkItemTypeFilterKind. Puede usar los valores siguientes: exclude: se usa para no permitir los tipos de elemento de trabajo de los elementos Filter. excludeAll: se usa para no permitir ningún tipo de elemento de trabajo. include: se usa para permitir los tipos de elemento de trabajo de los elementos Filter. includeAll: se usa 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		El elemento WorkItemTypeFilters es opcional cuando el valor de FilterType es exclude o include. Si el valor de FilterType es excludeAll o includeAll, no debe especificar ningún elemento Filter. Especifica los tipos de elemento de trabajo que se van a incluir o excluir del conjunto de tipos de elemento de trabajo a los que se puede establecer vínculos. El tipo de elemento es complejo: LinksControlWorkItemTypeFilterElementType.
	WorkItemType	El atributo Filter es obligatorio. Especifica el nombre de referencia del tipo de elemento de trabajo que se va a filtrar. El tipo de atributo es: typelib:NonEmptyPlainConstant. Longitud mínima: 1; longitud máxima: 255. Valor de patrón: ^[^\\]*$ 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 complejo: LinkColumnsType.
LinkColumn		Elemento LinkColumns necesario. Especifica los campos de elemento de trabajo y atributos de tipo de vínculo que se muestran en la lista de vínculos definida para un elemento de trabajo. El tipo de elemento es complejo: LinkColumnType. Esta lista de columnas es la presentación predeterminada. El usuario puede agregar y quitar columnas de la lista de vínculos. El orden en el que aparecen los elementos LinkColumn define el orden en el que se muestran los campos de columna en el formulario del elemento de trabajo.
	RefName	Atributo LinkColumn opcional. Especifique RefName o LinkAttribute, pero no ambos. Especifica el nombre de referencia correspondiente a un campo válido del elemento de trabajo para 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 correspondiente 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	Requerido. 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 usar el elemento LinksControlOptions para admitir las acciones siguientes:

Especifique las restricciones que rigen la creación de relaciones con otros elementos de trabajo según el tipo de vínculo y, opcionalmente, los nombres directo e inverso de los tipos de vínculo.
Especifique las restricciones que rigen la creación de relaciones con objetos que no sean elementos de trabajo, como conjunto de cambios, hipervínculo, etc., en función de los tipos de vínculo externo.
Especifique las restricciones que rigen la creación de relaciones con otros elementos de trabajo según el tipo de vínculo y, opcionalmente, el proyecto de equipo en el que se han definido dichos elementos.
Especifique los campos de columna predeterminados cuya información quiere mostrar en la lista de vínculos.

Ejemplo

En el ejemplo siguiente se especifica cómo habilitar la creación de vínculos del tipo Microsoft.VSTS.Common.TestedBy y se muestra el Forward Name para este tipo de vínculo. Las opciones de filtro no permiten crear de vínculos a todos los tipos de vínculo externo. Además, los campos de columna predeterminados para los vínculos enumerados se corresponden con los siguientes nombres descriptivos: Id., Tipo de elemento de trabajo, Título, Asignado a, Estado y el campo Comentario definidos para el vínculo. Para ver más ejemplos, consulte 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>

Botones de la barra de herramientas LinksControl

Cada elemento Control de Type=”LinksControl” proporciona una barra de herramientas, que contiene los botones que aparecen en la ilustración siguiente:

Controles de la barra de herramientas de vínculos del formulario de elemento de trabajo

Estos botones están disponibles una vez que se realice una acción específica:

El botón para crear un elemento de trabajo que esté vinculado al elemento de trabajo abierto () está disponible después de guardar el elemento de trabajo abierto.
Los botones para abrir la lista de elementos de trabajo en una consulta () y en un cliente de Microsoft Office () están disponibles cuando la pestaña de control de vínculos contiene al menos un elemento de trabajo.
Los botones para abrir un elemento de trabajo (), editar un vínculo () y eliminar un vínculo () están disponibles después de hacer clic en uno o varios de los elementos de trabajo que aparecen en la pestaña de control de vínculos.

El control de vínculos que se muestra es el mismo para ambos Team Web Access y Team Explorer, excepto cuando se configura solo para representar vínculos Storyboard. En ese caso, la barra de herramientas solo contiene los controles para agregar un vínculo nuevo, abrir el elemento vinculado y eliminar el vínculo. Además, la versión Team Web Access muestra el vínculo Iniciar guiones gráficos en el menú de control.

Control de vínculos a guion gráfico

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

Información de 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 aplicable

Vea también

Conceptos

Referencia de elemento de tipo de vínculo

Especificar controles de formulario de elemento de trabajo

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

Otros recursos

Definir un tipo de vínculo personalizado