Definir listas de selección

Artículo
08/10/2011

Puede enumerar un conjunto de valores para un campo agregando una lista de selección como parte de su definición o en algún punto durante el flujo de trabajo. Puede especificar que la lista solo pueda contener valores permitidos, que no pueda contener valores prohibidos o puede sugerir valores. Si sugiere valores, los usuarios podrán especificar un valor diferente a los de la lista de selección.

También puede definir listas de selección dependientes, en las que defina dos o más listas para un campo, pero solo aparezca una de ellas en tiempo de ejecución en función de la evaluación de una regla condicional.

En este tema

Estructura de la sintaxis para enumerar listas de selección
Estructura de la sintaxis para los elementos LISTITEM y GLOBALLIST
Permitir un valor existente
Enumerar un conjunto de valores permitidos
Definir listas de selección dependientes

Estructura de la sintaxis para enumerar listas de selección

Puede usar los elementos ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES para especificar una lista de valores que el usuario debe establecer, puede establecer o no debe establecer como valor de un campo. Si usa cada uno de estos elementos, puede enumerar una lista de elementos o especificar una lista global. Puede usar ALLOWEXISTINGVALUE para permitir que un campo almacene un valor existente en caso de que se quite un valor de la lista de selección.

Puede especificar estos elementos como elementos secundarios de FIELD (Definition) o FIELD (Workflow).

Puede usar ALLOWEDVALUES para definir una lista de valores que los usuarios pueden especificar en un formulario de elementos de trabajo o en el editor de consultas. Los usuarios deben especificar uno de los valores de GLOBALLIST o el conjunto de entradas de LISTITEM.

<ALLOWEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</ALLOWEDVALUES>

Puede usar PROHIBITEDVALUES para definir una lista de valores que un campo no puede contener. Los usuarios no pueden guardar un elemento de trabajo si el campo contiene un valor prohibido. Puede usar este elemento si desea restringir el uso de un valor que anteriormente estaba permitido pero que ya no es válido.
```
<PROHIBITEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</PROHIBITEDVALUES>
```

Puede usar SUGGESTEDVALUES para definir una lista de valores que un campo puede contener. Los usuarios pueden especificar otros valores además de los sugeridos.

<SUGGESTEDVALUES for="userGroupName" not="userGroupName" expanditems="true | false" filteritems="excludegroups">
   <GLOBALLIST name="globalListName" />
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</SUGGESTEDVALUES>

En cada uno de estos elementos, puede especificar uno o varios de los atributos que se describen en la tabla siguiente:

Atributo	Descripción
for	Opcional. Especifica el nombre del usuario o grupo de Team Foundation al que se aplica esta regla. Los nombres válidos están compuestos de una cadena de texto que contiene entre 1 y 255 caracteres. Valor de modelo: ^[^\\]+\\[^\\]+$ Ejemplo de un valor de modelo: DomainUserID
not	Opcional. Especifica el nombre del usuario o grupo de Team Foundation al que no se aplica esta regla. Los nombres válidos están compuestos de una cadena de texto que contiene entre 1 y 255 caracteres. Valor de modelo: ^[^\\]+\\[^\\]+$ Ejemplo de un valor de modelo: DomainUserID
expanditems	Opcional. Especifica si un grupo identificado en el elemento LISTITEM debe expandirse para que se incluyan los grupos subordinados de la lista. El valor predeterminado es true.
filteritems	Opcional. Especifica que en la lista solo se incluyen los miembros de los grupos, y no los nombres de grupo. El único valor válido de este atributo es excludegroups.

Para obtener más información, vea Definir y usar listas, listas de selección y listas globales.

Volver al principio

Estructura de la sintaxis para los elementos LISTITEM y GLOBALLIST

Puede usar los elementos LISTITEM y GLOBALLIST para enumerar una lista de elementos que pueden actualizarse globalmente o que son específicos de un único campo.

Puede usar GLOBALLIST para definir un conjunto de elementos LISTITEM que están almacenados en una colección de proyectos de equipo y que todos los proyectos de equipo definidos en esa colección pueden usar. GLOBALLIST es un elemento secundario obligatorio del elemento GLOBALLISTS y un elemento secundario opcional de los elementos ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES. Puede definir una lista global dentro de una definición de elemento de trabajo, una definición de lista global o un flujo de trabajo global.

<GLOBALLIST name="globalListName">
   <LISTITEM value="Name1" />
   <LISTITEM value="Name2" />
   <LISTITEM value="Name3" />
. . . 
</GLOBALLIST>

globalListName: cadena de texto que contiene entre 1 y 255 caracteres.

Importante
Si define una lista global en un archivo XML que define un tipo de elemento de trabajo, debe proporcionar a la lista un nombre único. De lo contrario, podría sobrescribir una lista existente definida para la colección.

Puede usar LISTITEM para enumerar un conjunto de valores. LISTITEM es un elemento secundario necesario del elemento GLOBALLIST y un elemento secundario opcional de ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES.
```
<LISTITEM value="listName" />
```
listName: cadena de texto que contiene entre 1 y 255 caracteres.

Volver al principio

Permitir un valor existente

Puede usar el elemento ALLOWEXISTINGVALUE para permitir que un campo mantenga los valores existentes después de especificar una lista de selección de elementos mediante el elemento ALLOWEDVALUES. Si no especifica el elemento ALLOWEXISTINGVALUE, el usuario, en tiempo de edición, se ve obligado a especificar uno de los valores válidos actuales para dicho campo. El elemento ALLOWEXISTINGVALUE modifica solo los elementos del mismo bloque.

<ALLOWEXISTINGVALUE />

Puede especificar este elemento bajo el elemento FIELD (Workflow) para aplicarlo a las reglas definidas para el campo. Esta aplicación incluye las reglas especificadas en los elementos STATE, TRANSITION, REASON y DEFAULTREASON del campo. Puede especificar este elemento bajo el elemento STATE para aplicarlo no solo a las reglas definidas en el estado del campo, sino también a las reglas definidas para el campo en todas las transiciones al estado.

Puede especificar este elemento bajo el elemento TRANSITION para aplicarlo no solo a las reglas definidas en la transición del campo, sino también a las reglas definidas para el campo en los elementos REASON y DEFAULTREASON.

Volver al principio

Enumerar una lista

Las listas de campos se componen de elementos de lista individuales. Cada lista de campos debe contener al menos un elemento.

Nota

Las listas globales no deben incluir grupos de ámbito de proyecto, porque su ámbito no es un proyecto.

Para especificar los elementos de una lista de campos, utilice el elemento <LISTITEM value="">. Puede especificar una cadena, un nombre de usuario o un nombre de grupo.

<LISTITEM value="Emergency"/>
<LISTITEM value="Major"/>
<LISTITEM value="Minor"/>
<LISTITEM value="Domain\joe"/>
<LISTITEM value="[Global]\GlobalGroup" />
<LISTITEM value="[Project]\ProjectGroup" />

Nota

En tiempo de ejecución, los elementos de una lista aparecen ordenados alfabéticamente en función del idioma del servidor en el que se está ejecutando Visual Studio Team Foundation Server.

Volver al principio

Enumerar un conjunto de valores permitidos

En este ejemplo, el campo Customer Severity puede tener cualquiera de los tres valores: Emergency, Major y Minor. El campo se define como necesario con un valor predeterminado de Minor. En tiempo de ejecución, puede especificar uno de los valores de una lista desplegable.

<FIELD refname="System.Title" name="Title" type="String">
<HELPTEXT>Provide a brief description of the work item</HELPTEXT>
<REQUIRED/>
</FIELD>
<FIELD refname="MyCorp.CusSeverity" name="Customer Severity" type="String">
<HELPTEXT>Indicate the severity of the problem</HELPTEXT>
    <ALLOWEDVALUES>
        <LISTITEM value="Emergency">
        <LISTITEM value="Major">
        <LISTITEM value="Minor">
    </ALLOWEDVALUES>
<DEFAULT from="value" value="Minor"/>
</FIELD>

Volver al principio