Compartir a través de

Personalizar categorías para tipos de elemento de trabajo

  • Artículo

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