Definir listas globales

Con las listas globales, es posible minimizar el trabajo necesario para actualizar una lista que comparten diferentes tipos de elementos de trabajo. Las listas globales son listas de selección que se pueden incluir en uno o más campos y tipos de elementos de trabajo. Se puede definir una lista global en un tipo de elemento de trabajo que se agrega a un proyecto de equipo o plantilla de proceso, como una lista global para una colección de proyectos de equipo, o en un flujo de trabajo global. Puede compartir los elementos de lista entre varios tipos de elementos de trabajo para una colección de proyectos de equipo incluyendo los elementos de lista en uno o más elementos GLOBALLIST.

Cuando defina tipos de elementos de trabajo, puede que algunos campos compartan los mismos valores. Con frecuencia, se pueden compartir entre varios tipos de elementos de trabajo e incluso entre varios proyectos de equipo. Algunos de estos valores pueden cambiar con frecuencia, como el número de compilación de las compilaciones nocturnas, que exige a un administrador que actualice a menudo estas listas en numerosas ubicaciones. Las listas globales pueden resultar de especial utilidad cuando es preciso derivar una lista de un sistema externo. Por ejemplo, suponga que una empresa mantiene una base de datos de clientes independiente. Cuando se presenta un error detectado por un cliente, el nombre del cliente se especifica en un campo Found By Customer personalizado.

Las listas globales de una colección se administran como archivos XML que se pueden mostrar, importar, exportar y eliminar. El nombre de cada lista global puede tener hasta 254 caracteres Unicode y debe ser único en una colección.

En este tema

• Agregar y administrar listas globales

• Estructura de la sintaxis para definir las listas globales

• Estructura de la sintaxis de las listas globales agregadas a una definición de tipo de elemento de trabajo o flujo de trabajo global

• Estructura de la sintaxis de las listas globales mantenidas para una colección

Agregar y administrar listas globales

Una lista global es un conjunto de los elementos LISTITEM que almacenan y utilizan globalmente todos los proyectos de equipo de una colección. Las listas globales son útiles para los campos que se definen dentro de varios tipos de elemento de trabajo, tales como Sistema operativo, Encontrado en la compilación, Corregido en la compilación y otros campos.

Puede definir listas globales y sus elementos utilizando uno de los siguientes métodos:

• Plantilla de proceso: se definen las listas globales para una plantilla de proceso. Cada proyecto de equipo que se crea con esa plantilla tiene acceso a las listas globales.

• Colección de proyectos de equipo: se pueden mostrar, importar, exportar y eliminar las listas globales definidas para una colección de proyectos de equipo. Estas listas globales están disponibles para todos los proyectos de equipo de la colección.

• Definición de tipo de elemento de trabajo: agregue las listas globales que desee tener disponibles para un elemento de trabajo a la definición de tipo.

• Definición de flujo de trabajo global: puede agregar las listas globales que desea tener disponibles para todos los tipos de elementos de trabajo a la definición de flujo de trabajo global de un proyecto de equipo o colección. Para obtener más información, vea Personalizar el flujo de trabajo.

Volver al principio

Estructura de la sintaxis para definir las listas globales

En la tabla siguiente se describen los elementos GLOBALLIST y LISTITEM. Puede usar estos elementos para enumerar una lista de valores que se presenta al usuario como una lista de selección o un menú desplegable con los elementos.

Elemento	Sintaxis	Descripción
GLOBALIST	<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>	Define un conjunto de los elementos LISTITEM que se almacenan en una colección y que todos los proyectos de equipo de una colección pueden usar. globalListName: cadena de texto que contiene entre 1 y 255 caracteres. GLOBALLIST es un elemento secundario obligatorio del elemento GLOBALLISTS y un elemento secundario opcional de los elementos ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES. Para obtener más información, vea Definir listas de selección.
LISTITEM	<LISTITEM value="Name" />	Define un valor de lista válido. Nota Las listas globales no deben incluir grupos de ámbito de proyecto, porque su ámbito no es un proyecto. LISTITEM es un elemento secundario necesario del elemento GLOBALLIST y un elemento secundario opcional de ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES.

Volver al principio

Estructura de la sintaxis de las listas globales agregadas a una definición de tipo de elemento de trabajo o flujo de trabajo global

Puede definir una lista global dentro de un archivo de definición de XML para un tipo de elemento de trabajo o un flujo de trabajo global agregando la siguiente sintaxis:

<GLOBALLISTS>
    <GLOBALLIST name="name of global list">
        <LISTITEM value="List item 1" />
        <LISTITEM value="List item 2" />
        <LISTITEM value="List item 3" />
        <LISTITEM value="List item 4" />
        . . .
        <LISTITEM value="List item n" />
    </GLOBALLIST>
</GLOBALLISTS>

Puede hacer referencia a una lista global dentro de un archivo de definición de XML para un tipo de elemento de trabajo utilizando la siguiente sintaxis:

<GLOBALLISTS>
   <GLOBALLIST name=" name of global list 1" />
   <GLOBALLIST name=" name of global list 2" />
   . . .
   <GLOBALLIST name=" name of global list n" />
</GLOBALLISTS>

Para obtener información sobre la estructura y ubicación de los archivos de definición de tipos de elementos de trabajo o el flujo de trabajo global, vea Referencia de todos los elementos XML WITD o Referencia de elementos XML para flujos de trabajo globales, respectivamente.

Volver al principio

Estructura de la sintaxis de las listas globales mantenidas para una colección de proyectos

Para agregar una lista global a una colección de proyectos, importe la sintaxis siguiente mediante el comando witadmin importgloballist:

<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2008/workitemtracking/globallists">
    <GLOBALLIST name="NameOfGlobalList">
        <LISTITEM value="ListItem1" />
        <LISTITEM value="ListItem2" />
        <LISTITEM value="ListItem3" />
        <LISTITEM value="ListItem4" />
        . . .
        <LISTITEM value="ListItemN" />
    </GLOBALLIST>
</gl:GLOBALLISTS>

Una lista global no puede estar vacía. Cada elemento GLOBALLIST debe tener al menos un elemento LISTITEM definido.

Volver al principio

Vea también

Tareas

Agregar, usar y administrar listas globales

Referencia

Administrar listas globales para tipos de elemento de trabajo [witadmin]

Conceptos

Personalizar datos de seguimiento, formularios, flujos de trabajo y otros objetos de proyecto

Definir y usar listas, listas de selección y listas globales

Otros recursos

Personalizar el flujo de trabajo

Historial de cambios