Importar y exportar categorías [witadmin]

  • Artículo

Puede importar y exportar categorías definidas para un proyecto de equipo usando los siguientes comandos witadmin:

  • exportcategories: exporta la definición XML de las categorías definida en un servidor que ejecuta Team Foundation Server.

  • importcategories: importa un archivo de definición XML de tipo de elemento de trabajo en un proyecto de equipo de un servidor que ejecuta Team Foundation Server. 

    Si ya existe una categoría con el mismo nombre, este comando sobrescribe la definición existente. Si aún no existe el tipo de elemento de trabajo, este comando crea una nueva categoría.

Para obtener información sobre las categorías predeterminadas y cómo se usan, vaya aquí.

La herramienta de línea de comandos witadmin solo funciona cuando se ejecuta en una implementación local de TFS. Para ejecutar la herramienta, abra una ventana del símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

cd %programfiles(x86)%\Microsoft Visual Studio 14.0\Common7\IDE

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

Nota

Para crear y modificar categorías puede usar el editor de procesos, una herramienta avanzada de Visual Studio.Esta herramienta avanzada no es compatible.Para más información, vea la siguiente página del sitio web de Microsoft sobre herramientas avanzadas de Team Foundation Server.

Requisitos

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

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

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

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 URI es el siguiente: http://NombreDeServidor:Puerto/NombreDeDirectorioVirtual/NombreDeColección

Si no se usa ningún directorio virtual, el formato del identificador URI será el siguiente:

http://NombreDeServidor:Puerto/NombreDeColección.

/p:Project

El nombre del proyecto de equipo desde el que se exportan las categorías o en el que se importan.

/f:NombreDeArchivo

La ruta de acceso y el nombre del archivo de definición XML que contiene las categorías que se van a exportar o importar. Si omite este parámetro al usar el comando exportcategories, este enumerará las categorías en la ventana de símbolo del sistema.

/e:Codificación

El nombre de un formato de codificación de .NET Framework 2.0. La codificación especificada se usará para exportar o importar los datos XML. Por ejemplo, /e:utf-7 especifica la codificación Unicode (UTF-7). Si se omite este parámetro, witadmin intenta detectar la codificación y, en caso de no poder detectarla, witadmin usa 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, las categorías se crean si aún no existen. Si las categorías ya existen, el comando witadmin importcategories advertirá de que la lista actual se va a sobrescribir. Puede escribir su propio programa para actualizar un conjunto de categorías existente o bien actualizar las categorías usted mismo con nuevos datos.

Importante

Los cambios realizados en las categorías pueden afectar a la configuración del proceso.Vea Configurar y personalizar herramientas de planeación ágiles para un proyecto de equipo.

Para obtener información sobre la estructura del archivo XML de categorías, consulte Referencia de elementos XML de categorías.

Ejemplos

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

  • URI para la colección de proyectos de equipo: http://AdventureWorksServer:8080/tfs/DefaultCollection

  • Nombre de proyecto: AdventureWorks

  • Nombre del archivo de entrada o salida: myCategories.xml

  • Codificación predeterminada: UTF-8

Mostrar categorías

El comando siguiente muestra las categorías de tipo de elemento de trabajo definidas para el proyecto AdventureWorks.

witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks

Agregar una categoría a las categorías Tipos ocultos

Agregue una categoría a las categorías Tipos ocultos para impedir que los usuarios creen tipos de elemento de trabajo en dicha categoría.

  1. Exporte el archivo de definición de categorías del proyecto de equipo.

    witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

  2. Abra el archivo de categorías en el editor de texto que prefiera y busque el elemento CATEGORY para "Hidden Types Category".

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
</CATEGORY>

  3. Agregue un elemento WORKITEMTYPE que especifique el nombre descriptivo del tipo de elemento de trabajo que desea agregar.

    Por ejemplo, la sintaxis siguiente agrega el tipo de elemento de trabajo personalizado “Integración de compilación” a la Categoría Tipos ocultos.

    <CATEGORY name="Hidden Types Category" refname="Microsoft.HiddenCategory">
   <DEFAULTWORKITEMTYPE name="Code Review Request" />
   <WORKITEMTYPE name="Code Review Response" />
   <WORKITEMTYPE name="Feedback Request" />
   <WORKITEMTYPE name="Feedback Response" />
   <WORKITEMTYPE name="Shared Steps" />
   <WORKITEMTYPE name="Integration Build" />
</CATEGORY>

  4. Importe el archivo de definición de categorías en el proyecto de equipo.

    witadmin importcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml

Vea también

Conceptos

Configurar y personalizar herramientas de planeación ágiles para un proyecto de equipo

Otros recursos

Usar categorías para agrupar tipos de elementos de trabajo