Definir listas globales

El uso de listas globales en Team Foundation Server (TFS) permite minimizar el trabajo necesario para actualizar una lista que aparece en las definiciones de varios tipos de elementos de trabajo (WIT). Las listas globales son listas de selección que se pueden incluir en uno o varios campos y definiciones de WIT. Puede definir una lista global en un WIT que agregue a un proyecto de equipo, como una lista global para una colección de proyectos de equipo o puede definirla en un flujo de trabajo global. Las listas se pueden compartir entre varios WIT de una colección incluyendo los elementos de la lista en uno o más elementos GLOBALLIST.

Cuando defina WIT, puede que vea que algunos campos comparten los mismos valores. A menudo se puede compartir entre varios WIT e incluso entre varios proyectos de equipo. Algunos de estos valores, como el número de compilaciones nocturnas, cambia a menudo. Por tanto, es necesario que un administrador actualice habitualmente estas listas en varias ubicaciones. Las listas globales pueden resultar especialmente útiles cuando es necesario derivar una lista desde un sistema externo. Supongamos, por ejemplo, que una empresa mantiene una base de datos de clientes independiente. Cuando se archiva un error detectado por un cliente, el nombre del cliente se introduce en un campo Found By Customer personalizado.

Las listas globales de una colección se pueden administrar como un archivo XML que se puede enumerar, importar, exportar y eliminar. El nombre de cada lista global puede tener hasta 254 caracteres Unicode y debe ser único dentro de una colección.

Nota
Las plantillas de proceso predeterminadas ofrecidas por TFS no incluyen listas globales definidas por el sistema ni listas globales predefinidas.

Requisitos

• Para exportar o enumerar listas globales, debe ser miembro del grupo Project Collection Valid Users o tener el permiso Ver información de nivel de colección establecido en Permitir.

• Para definir o editar listas globales, debe ser miembro del grupo Project Administrators o tener el permiso Editar información de nivel de proyecto establecido en Permitir.

• Para agregar o modificar una lista global, use la herramienta de línea de comandos witadmin para importar e importar la definición de listas globales. Consulta Administrar listas globales para tipos de elementos de trabajo [witadmin]. Para usar una lista global, agréguela a la definición FIELD en un tipo de elemento de trabajo. Consulta Referencias de todos los elementos FIELD de XML.

Agregar y administrar listas globales

Una lista global es un conjunto de elementos LISTITEM que se almacena y se usa globalmente en todos los proyectos de equipo de una colección. Las listas globales son útiles en campos que están definidos en varios tipos de elementos de trabajo, como Sistema operativo, Encontrado en compilación y Corregido en compilación.

Las listas globales y sus elementos se pueden definir con uno de los métodos siguientes:

• Colección de proyectos de equipo: puede exportar, modificar, eliminar e importar 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: una vez creado un proyecto de equipo, puede agregar a su definición las listas globales que desea que estén disponibles para un tipo de elemento de trabajo.

• Definición de flujo de trabajo global: una vez creado un proyecto de equipo, puede agregar las listas globales que desea que estén disponibles para todos los tipos de elemento de trabajo a la definición de flujo de trabajo global de una colección o proyecto de equipo. Para obtener más información, consulta Personalizar el flujo de trabajo global.

Estructura de sintaxis

En la siguiente tabla se describen los elementos GLOBALLIST y LISTITEM. Estos elementos se pueden usar para enumerar una lista de valores que se presenta al usuario en forma de lista de selección o menú desplegable de elementos.

Elemento	Sintaxis	Descripción
GLOBALLIST	<GLOBALLIST name="globalListName"> <LISTITEM> . . . </LISTITEM> </GLOBALLIST>	Define un conjunto de elementos LISTITEM que se almacena para 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 necesario del elemento GLOBALLISTS y un elemento secundario opcional de los elementos ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES. Para obtener más información, consulta Definir listas de selección.
LISTITEM	<LISTITEM value="Name" />	Define un valor de lista válido. Nota Las listas globales no deben incluir grupos con un ámbito de proyecto, ya que no se ciñen a un proyecto. LISTITEM es un elemento secundario necesario de GLOBALLIST y un elemento secundario opcional de los elementos ALLOWEDVALUES, SUGGESTEDVALUES y PROHIBITEDVALUES.

Lista global de muestra

Si agrega la sintaxis siguiente, puede definir una lista global en un archivo de definición XML para un tipo de elemento de trabajo o un flujo de trabajo global.

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

Si usa la sintaxis siguiente, puede hacer referencia a una lista global en un archivo de definición XML para un tipo de elemento de trabajo:

<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 la ubicación de los archivos de definición para tipos de elemento de trabajo o flujo de trabajo global, vea Referencia de todos los elementos WITD de XML o Referencia de elementos XML para flujos de trabajo globales, respectivamente.

Lista global de muestra mantenida para una colección de proyectos

Para agregar una lista global a una colección de proyectos, puede importar la sintaxis siguiente con 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.

Preguntas y respuestas

P: ¿Hay alguna lista global que se rellene automáticamente con datos?

R: Sí. A la lista global denominada Compilaciones – NombreDeProyectoDeEquipo se le anexan datos cada vez que se ejecuta una compilación. Con el tiempo, la lista puede llegar a ser muy larga. Lo mejor es quitar periódicamente los elementos no usados de la lista.

Para obtener más información sobre cómo usar esta lista, vea Campos para la integración con Test, Build y control de versiones.

Vea también

Referencia

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

Conceptos

Personalizar los objetos de seguimiento del trabajo para admitir los procesos de su equipo