Personalizar categorías para tipos de elemento de trabajo
Puede administrar las categorías de los tipos de elemento de trabajo definidos para un proyecto de equipo utilizando los siguientes comandos witadmin:
exportcategories: exporta la definición XML de categorías definida en un servidor que ejecuta Team Foundation Server.
importcategories: importa un archivo de definición XML del tipo de elemento de trabajo en un proyecto de equipo en un servidor que ejecuta Team Foundation Server.
Si una categoría con el mismo nombre ya existe, este comando sobrescribe la definición existente. Si el tipo de elemento de trabajo aún no existe, este comando crea una nueva categoría.
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.
Nota
Puede crear y modificar las categorías utilizando el Editor de procesos, una herramienta avanzada de Visual Studio. Esta herramienta avanzada no es compatible. 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 los tipos de elemento de trabajo, debe tener los siguientes permisos establecidos:
Para exportar categorías de tipos de elemento de trabajo, deberá ser miembro del grupo Lectores o tener el permiso Ver los elementos de trabajo en este nodo establecido en Permitir
Para importar categorías de tipos de elemento de trabajo, 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 de símbolo del sistema con permisos 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 el sitio web de Microsoft: Control de cuentas de usuario.
witadmin exportcategories /collection:CollectionURL /p:Project [/f:FileName] [/e:Encoding]
witadmin importcategories /collection:CollectionURL /p:Project /f:FileName [/e:Encoding]
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. |
/p:Project |
El nombre del proyecto de equipo al que se exportan las categorías o del que se importan las categorías. |
/f:Nombre de archivo |
La ruta de acceso y nombre de archivo del archivo de definición XML que contiene las categorías que se van a exportar o importar. Si omite este parámetro al utilizar el comando exportcategories, este enumera las categorías en la ventana del símbolo del sistema. |
/e:Codificación |
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. |
/? o help |
Muestra ayuda sobre el comando en la ventana del símbolo del sistema. |
Comentarios
Al importar un archivo de categorías, se crean las categorías si aún no existen. Si las categorías ya existen, el comando witadmin importcategories advertirá de que se va a sobrescribir la lista actual. Puede escribir su propio programa para actualizar un conjunto de categorías existente o puede actualizar las categorías usted mismo con nuevos datos.
Para obtener información sobre la estructura del archivo XML de categorías, vea Referencia del esquema de definición de categorías.
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
Nombre del proyecto: AdventureWorks
Nombre del archivo de entrada o salida: myCategories.xml
Codificación predeterminada: UTF-8
Mostrar categorías de tipo de elemento de trabajo
El siguiente comando hace una lista de las categorías de tipo de elemento de trabajo definidas para el proyecto AdventureWorks.
witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks
Exportar las categorías de tipo de elemento de trabajo
El siguiente comando exporta las categorías de tipo de elemento de trabajo definidas para el proyecto AdventureWorks al archivo XML myCategories.
witadmin exportcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml
Importar las categorías de tipo de elemento de trabajo
En el siguiente ejemplo se importan las categorías del archivo XML myCategories al proyecto AdventureWorks.
witadmin importcategories /collection:http://AdventureWorksServer:8080/AWTeam/Collection1 /p:AdventureWorks /f:myCategories.xml
Vea también
Otros recursos
Agrupar los tipos de elemento de trabajo en categorías
Trabajar con categorías de tipo de elemento de trabajo
witAdmin: Administrar objetos para el seguimiento de elementos de trabajo