Personalizar las categorías de 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.

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 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: Herramientas avanzadas de Team Foundation Server.

Requisitos

Para el proyecto de equipo para el que se definen las categorías, debe tener los siguientes permisos establecidos:

• Para exportar categorías de tipos de elementos de trabajo, el permiso Ver información del nivel de proyecto debe estar establecido en Permitir.

• Para importar categorías de tipos de elementos de trabajo, debe ser miembro del grupo de seguridad Project Administrators o tener el permiso Editar información de nivel de proyecto establecido en Permitir.

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, elija Inicio, abra el menú contextual para Símbolo del sistema y elija 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 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.

Importante
Los cambios realizados a las categorías pueden afectar a la configuración del proceso.Vea Personalizar las páginas de panel y de trabajo pendiente mediante la configuración del proceso.

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/tfs/DefaultCollection

• 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/tfs/DefaultCollection /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/tfs/DefaultCollection /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/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml 

Vea también

Conceptos

Personalizar las páginas de panel y de trabajo pendiente mediante la configuración del proceso

Otros recursos

Definir categorías para agrupar los tipos de elementos de trabajo

Referencia de elementos de categorías de tipos de elementos de trabajo

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