Importar y exportar categorías [witadmin]
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.
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
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>
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>
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