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 de Team Web Access (TWA). Algunas herramientas adicionales requieren que asigne los estados de flujo de trabajo con las asignaciones de metaestado.

Para obtener información general acerca de cómo personalizar las páginas de la herramienta de planeación de Agile, vea Configurar y personalizar herramientas de planeación ágiles para un proyecto de equipo.

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 información sobre la configuración del proceso, vea 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.

Para ejecutar la herramienta de la línea de comandos witadmin, abra una ventana de símbolo del sistema donde se haya 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%.

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 de proceso, debe ser miembro de los siguientes grupos de seguridad: Administradores de Team Foundation o Administradores de proyectos.

Para obtener más información, vea 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

Comentarios

Si actualiza un proyecto de equipo actualizado, vea Configurar características después de una actualización de TFS.

Si tiene problemas para acceder a conjuntos de pruebas o planes de pruebas existentes después de actualizar a TFS 2013.3, vea Actualizar un proyecto de equipo manualmente para que admita la administración de pruebas.

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í.

1. Si no tiene permisos administrativos para el proyecto de equipo, obténgalos.

2. 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.

3. 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.

4. 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.

5. Importe el archivo de configuración de proceso.

   witadmin importprocessconfig /collection:CollectionURL /p:ProjectName /f:"DirectoryPath\ProcessConfiguration.xml"
   

6. 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. Esto es compatible con los clientes de Test Manager que están en Visual Studio 2013.2 o versiones anteriores.

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>
      <STATES>
        <STATE value="Design" />
        <STATE value="Testing" />
        <STATE value="Signed Off" />
      </STATES>
      <TRANSITIONS>
        <TRANSITION from="" to="Design">
          <REASONS>
            <DEFAULTREASON value="New test plan" />
          </REASONS>
        </TRANSITION>
     <TRANSITION from="Design" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Authoring complete" />
          </REASONS>
        </TRANSITION>        
     <TRANSITION from="Testing" to="Signed Off">
          <REASONS>
            <DEFAULTREASON value="Signed Off testing" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Design">
          <REASONS>
            <DEFAULTREASON value="Reactivating to authoring phase" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Signed Off" to="Testing">
          <REASONS>
            <DEFAULTREASON value="Reactivating to run tests" />
          </REASONS>
        </TRANSITION>
        <TRANSITION from="Testing" to="Design">
          <REASONS>
            <DEFAULTREASON value="Back to authoring" />
          </REASONS>
        </TRANSITION>
      </TRANSITIONS>
    </WORKFLOW>

<TestPlanWorkItems category="Microsoft.TestPlanCategory" pluralName="Test Plans" singularName="Test Plan">
    <States>
      <State type="InProgress" value="Design" />
      <State type="InProgress" value="Testing" />
      <State type="Complete" value="Signed Off" />
    </States>
  </TestPlanWorkItems>
<TestSuiteWorkItems category="Microsoft.TestSuiteCategory" pluralName="Test Suites" singularName="Test Suite">
    <States>
      <State type="Proposed" value="In Planning" />
      <State type="InProgress" value="In Progress" />
      <State type="Complete" value="Completed" />
    </States>
  </TestSuiteWorkItems>

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. Vea 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 de adición rápida. 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 obtener más información sobre qué personalizaciones puede llevar a cabo de forma segura y qué 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 o se quitan estados de flujo de trabajo a los WIT siguientes, 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.

  Los WIT de planes de pruebas y conjuntos de pruebas únicamente están disponibles con la actualización a TFS 2013.3, disponible desde esta página de descargas.

  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 y 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.

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, vea 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, como se describe en 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 ver cómo hacerlo, lea Agregar errores al trabajo pendiente o al panel de tareas.