Administrar listas globales para tipos de elemento de trabajo

Artículo
02/20/2013

Las listas globales son listas de selección que puede incluir en uno o más campos y tipos de elementos de trabajo.Utilícelos para minimizar el trabajo necesario para actualizar una lista que comparten diferentes tipos de elementos de trabajo.Dado que las listas globales se definen para una colección de proyectos de equipo, pueden incluirse en los tipos de elemento de trabajo para todos los proyectos de equipo de la colección.

[!NOTA]

Las listas globales no deben incluir grupos de seguridad de ámbito de proyecto porque no tienen el mismo ámbito que un proyecto de equipo.

Puede definir una lista global dentro de su propio archivo de definición, en el archivo de definición para un tipo de elemento de trabajo, o en el flujo de trabajo global.La definición de la lista global administra las listas globales definidas para una colección.La definición de la lista global usa los siguientes comandos en la herramienta de línea de comandos 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 solo archivo, que contiene todas las listas globales definidas para la colección de proyectos de equipo.
importgloballist: importa listas globales de un archivo XML.Si intenta importar una lista global que ya existe en el servidor, una advertencia pregunta si desea sobrescribir la lista global que se encuentra 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 lista global definida 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 11.0\Common7\IDE

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

[!NOTA]

Puede crear y modificar listas globales utilizando el Editor de procesos, una herramienta avanzada de Visual Studio.No se ofrece soporte técnico para esta herramienta.Para obtener más información, vea la página siguiente en el sitio web de Microsoft: Team Foundation Server Power Tools.

Requisitos

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

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 destruir o importar listas globales, debe ser miembro del grupo de seguridad Administradores de Team Foundation o del grupo de seguridad Administradores del proyecto.

Vea Permisos de Team Foundation Server y Grupos predeterminados, permisos y roles de 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 la ventana el menú contextual para Símbolo del sistema y elija Ejecutar como administrador.Para obtener más información, vea esta página del 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 identificador URI es el siguiente: http://NombreServidor:Puerto/NombreDirectorioVirtual/NombreColección Si no se usa ningún directorio virtual, el formato del identificador URI será el siguiente: http://NombreServidor:Puerto/NombreColección.
/n:GlobalListName	El nombre de la lista global que se desea destruir.
/f:FileName	La ruta de acceso y el nombre del archivo de definición XML de lista global que se desea exportar o importar. Nota Si el equipo cliente ejecuta Windows Vista, es posible 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 páginas siguientes del sitio web de Microsoft: Registry Virtualization y Common file and registry virtualization issues in Windows Vista.Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos.
/e:Encoding	Nombre de un formato de codificación de .NET Framework 2.0.La codificación especificada se utilizará para exportar o importar los datos XML.Por ejemplo, /e utf-7 especifica la codificación Unicode (UTF-7).Si omite este parámetro, witadmin intenta detectar la codificación, y si se produce un error en la detección, witadmin utiliza UTF-8.
/noprompt	Deshabilita el aviso para la confirmación.
/? O bien 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 advertirá de que se va a sobrescribir la lista actual.Puede escribir su propio programa para actualizar una lista global existente, o puede actualizarla personalmente con los nuevos datos.

Para crear una nueva lista global, comience con el código siguiente y modifíquelo según sea necesario.Este ejemplo define una lista global de disciplinas que se pueden asignar a las 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>

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

<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 de tipo y actualice el explorador o la caché del cliente.Es posible que deba cerrar los elementos de trabajo que hacen referencia al campo y volver a abrirlos.

Para obtener información acerca de la exportación y la importación de definiciones de tipos, vea Personalizar y administrar tipos de elemento de trabajo [witadmin].

Ejemplos

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

Identificador URI de 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 listas globales

En el siguiente ejemplo se muestran las listas globales definidas en el servidor.En este 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

El siguiente ejemplo exporta las mismas listas globales al mismo servidor, pero utiliza 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 listas globales:

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

El siguiente ejemplo importa las mismas listas globales al mismo servidor, pero utiliza 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

Compartir a través de