Importar y exportar la configuración del proceso [witadmin]
Puede personalizar la configuración del proceso para modificar la visualización de páginas de la herramienta de planeación de Agile que se ven a través del portal web de Team Foundation Server (TFS). Algunas herramientas adicionales requieren que asigne los estados de flujo de trabajo con las asignaciones de metaestado.
Para obtener información general sobre cómo personalizar las páginas de la herramienta de planeación de Agile, consulte este artículo sobre cómo Configurar y personalizar herramientas de planeación ágiles para un proyecto de equipo.
Nota
Si recibe el mensaje de error TF400917, significa que una configuración no es válida.Vuelva a importar el archivo de configuración del proceso al proyecto de equipo mediante witadmin importprocessconfig.Obtendrá los mensajes necesarios para resolver el error.
Para administrar la configuración del proceso de un proyecto de equipo, use la herramienta de línea de comandos witadmin para exportar e importar el archivo de definición XML de la configuración del proceso. Para obtener más información sobre la configuración del proceso, consulte Referencia de elemento XML de la configuración del proceso.
exportprocessconfig: exporta la definición de la configuración del proceso a un archivo XML o a la ventana de símbolo del sistema.
importprocessconfig: importa la definición de la configuración del proceso a un archivo XML.
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%.
Requisitos
Para exportar las definiciones de configuración de proceso, debe ser un usuario válido del proyecto de equipo o de la colección.
Para importar definiciones de configuración del proceso, debe ser miembro de los grupos de seguridad siguientes: Administradores de Team Foundation o Administradores de proyectos.
Para obtener más información, consulte Referencia de permisos para Team Foundation Server.
witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName [/f:FileName] [/e:encoding]
witadmin importprocessconfig /collection:CollectionURL [/p:ProjectName] /f:FileName [/e:encoding] [/v]
Parámetros
Parámetro |
Descripción |
---|---|
/collection:CollectionURLx |
Requerido. Especifica la dirección URL de una colección. Especifique el URI con el formato siguiente: http://NombreDeServidor:Puerto/NombreDeDirectorioVirtual/NombreDeColección Si no especifica un directorio virtual, especifique el URI con el siguiente formato: http://NombreDeServidor:Puerto/NombreDeColección. |
/p:ProjectName |
Requerido. Especifica el proyecto de equipo para el que quiere exportar o importar la configuración del proceso. Este proyecto de equipo se debe definir en la colección especificada por el parámetro /collection. No es necesario especificar un proyecto de equipo cuando se especifica el modificador /v. |
/f:FileName |
La ruta y el nombre del archivo de definición XML de la configuración de proceso que se exportará o importará. Nota Si el equipo cliente está ejecutando Windows Vista, puede que no tenga permisos para determinadas carpetas.Si intenta exportar la lista global a una ubicación para la que no tiene permisos, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual.Para obtener más información, consulte las páginas siguientes del sitio web de Microsoft: Virtualización del registro y Problemas de virtualización del registro y archivos comunes en Windows Vista.Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos. |
/e:Encoding |
Opcional. 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 omite este parámetro, witadmin intenta detectar la codificación y utiliza UTF-8 si se produce un error en la detección. |
/v |
Opcional. Valida el código XML que define la configuración del proceso, pero no importa el archivo de definición. |
/? o help |
Muestra ayuda sobre el comando en la ventana del símbolo del sistema. |
Comentarios
Si instala la versión más reciente de TFS se actualizarán los proyectos de equipo existentes. Para actualizar un proyecto de equipo que a su vez se ha actualizado, consulte Configurar características después de una actualización de TFS.
Si tiene problemas para acceder a conjuntos o planes de pruebas existentes tras una actualización, consulte Update a team project manually to support test management.
Ejemplos
En cada ejemplo se aplican los valores siguientes:
Dirección URL de la colección: http://AdventureWorksServer:8080/tfs/ColecciónPredeterminada
Proyecto de equipo: Contoso
Número de puerto del sitio web del servidor: 8080
Agregar un campo al panel de adición rápida
Puede agregar campos para cualquier panel de adición rápida. Por ejemplo, en el ejemplo siguiente se agrega Valor empresarial al panel de trabajo pendiente del producto.
El panel solo muestra los campos incluidos en la sección FIELDS de la definición de WIT para el WIT seleccionado. Por ejemplo, si selecciona el WIT de error, solo se muestra el título, puesto que Valor empresarial no se ha definido para los errores. Para agregar otro WIT al panel, agréguelo a la categoría de requisito como se describe aquí.
Si no tiene permisos administrativos para el proyecto de equipo, obténgalos.
Abra una ventana de símbolo del sistema donde esté instalado Visual Studio o Team Explorer y escriba:
cd %programfiles(x86)%\Microsoft Visual Studio 12.0\Common7\IDE
En una edición de 32 bits de Windows, reemplace %programfiles(x86)% por %programfiles%. Puede descargar Team Explorer gratis.
Exporte el archivo de configuración de proceso.
witadmin exportprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
Un ejemplo de DirecciónURLdeColección es http://MiServidor:8080/tfs/NombreDeColecciónDeProyectoDeEquipo.
Agregue el nombre de referencia de campo a la sección AddPanel.
Por ejemplo, la siguiente sintaxis agrega el elemento Prioridad al panel.
<AddPanel> <Fields> <Field refname="System.Title" /> <Field refname="Microsoft.VSTS.Common.BusinessValue" /> </Fields> </AddPanel>
Sugerencias:
Puede buscar el nombre de referencia de un campo mediante este índice.
Agregue todos los campos obligatorios para los tipos de elemento de trabajo definidos para la categoría de requisitos. De esta forma, se evita abrir el formulario de elemento de trabajo para rellenarlo cuando se agregan elementos de trabajo pendiente a través del panel.
Importe el archivo de configuración de proceso.
witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
Actualice la página de trabajo pendiente para ver el panel actualizado.
Actualizar asignaciones de metaestado para la compatibilidad con Test Manager
Si personaliza la sección WORKFLOW del plan de pruebas o el conjunto de pruebas, debe asignar los estados con metaestados.
En el ejemplo siguiente, el flujo de trabajo del plan de pruebas ha sido actualizado para utilizar los estados de Diseño, Prueba y Aprobado. Para la compatibilidad con versiones anteriores, se agrega TestPlanWorkItems a la sección ProjectProcessConfiguration de la definición de configuración del proceso.
WORKFLOW |
Asignaciones de metaestados |
---|---|
|
|
Si modifica el flujo de trabajo del conjunto de pruebas, tendrá que hacer una actualización similar si desea asignar estados nuevos. Se agregaría dentro de una sección TestSuiteWorkItems. Consulte Referencia de elemento XML de la configuración del proceso.
Preguntas y respuestas
P: ¿Qué personalizaciones puedo realizar que sigan utilizando el asistente para Configurar características con el fin de actualizar mi proyecto de equipo tras una actualización de TFS?
R: Puede personalizar el panel para agregar rápidamente. El asistente para Configurar características actualizará sus proyectos de equipo, y obtendrá acceso a las últimas características.
Algunos cambios pueden requerir algunas operaciones manuales a la hora de actualizar su proyecto de equipo. Para información sobre qué personalizaciones puede realizar con seguridad y cuáles debe evitar, vea Personalizar la experiencia de seguimiento del trabajo: Antes de realizar la personalización, debe entender las implicaciones de esta en el mantenimiento y la actualización.
P: ¿Cuándo es necesario asignar estados de flujo de trabajo a metaestados?
R: Cuando se agregan estados de flujo de trabajo a los WIT siguientes o se quitan de estos, debe considerarse la posibilidad de actualizar la configuración del proceso para agregar o quitar las asignaciones de metaestado correspondientes.
WIT que pertenecen a la categoría de requisitos o la categoría de tareas: asignaciones de metaestado compatibles con la visualización de herramientas de planeación de Agile.
WIT que pertenecen a la categoría de errores: asignaciones de metaestado para la compatibilidad con la herramienta Mi trabajo (proyectos de equipo basados en CMMI y Agile).
Planes de pruebas y conjuntos de pruebas: las actualizaciones al flujo de trabajo de estos WIT únicamente deben asignarse para la compatibilidad con miembros de equipo conectados a TFS desde una versión de Test Manager basada en Visual Studio 2013.2 o una versión anterior.
Actualice las asignaciones de metaestado si recibe un error de tipo La aplicación detectó un error inesperado al conectarse con el proyecto de equipo.
¿Cómo se resuelven los errores de configuración del proceso?
R: Al realizar uno de los cambios siguientes en un proyecto de equipo, necesitará actualizar las definiciones de los WIT, las categorías o la configuración del proceso. Para evitar errores, realice siempre sus cambios en el orden siguiente: (1) WIT, (2) categorías y (3) configuración del proceso.
Personalización |
Actualice o verifique la definición de WIT |
Actualice o verifique la definición del proceso de configuración |
---|---|---|
Agregar un WIT a la categoría de requisitos (Un WIT puede pertenecer a la categoría de requisitos o a la categoría de tareas, pero no a ambas). |
Para incluir los campos siguientes:
|
Para contener las asignaciones de metaestado necesarias:
Para contener una entrada para definir los códigos de color asociados con el WIT. Por ejemplo: <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="Product Backlog Item" /> |
Cambiar el flujo de trabajo de un WIT en la categoría de requisitos |
N/D |
Para contener asignaciones de metaestado necesarias según se ha descrito anteriormente para agregar un WIT a la categoría de requisitos. |
Agregar un WIT a la categoría de tareas |
Para incluir los campos siguientes:
|
Para contener las asignaciones de metaestado necesarias:
Para contener una entrada para definir los códigos de color asociados con el WIT. Por ejemplo: <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" /> |
Cambiar el flujo de trabajo de un WIT en la categoría de tareas |
N/D |
Para contener asignaciones de metaestado necesarias según se ha descrito anteriormente para agregar un WIT a la categoría de tareas. |
Agregar un WIT a la categoría de errores (únicamente Agile y CMMI) Cambiar el flujo de trabajo de un WIT en la categoría de errores (únicamente Agile y CMMI) |
N/D |
Para contener las asignaciones de metaestado necesarias:
Para obtener más información, consulte Admitir el estado de actualización de errores mediante Mi trabajo. |
Quitar un WIT de la categoría de requisitos o la categoría de tareas |
N/D |
Para quitar cualquier asignación de metaestado que únicamente esté asociada con el WIT |
Quitar un WIT de un proyecto de equipo |
Para quitar el WIT del archivo de categorías. |
Para quitar las asignaciones de metaestado que únicamente estén asociadas con el WIT que ha quitado y el elemento WorkItemColor que define los códigos de color para el WIT que ha quitado. |
P: ¿Cómo se personalizan otras funciones que aparecen en las herramientas de planeación de Agile en TWA?
R: Se pueden realizar algunas personalizaciones a través de la interfaz de usuario. Otras requieren la modificación de la configuración del proceso u otros objetos de proyectos de equipo. Para obtener información general, consulte este artículo sobre cómo Configurar y personalizar herramientas de planeación ágiles para un proyecto de equipo.
P: ¿Desea trabajar con dos o más trabajos pendientes de cartera?
R: La experiencia predeterminada admite un nivel de trabajo pendiente de cartera. Puede agregar hasta cinco niveles, tal como se describe en este artículo sobre cómo Agregar un registro de trabajo pendiente a Administración de carteras Agile.
P: ¿Desea agregar o cambiar los WIT que aparecen en el panel de tareas o en el trabajo pendiente del producto?
R: Si ha agregado un WIT personalizado y desea agregarlo al trabajo pendiente o al panel de tareas, puede hacerlo. No puede aparecer en ambos lugares. Para obtener más información, consulte Agregar tipos de elemento de trabajo a trabajos pendientes y paneles.