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

Puede controlar qué elementos de trabajo se vinculan entre sí personalizando el formulario de trabajo. En concreto, puede controlar los tipos de vínculos y elementos de trabajo que los usuarios pueden ver y agregar en un control de vínculos. Por ejemplo, tal vez desee agregar una pestaña en el formulario que le ayude a administrar las características dependientes. En esa pestaña, puede agregar el control de vínculos y restringir las relaciones del vínculo que los miembros del equipo pueden ver y realizar desde ese control para incluir solo los vínculos a otras características.

Puede usar el atributo LinksControl Type del elemento Control para permitir que los usuarios creen relaciones de vínculos entre elementos de trabajo y otros objetos de la base de datos de Team Foundation. A continuación, podrá usar los elementos secundarios LinksControlOptions para definir opciones que le permitan controlar qué vínculos pueden agregar los miembros del equipo a un elemento de trabajo y con qué tipos de elemento de trabajo u objetos se pueden vincular. Además, puede definir las columnas predeterminadas que desea que aparezcan en la lista de vínculos de ese control.

Para obtener un resumen de las restricciones de vínculos definidos para las plantillas de proceso de TFS, vea Referencia de campos, controles y restricciones de vínculos. Para obtener más información sobre los tipos de vínculos, vea Referencia de elemento de tipo de vínculo.

En este tema

• Especificar el control de vínculos

• Controlar las relaciones de los vínculos

• Restringir las relaciones de los vínculos con elementos de trabajo

• Restringir las relaciones de los vínculos con conjuntos de cambios, hipervínculos y otros elementos que no son de trabajo

• Restringir las relaciones de los vínculos con los tipos de elementos de trabajo

• Especificar las columnas predeterminadas que se van a mostrar

Especificar el control de vínculos

Puede usar la opción LinksControl para permitir a los usuarios agregar, ver y administrar las relaciones de vínculos en un formulario de elemento de trabajo. Mediante este control, puede abrir, modificar, agregar y quitar vínculos.

Puede personalizar un formulario para que en una pestaña se muestren solo los vínculos primarios y secundarios y en otra pestaña, todos los demás tipos de vínculo. En el ejemplo siguiente, se crea una pestaña denominada "All Links" que los miembros del equipo pueden utilizar para agregar todo tipo de vínculos. Asimismo, las columnas predeterminadas que aparecen para la presentación de vínculos son ID, Work Item Type, Title, Assigned To, State y el campo Link Comment:

Control de vínculos

<Tab Label="All Links">
   <Control Type="LinksControl" Name="All" >
      <LinksControlOptions>
         <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>
</Tab>

Volver al principio

Controlar las relaciones de los vínculos

Cuando agregue un control de vínculos a un formulario de elemento de trabajo, puede especificar filtros que restrinjan los tipos de vínculos y los elementos de trabajo que los miembros del equipo pueden agregar cuando usan el control. En la tabla siguiente se describen los elementos secundarios opcionales que controlan las relaciones de los vínculos.

Elemento	Descripción
WorkItemLinkFilters	Restringe los tipos de vínculos que pueden usarse para vincular elementos de trabajo.
ExternalLinkFilters	Restringe los tipos de vínculos que pueden usarse para vincular un objeto que no es un tipo de elemento de trabajo, como un conjunto de cambios, un hipervínculo o un elemento de control de versiones.
WorkItemTypeFilters	Restringe los tipos de elementos de trabajo con los que puede vincularse un usuario y los proyectos de equipo en los que se definen esos elementos de trabajo.
Filter	Especifica los tipos de vínculos o tipos de elemento de trabajo que desea incluir o excluir.

Volver al principio

Restringir las relaciones de los vínculos con elementos de trabajo

Puede usar los elementos secundarios WorkItemLinkFilters y Filter para definir qué tipos de vínculos debe incluir o excluir el control de vínculos. Puede usar este elemento para restringir los tipos de vínculos que el control de vínculos puede seleccionar para establecer relaciones con los elementos de trabajo definidos en el mismo proyecto. La sintaxis de estos elementos es la siguiente.

<WorkItemLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="linkTypeRefName" FilterOn="reversename | forwardname" />
</WorkItemLinkFilters>

Atributo	Descripción
FilterType	El atributo WorkItemLinkFilters es obligatorio. Define el método que se utiliza para filtrar el conjunto de tipos de vínculos proporcionado en el conjunto de elementos Filter. Puede usar los siguientes valores válidos: exclude: utilícelo para evitar la creación de vínculos de los tipos enumerados en los elementos Filter. excludeAll: utilícelo para impedir todos los tipos de vínculo. include: utilícelo para permitir solo los tipos de vínculos enumerados en los elementos Filter. includeAll: utilícelo para permitir la creación de vínculos de todos los tipos.
LinkType	El atributo Filter es obligatorio. Especifica el nombre de referencia de un tipo de vínculo. Para obtener más información, vea Referencia de elemento de tipo de vínculo.
FilterOn	Atributo Filter opcional. Especifica el tipo de filtro que se va a aplicar al tipo de vínculo. Puede usar los siguientes valores válidos: forwardname: utilícelo para filtrar por el nombre de vínculo hacia delante definido para un tipo de vínculo. reversename: utilícelo para filtrar por el nombre de vínculo inverso definido para un tipo de vínculo. Si no se especifica, los nombres de vínculos hacia delante e inversos se utilizan para filtrar el tipo de vínculo. 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 Referencia de elemento de tipo de vínculo.

Ejemplo: Excluir dos tipos de vínculos del elemento de trabajo

Puede definir un control de vínculos que permita las relaciones de todos los tipos de vínculos a excepción de los tipos de vínculos de requisito personalizado y jerarquía del sistema utilizando el siguiente ejemplo de código.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="exclude">
         <Filter LinkType="MyLinks.LinkTypes.Requirement" /> 
         <Filter LinkType="System.LinkTypes.Hierarchy" /> 
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
. . .
</Control>

Volver al principio

Restringir las relaciones de los vínculos con conjuntos de cambios, hipervínculos y otros elementos que no son de trabajo

Puede usar los elementos secundarios ExternalLinkFilters y Filter para definir cuáles de los tipos de vínculos que se establecen con elementos que son externos al proyecto de equipo debe incluir o excluir el control de vínculos. La sintaxis de estos elementos es la siguiente.

<ExternalLinkFilters FilterType="include | exclude | includeAll | excludeAll">
   <Filter LinkType="externalLinkName" />
</ExternalLinkFilters>

Atributo	Descripción
FilterType	Atributo ExternalLinkFilters opcional. Define el método que se utiliza para filtrar el conjunto de tipos de vínculos proporcionado en el conjunto de elementos Filter. Puede usar los siguientes valores válidos: exclude: utilícelo para no permitir la creación de vínculos de los tipos enumerados en los elementos Filter. excludeAll: utilícelo para impedir todos los tipos de vínculo. include: utilícelo para permitir solo los tipos de vínculos enumerados en los elementos Filter. includeAll: utilícelo para permitir la creación de vínculos de todos los tipos. Si no se especifica, se excluyen todos los vínculos a los elementos de trabajo externos.
LinkType	El atributo Filter es obligatorio. Especifica el nombre de referencia de un tipo de vínculo que se va a excluir o incluir. 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

Ejemplo: Excluir todos los vínculos que no se establecen con elementos de trabajo

En el ejemplo siguiente se define un control de vínculos que incluye todos los tipos de elementos de trabajo, como los elementos de trabajo relacionados y los elementos de trabajo primario/secundario, pero se excluyen los tipos de vínculos que no se establecen con elementos de trabajo, como los conjuntos de cambios, los hipervínculos y los resultados de pruebas.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="includeAll" /> 
      <ExternalLinkFilters FilterType="excludeAll" /> 
   </LinksControlOptions>
</Control>

En el siguiente ejemplo se define un control de vínculos que permite a los usuarios especificar únicamente el tipo de vínculo del conjunto de cambios y establece vínculos solo como conjuntos de cambios.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="excludeAll"/>
      <ExternalLinkFilters FilterType="include" /> 
         <Filter LinkType="Fixed in Changeset" />
      </ExternalLinkFilters> 
 </LinksControlOptions>
. . .
</Control>

Volver al principio

Restringir las relaciones de los vínculos con los tipos de elementos de trabajo

Puede usar los elementos secundarios WorkItemTypeFilters y Filter para restringir los tipos de elementos de trabajo con los que un control de vínculos puede vincularse. Puede restringir las relaciones del vínculo con el proyecto de equipo o en función del tipo de elemento de trabajo. La sintaxis de estos elementos es la siguiente.

<WorkItemTypeFilters Scope=" project | all" FilterType=" include | exclude | includeAll" >
   <Filter WorkItemType="workItemTypeReferenceName" />
</WorkItemTypeFilters>

Atributo	Descripción
Scope	Atributo WorkItemTypeFilters opcional. Define el ámbito del filtro que se aplica al conjunto de tipos de elemento de trabajo que se proporciona en el conjunto de elementos de Filter. Puede usar los siguientes valores válidos: all: utilícelo para permitir la creación de vínculos con todos los tipos de elemento de trabajo que se especifican en los elementos Filter. project: utilícelo para permitir la creación de vínculos solo con los tipos de elemento de trabajo definidos para el proyecto actual. Si no se especifica, se permiten los vínculos a todos los tipos de elemento de trabajo.
FilterType	El atributo WorkItemTypeFilters es obligatorio. Define el método que se utiliza para filtrar el conjunto de tipos de vínculos proporcionado en el conjunto de elementos Filter. Puede usar los siguientes valores válidos: exclude: utilícelo para no permitir los tipos de elemento de trabajo enumerados 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 enumerados en los elementos Filter. includeAll: utilícelo para permitir todos los tipos de elemento de trabajo.
WorkItemType	El atributo Filter es obligatorio. Especifica el nombre de referencia de un tipo de elemento de trabajo.

Ejemplo: Limitar las relaciones de los vínculos con los elementos de trabajo de tareas

En el siguiente ejemplo se define un control de vínculos que solo permite que se establezcan relaciones jerárquicas en las tareas definidas en el proyecto de equipo.

<Control Type="LinksControl" Name="UniqueName">
   <LinksControlOptions>
      <WorkItemLinkFilters FilterType="include">
         <Filter LinkType="System.LinkTypes.Hierarchy" />
      </WorkItemLinkFilters>
      <ExternalLinkFilters FilterType="excludeAll"/>
      <WorkItemTypeFilters Scope ="project" FilterType="include" />
         <Filter WorkItemType="Task" />
      </WorkItemTypeFilters> 
   </LinksControlOptions>
. . .
</Control>

Volver al principio

Especificar las columnas predeterminadas que se van a mostrar

Puede usar los elementos secundarios LinkColumns y LinkColumn para especificar las columnas predeterminadas que se van a mostrar en el control de vínculos. Puede especificar el nombre de referencia de un campo de elemento de trabajo o un atributo de vínculo. La sintaxis de estos elementos es la siguiente.

<LinkColumns>
   <LinkColumn RefName="reference name" | LinkAttribute=" link attribute name" />
</LinkColumns>

El orden en el que se enumeran los elementos determina el orden en el que se muestran los campos de columna en el formulario de elemento de trabajo. Para obtener una lista de nombres de referencia y atributos de vínculos, vea Referencia de campos de elementos de trabajo para Visual Studio ALM. En la siguiente sintaxis se define la presentación de cuatro columnas: ID, State, Title y el atributo de vínculo Comment.

<Control Type="LinksControl">
. . .
   <LinksControlOptions>
      <LinkColumns>
         <LinkColumn RefName="System.ID" />
         <LinkColumn RefName="System.State" />
         <LinkColumn RefName="System.Title" />
         <LinkColumn LinkAttribute="System.Links.Comment" />
      </LinkColumns>
   </LinksControlOptions>
</Control>

Volver al principio

Vea también

Referencia

Elementos LinksControlOptions

Conceptos

Referencia de campos, controles y restricciones de vínculos

Referencia de elemento de tipo de vínculo

Especificar controles de formulario de elemento de trabajo