Administrar listas globales para tipos de elemento de trabajo
Con las listas globales, es posible 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 puede incluir en uno o más campos y tipos de elementos de trabajo. Puede definir listas globales para un proyecto de equipo, una colección de proyectos de equipo, una plantilla de proceso o el flujo de trabajo global.
Puede definir una lista global dentro de su propio archivo de definición, en una para un tipo de elemento de trabajo, o en flujo de trabajo global. Al utilizar la definición de la lista global, puede administrar las listas globales que se definen para una colección mediante los siguientes comandos en la herramienta de la 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.
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 del 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.
Para obtener más información, vea Definir listas globales y Personalizar el flujo de trabajo.
La utilidad de línea de comandos witadmin se encuentra en Unidad:\Archivos de programa\Microsoft Visual Studio 10.0\Common7\IDE en el equipo cliente que ejecuta Team Explorer. En equipos de 64 bits, la herramienta está en Unidad:\Archivos de programa (x86)\Microsoft Visual Studio 10.0\Common7\IDE.
Para obtener más información sobre las listas globales, vea Definir listas globales.
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 April 2010.
Permisos necesarios
Para la colección de proyectos de equipo en la que se definen las listas globales, debe tener los siguientes permisos establecidos:
Para exportar listas globales, deberá ser miembro del grupo Lectores o tener el permiso Ver los elementos de trabajo en este nodo 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.
Para obtener más información, 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, haga clic en Inicio, haga clic con el botón secundario en Símbolo del sistema y, a continuación, haga clic en 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 identificador 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. .gif "Nota") 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.
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/AWTeam/Collection1
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/AWTeam/Collection1
Exportar la definición de listas globales
En el siguiente ejemplo se exportan las listas globales:
witadmin exportgloballist /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /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/AWTeam/Collection1 /f:C:mygloballists.xml /e utf-7
Vea también
Tareas
Agregar, usar y administrar listas globales
Conceptos
Otros recursos
Personalizar el flujo de trabajo
witAdmin: Administrar objetos para el seguimiento de elementos de trabajo
Historial de cambios
Fecha |
Historial |
Motivo |
|---|---|---|
|
Enero de 2011 |
Describió las ventajas de utilizar listas globales y agregó información acerca del flujo de trabajo global. |
Mejora de la información. |