Compartir a través de


Definir listas globales

Utilizar listas globales en Team Foundation Server (TFS), puede 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.Puede definir una lista global dentro de un tipo de elemento de trabajo que se agrega a un proyecto de equipo, como una lista global para una colección de proyectos de equipo, o dentro de 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.

[!NOTA]

No hay listas globales sistema- definido, ni listas globales predefinidas en las plantillas de proceso predeterminadas que TFS proporciona.

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

[!NOTA]

Para agregar o modificar una lista global, utilizar la herramienta de línea de comandos witadmin para importar y exportar la definición de listas globales.Vea Administrar listas globales para tipos de elemento de trabajo [witadmin].Para utilizar una lista global, agréguela a la definición de FIELD dentro de un tipo de elemento de trabajo.Vea Referencias de todos los elementos FIELD de XML.

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:

  • Procesar la plantilla: Puede definir listas globales dentro de la definición de un tipo de elemento de trabajo de 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: Después de crear un proyecto de equipo, puede agregar las listas globales que desee tener disponibles para un tipo de elemento de trabajo a la definición.

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

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

LISTITEM

<LISTITEM value="Name" />

Define un valor de lista válido.

NotaNota
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

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 listas de usuario, listas desplegables y listas globales

Otros recursos

Personalizar el flujo de trabajo global