Compartir a través de

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

  • Artículo

Las listas globales son listas de selección que se pueden incluir en uno o varios campos y tipos de elementos de trabajo. Úselas para minimizar el trabajo necesario para actualizar una lista compartida por varios tipos de elementos de trabajo. Como las listas globales se definen para una colección de proyectos de equipo, pueden incluirse en tipos de elementos de trabajo de todos los proyectos de equipo de la colección.

Puede definir una lista global dentro de su propio archivo de definición, en el archivo de definición de un tipo de elemento de trabajo o en un flujo de trabajo global. La definición de lista global administra las listas globales definidas para una colección. La definición de lista global usa los siguientes comandos en la herramienta de línea de comandos de witadmin:

  • destroygloballist: destruye una lista global.

  • exportgloballist: exporta las listas globales a un archivo XML o a la ventana del símbolo del sistema. Exporta un archivo individual, que contiene todas las listas globales que se hayan definido para la colección de proyectos de equipo.

  • importgloballist: importa listas globales desde un archivo XML. Si intenta importar una lista global que ya existe en el servidor, se muestra una advertencia en la que se le pregunta si desea sobrescribir la lista global que ya está en el servidor. Si intenta importar una lista global que aún no existe, el comando crea una nueva lista global.

  • listgloballist: muestra el nombre de cada una de las listas globales definidas en el servidor.

Vea Definir listas globales y Personalizar el flujo de trabajo global.

Para ejecutar la herramienta de la línea de comandos witadmin, abra una ventana de símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles%\Microsoft Visual Studio 12.0\Common7\IDE

En una edición de 64 bits de Windows, reemplace %programfiles% por %programfiles(x86)%..

Nota

Puede crear y modificar listas globales mediante el editor de procesos, una herramienta avanzada de Visual Studio.Para obtener más información, consulte Herramientas avanzadas de Team Foundation Server.

Requisitos

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

  • 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 importar listas globales, debe ser miembro del grupo de seguridad Administradores de proyectos o tener el permiso Editar información de nivel de proyecto establecido en Permitir.

  • Para destruir una lista global mediante witadmin destroygloballist, debe ser miembro del grupo de seguridad Administradores de la colección de proyectos o tener el permiso Editar información de nivel de colección establecido en Permitir.

Vea Referencia de permisos para Team Foundation Server.

Nota

Incluso si ha iniciado sesión con permisos administrativos, debe abrir una ventana de símbolo del sistema con privilegios elevados para ejecutar esta función en un servidor que ejecute Windows Server 2008.Para abrir una ventana del símbolo del sistema con privilegios elevados, elija Inicio, abra el menú contextual de Símbolo del sistema y elija Ejecutar como administrador.Para obtener más información, vea esta página en el sitio web de Microsoft: Control de cuentas de usuario.

witadmin destroygloballist /collection:CollectionURL /n:GlobalListName [/noprompt] [/force]

witadmin exportgloballist /collection:CollectionURL [/f:FileName] [/e:Encoding] 

witadmin importgloballist /collection:CollectionURL /f:FileName [/e:Encoding]

witadmin listgloballist /collection:CollectionURL

Parámetros

Parámetro

Descripción

/collection:CollectionURL

Especifica el URI de la colección de proyectos de equipo. El formato del URI es el siguiente: http://NombreDeServidor:Puerto/NombreDeDirectorioVirtual/NombreDeColección

Si no se usa ningún directorio virtual, el formato del identificador URI será el siguiente:

http://NombreDeServidor:Puerto/NombreDeColección.

/n:GlobalListName

El nombre de la lista global que se va a destruir.

/f:FileName

La ruta de acceso y el nombre del archivo de definición XML de la lista global que se va a exportar o importar.

Nota

Si el equipo cliente ejecuta Windows Vista, puede que no tenga permisos para determinadas carpetas.Si intenta exportar la lista global a una ubicación para la que no tiene permisos, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual.Para obtener más información, vea las siguientes páginas del sitio web de Microsoft: Virtualización del registro y Problemas de virtualización del registro y archivos comunes en Windows Vista.Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos.

/e:Encoding

El nombre de un formato de codificación de .NET Framework 2,0. La codificación especificada se usará para exportar o importar los datos XML. Por ejemplo, /e utf-7 especifica la codificación Unicode (UTF-7). Si se omite este parámetro, witadmin intenta detectar la codificación y, en caso de no poder detectarla, witadmin usa UTF-8.

/noprompt

Inhabilita la solicitud de confirmación.

/? o help

Muestra ayuda sobre el comando en la ventana del símbolo del sistema.

Comentarios

Al importar una lista global, se crea una lista si no existe ninguna. Si la lista ya existe, el comando witadmin importgloballist le advertirá de que la lista actual se va a sobrescribir. Puede o bien escribir su propio programa para actualizar una lista global existente o bien actualizar usted mismo la lista global con los nuevos datos.

Para crear una nueva lista global, comience por el código indicado a continuación y modifíquelo según sea necesario. En este ejemplo se define una lista global de disciplinas que puede asignar a tareas.

<?xml version="1.0" encoding="utf-8"?>
<gl:GLOBALLISTS xmlns:gl="https://schemas.microsoft.com/VisualStudio/2005/workitemtracking/globallists">
    <GLOBALLIST name="Disciplines">
        <LISTITEM value="Architecture" />
        <LISTITEM value="Requirements" />
        <LISTITEM value="Development" />
        <LISTITEM value="Release Management" />
        <LISTITEM value="Project Management" />
        <LISTITEM value="Test" />
    </GLOBALLIST> 
</gl:GLOBALLISTS>

No incluya grupos de seguridad con un ámbito de proyecto dentro de una lista global, ya que las listas globales no se ciñen a un proyecto, sino a una colección.

Para agregar una lista global a un campo, exporte la definición del tipo de elemento de trabajo que contenga el campo y agréguela a la definición del campo, tal y como se muestra en el siguiente ejemplo:

<FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String">
  <HELPTEXT>The discipline to which the task belongs</HELPTEXT>
  <ALLOWEDVALUES>
     <GLOBALLIST name="Disciplines" />
  </ALLOWEDVALUES>
</FIELD>

Para ver los cambios, importe la definición del tipo y actualice la memoria caché de su cliente o explorador. Puede que tenga que cerrar y volver a abrir todos los elementos de trabajo que hagan referencia al campo.

Para obtener información sobre la exportación e importación de definiciones de tipos, consulte Importar, exportar y administrar tipos de elementos de trabajo [witadmin].

Ejemplos

A menos que se especifique lo contrario, se aplican los siguientes valores en cada ejemplo:

  • URI para la colección de proyectos de equipo: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Número de puerto del sitio web del servidor: 8080

Mostrar los nombres de las listas globales

En el siguiente ejemplo se muestran las listas globales definidas en el servidor. En el ejemplo se exportan las listas globales mediante la codificación UTF-8 predeterminada:

witadmin listgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection

Exportar la definición de listas globales

En el siguiente ejemplo se exportan las listas globales:

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

En el siguiente ejemplo se exportan las mismas listas globales al mismo servidor, pero se usa la codificación Unicode (UTF-7):

witadmin exportgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e:utf-7

Importar la definición de listas globales

En el siguiente ejemplo se importan las listas globales:

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml

En el siguiente ejemplo se importan las mismas listas globales en el mismo servidor, pero se usa la codificación Unicode (UTF-7):

witadmin importgloballist /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /f:C:mygloballists.xml /e utf-7

Vea también

Conceptos

Definir listas globales

Otros recursos

Personalizar el flujo de trabajo global

witAdmin: Personalizar y administrar objetos para el seguimiento de elementos de trabajo