Definir listas globales

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Mediante el uso de listas globales, puede 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 compartir elementos de lista entre varios WIT para una colección incluyendo los elementos de lista en uno o varios GLOBALLIST elementos.

Cuando defina WIT, puede que vea que algunos campos comparten los mismos valores. Con frecuencia, puede compartir entre varios WIT e incluso en varios proyectos. Algunos de estos valores, como el número de compilaciones nocturnas, cambian 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 presenta 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.

Requisitos

Para la colección de proyectos donde se definen las listas globales, debe tener los permisos siguientes establecidos:

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

• Para importar listas globales, debe ser miembro del grupo de seguridad Project de recopilación de recopilación.

Para agregar o modificar una lista global, use la herramienta de línea de comandos witadmin para importar y exportar la definición de las listas globales. Consulte Administración de listas globales. Para usar una lista global, agrégrela a la FIELD definición dentro de un tipo de elemento de trabajo. Vea Todos los elementos FIELD.

Agregar y administrar listas globales

Una lista global es un conjunto de elementos que todos los proyectos de una colección almacenan y usan LISTITEM globalmente. 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.

Puede definir una o varias listas globales y sus elementos mediante uno de los métodos siguientes de las maneras siguientes en función del modelo de proceso que use:

• Dentro de una definición DE XML de WIT que se agrega a un proyecto o plantilla de proceso (XML hospedado y XML local)
• Dentro de un archivo de definición XML de lista global que se importa a una colección de proyectos (XML local)
• Dentro de un archivo de definición XML de flujo de trabajo global que importe a una colección de proyectos (XML local).

Estructura de sintaxis

En la tabla siguiente se describen los elementos GLOBALLISTy 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.

<GLOBALLIST name="globalListName">  
<LISTITEM> . . . </LISTITEM>  
</GLOBALLIST>

<LISTITEM value="Name" />

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 elementos de trabajo o flujo de trabajo global, vea Todos los elementos WITD o GLOBALWORKFLOW, respectivamente.

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

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

<gl:GLOBALLISTS xmlns:gl="http://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 GLOBALLIST elemento debe tener al menos un elemento LISTITEM definido.

Artículos relacionados

• Administrar listas globales
• Personalizar el seguimiento del trabajo

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

Sí para TFS local. Lista global denominada Compilaciones.TeamProjectName se anexa 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 más información sobre el uso de esta lista, consulte Consulta basada en campos de integración de compilación y prueba.