Importar y exportar categorías

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

Importante

Para el modelo de proceso XML local, puede usar witadmin para enumerar, importar, exportar y modificar un proceso para un proyecto. En el caso de los modelos de proceso XML heredados y hospedados, solo puede usar witadmin para enumerar y exportar la información del proceso. Para obtener información general sobre los modelos de proceso y lo que se admite, consulte Personalización de la experiencia de seguimiento del trabajo.

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

  • exportcategories: exporta la definición XML de categorías definidas para un proyecto.
  • importcategories: importa un archivo de definición XML de tipo de elemento de trabajo en un proyecto. 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, vea Usar categorías para agrupar tipos de elementos de trabajo.

Ejecución de la herramienta de línea de comandos witadmin

Para ejecutar la herramienta de línea de comandos witadmin , abra una ventana del símbolo del sistema donde está instalado Visual Studio. La herramienta de línea de comandos witadmin se instala con cualquier versión de Visual Studio. Puede acceder a esta herramienta instalando la versión gratuita de Visual Studio Community o Visual Studio Team Explorer.

Nota

Si se conecta a un servidor local, debe usar la misma versión o posterior de Visual Studio o Team Explorer que Azure DevOps Server. Por ejemplo, si se conecta a una instancia de TFS 2017, debe conectarse desde Visual Studio 2017 o Team Explorer 2017. No hay ninguna versión de Team Explorer 2015.

Cliente de Visual Studio 2019 o Team Explorer 2019:

%programfiles(x86)%\Microsoft Visual Studio\2019\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

o , TeamExplorerProfessional o Enterprise en lugar de Community, según la versión que haya instalado.

Cliente de Visual Studio 2017 o Team Explorer 2017:

%programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

o , TeamExplorerProfessional o Enterprise en lugar de Community, según la versión que haya instalado.

En una edición de 32 bits de Windows, reemplace %programfiles(x86)% por%programfiles%. Puede instalar Visual Studio Community (que proporciona acceso a Team Explorer) o Visual Studio Team Explorer 2017 de forma gratuita.

Sugerencia

Con witadmin, puede importar y exportar archivos de definición. Otras herramientas que puede usar incluyen el Editor de procesos (requiere que haya instalado una versión de Visual Studio). Instale el editor de plantillas de proceso desde Visual Studio Marketplace.

O bien, puede usar el Administrador de proyectos de equipo de TFS, un cliente de código abierto disponible en GitHub.

Sugerencia

Con witadmin, puede importar y exportar archivos de definición. Otras herramientas que puede usar incluyen el Editor de procesos (requiere que haya instalado una versión de Visual Studio). Instale el editor de plantillas de proceso de TFS desde Visual Studio Marketplace. Puede usar esta versión del Editor de procesos para modificar los formularios de elementos de trabajo de estilo antiguo. No se puede usar para editar formularios asociados a los nuevos formularios web.

O bien, puede usar el Administrador de proyectos de equipo de TFS, un cliente de código abierto disponible en GitHub.

Requisitos previos

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

  • Para exportar categorías de tipos de elementos de trabajo, debe tener establecido el permiso Ver información de nivel de proyecto en Permitir.
  • Para importar categorías de tipos de elementos 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.

Para obtener más información, consulte Cambio de permisos de nivel de colección de proyectos.

Sintaxis

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. Por ejemplo:

Formato DE TFS local: http://ServerName:Port/VirtualDirectoryName/CollectionName

Si no se usa ningún directorio virtual, el formato del URI es el siguiente: http://ServerName:Port/CollectionName.
/p:Project Nombre del proyecto desde el que se exportan las categorías o a las que se importan las categorías.
/f:FileName 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 , el comando enumera las categorías en la ventana del símbolo del sistema.
/e:Encoding 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 omite este parámetro, witadmin intenta detectar la codificación y, si se produce un error en la detección, witadmin usa UTF-8.
/? o ayuda Muestra ayuda sobre el comando en la ventana del símbolo del sistema.

Observaciones

Al importar un archivo de categorías, las categorías se crean si aún no existen. Si ya existen categorías, el comando witadmin importcategories le avisará de que se sobrescribirá la lista actual. 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. Consulte Elementos XML ProcessConfiguration.

Para obtener información sobre la estructura de archivos XML de categorías, vea Categories XML element reference.

Ejemplos

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

  • URI de la colección de proyectos: 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 para las categorías del proyecto.

    witadmin exportcategories /collection:http://AdventureWorksServer:8080/tfs/DefaultCollection /p:AdventureWorks /f:myCategories.xml   
    
  2. Abra el archivo Categories en el editor de texto que prefiera y busque el CATEGORY elemento 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 WORKITEMTYPE elemento 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 para las categorías en el proyecto.

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