Importar y exportar la configuración del proceso

Azure DevOps Services | Azure DevOps Server 2020 | 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 personalizar la configuración del proceso para modificar la presentación de las herramientas ágiles del portal web. Algunas herramientas adicionales requieren que asigne los estados de flujo de trabajo con las asignaciones de metaestado.

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 mediante witadmin importprocessconfig. Obtendrá los mensajes que necesita para resolver el error.

Para administrar la configuración del proceso de un proyecto, use la herramienta de línea de comandos witadmin para exportar e importar el archivo de definición XML de configuración del proceso. Para obtener información sobre la configuración del proceso, consulte ProcessConfiguration.

  • exportprocessconfig: exporta la definición de configuración del proceso a un archivo XML o a la ventana del símbolo del sistema.
  • importprocessconfig: importa el archivo XML de definición de configuración del proceso.

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 en la que 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.

Visual Studio cliente de 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.

Visual Studio cliente de 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 tfS Team Project Manager, 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 tfS Team Project Manager, un cliente de código abierto disponible en GitHub.

Requisitos previos

  • Para exportar definiciones de configuración de procesos, debe ser un usuario válido del proyecto o colección.
  • Para importar definiciones de configuración de procesos, debe ser miembro de los siguientes grupos de seguridad: Administradores de Team Foundation o administradores de Project.

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

Sintaxis

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

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:ProjectName

Necesario. Especifica el proyecto para el que desea exportar o importar la configuración del proceso. Este proyecto debe definirse en la colección que especificó mediante el parámetro /collection. No es necesario especificar un proyecto al especificar el /v modificador.

/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 ejecuta Windows Vista, es posible 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 la página Virtualización del Registro en el sitio web de Microsoft. Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos.

/e:Encoding

Opcional. Nombre de un formato de codificación .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 usa 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 ayuda

Muestra ayuda sobre el comando en la ventana del símbolo del sistema.

Observaciones

La instalación de la versión más reciente de TFS actualiza los proyectos existentes. Si va a actualizar un proyecto actualizado, consulte Configuración de características después de una actualización.

Si tiene problemas para acceder a los planes de prueba o conjuntos de pruebas existentes después de una actualización, consulte Actualizaciones manuales para admitir 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/DefaultCollection
  • Project: 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.

Backlog panel with Business Value field added

El panel solo muestra los campos que se incluyen en la sección de la FIELDS definición de WIT para el WIT seleccionado. Por ejemplo, si selecciona el error WIT, solo se muestra Título, ya que El valor empresarial no está definido para los errores. Para agregar otro WIT al panel, agréguelo a la Categoría de requisitos. Vea Agregar un tipo de elemento de trabajo a un trabajo pendiente y un panel.

  1. Si no tiene permisos administrativos para el proyecto, hágalos.

  2. Abra una ventana del símbolo del sistema según las instrucciones proporcionadas en Cómo ejecutar la herramienta de línea de comandos witadmin. Por ejemplo:

    cd %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer
    
  3. Exporte el archivo de configuración de proceso.

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

    Un ejemplo de collectionURL es http://MyServer:8080/tfs/TeamProjectCollectionName.

  4. Agregue el nombre de referencia de campo a la AddPanel sección.

    Por ejemplo, la sintaxis siguiente agrega el elemento Priority al panel.

    <AddPanel>  
       <Fields>  
          <Field refname="System.Title" />  
          <Field refname="Microsoft.VSTS.Common.BusinessValue" />  
       </Fields>  
    </AddPanel>  
    

    Sugerencia

    • 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 WORKFLOW sección del plan de pruebas o del conjunto de pruebas, debe asignar los estados a los metastates.

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 admitir la compatibilidad con versiones anteriores, TestPlanWorkItems se agrega a la ProjectProcessConfiguration sección de la definición de configuración del proceso.

Flujo de trabajo

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

Asignaciones de metaestados

<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. Lo agregaría dentro de una TestSuiteWorkItems sección. Consulte ProcessConfiguration.

Preguntas y respuestas

P: ¿Qué personalizaciones puedo realizar y seguir usando el Asistente para configurar características para actualizar mi proyecto después de una actualización de TFS?

Un: Puede personalizar el panel de adición rápida. El Asistente para configurar características actualizará los proyectos y obtendrá acceso a las características más recientes.

Otros cambios pueden requerir que realice algunas operaciones manuales al actualizar el proyecto. Para obtener información sobre qué personalizaciones puede realizar de forma segura y cuáles debe evitar, consulte Personalización de la experiencia de seguimiento del trabajo: Antes de personalizar, comprenda las implicaciones de mantenimiento y actualización.

P: ¿Cuándo es necesario asignar estados de flujo de trabajo a metaestados?

Un: Al agregar o quitar estados de flujo de trabajo a los siguientes tipos de elementos de trabajo, debe considerar la posibilidad de actualizar la configuración del proceso para agregar o quitar las asignaciones de metastate correspondientes.

  • Tipos de elementos de trabajo que pertenecen a la categoría de requisito o categoría de tarea: las asignaciones de metastate admiten la presentación de las herramientas de planeamiento de Agile.

  • Tipos de elementos de trabajo que pertenecen a la categoría de errores: asignaciones de metastate para admitir la herramienta My Work (proyectos basados en Agile y CMMI).

  • Plan de prueba y Conjunto de pruebas: las actualizaciones del flujo de trabajo de estos tipos de elementos de trabajo solo se deben asignar cuando se admite que los miembros del equipo se conecten a Azure DevOps desde una versión de Test Manager basada en Visual Studio 2013.2 o una versión anterior.

    Actualice las asignaciones de metastate si recibe una aplicación detectó un error de error inesperado al conectarse al proyecto.

    Application fault error message after TFS upgrade

¿Cómo se resuelven los errores de configuración del proceso?

Un: Al realizar uno de los siguientes cambios en un proyecto, deberá actualizar las definiciones del tipo de elemento de trabajo, las categorías o la configuración del proceso. Para evitar errores, realice siempre los cambios en este orden: (1) tipos de elementos de trabajo, (2) categorías y (3) configuración del proceso.

Personalización

Actualizar o comprobar la definición del tipo de elemento de trabajo

Actualice o verifique la definición del proceso de configuración

Agregar un tipo de elemento de trabajo a la categoría requisitos

(Un tipo de elemento de trabajo puede pertenecer a la categoría de requisitos o a la categoría de tareas, pero no a ambas).

Para incluir los campos siguientes:

  • Prioridad de trabajo pendiente (Scrum) o Rango en la pila (Agile o CMMI)

    (debe coincidir con el valor de campo asignado a type=Order en el archivo de configuración del proceso)
  • Esfuerzo (Agile), Puntos de caso (Scrum) o Tamaño (CMMI)

    (debe coincidir con el valor de campo asignado a type=Effort en el archivo de configuración del proceso)
  • Ruta de acceso del área o el valor de campo asignado a type=Team en el archivo de configuración del proceso

  • Todos los campos que se incluyen en la AddPanel sección del archivo de configuración del proceso (los campos deben definirse dentro de la FIELDS sección, pero no tienen que incluirse en la FORM sección.

Para contener las asignaciones de metaestado necesarias:

  • Asigne el inicio de cada estado de flujo de trabajo a type="Proposed"
  • Asigne cada estado de flujo de trabajo intermedio que aparezca en el panel de Kanban a type="InProgress"
  • Asigne el final de cada estado de flujo de trabajo a type="Complete"
    Únicamente puede tener un estado asignado a type="Complete"

    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 tipo de elemento de trabajo en la categoría requisitos

N/D

Para contener las asignaciones de metastate necesarias como se describió anteriormente para agregar un tipo de elemento de trabajo a la categoría Requisitos.

Agregar un tipo de elemento de trabajo a la categoría de tarea

Para incluir los campos siguientes:

  • Prioridad de trabajo pendiente (Scrum) o Rango en la pila (Agile o CMMI)
  • Actividad (Scrum o Agile) o Materia (CMMI)
    (debe coincidir con el valor de campo asignado a type=Activity en el archivo de configuración del proceso)
  • Trabajo restante
    (debe coincidir con el valor de campo asignado a type=RemainingWork en el archivo de configuración del proceso)
  • Ruta de acceso del área o el valor de campo asignado a type=Team en el archivo de configuración del proceso
  • (Opcional) Trabajo original y Trabajo completado (únicamente Agile y CMMI)

Para contener las asignaciones de metaestado necesarias:

  • Asignar el inicio de cada estado de flujo de trabajo a type="Propuesto"
  • Asigne cada estado de flujo de trabajo intermedio que quiera que aparezca en el panel de tareas a type="InProgress"
  • Asigne el final de cada estado de flujo de trabajo a type="Complete"

    Únicamente puede tener un estado asignado a type="Complete"

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 tipo de elemento de trabajo en la categoría de tarea

N/D

Para contener las asignaciones de metastate necesarias como se describió anteriormente para agregar un tipo de elemento de trabajo a la categoría de tarea.

Agregar un tipo de elemento de trabajo a la categoría de errores (solo Agile y CMMI)

Cambiar el flujo de trabajo de un tipo de elemento de trabajo en la categoría de errores (solo Agile y CMMI)

N/D

Para contener las asignaciones de metaestado necesarias:

  • Asigne el inicio de cada estado de flujo de trabajo a type="Proposed"
  • Asigne cada estado de flujo de trabajo intermedio que aparezca para Mi trabajo a type="InProgress"
  • Asignar el final de cada tipo de estado de flujo de trabajo="Complete"

Únicamente puede tener un estado asignado a type="Complete"

Para más información, consulte Compatibilidad con el estado de actualización de errores mediante Mi trabajo.

Quitar un tipo de elemento de trabajo de la categoría de requisitos o categoría de tarea

N/D

Para quitar las asignaciones de metastate que solo están asociadas a ese tipo de elemento de trabajo

Quitar un tipo de elemento de trabajo de un proyecto

Para quitar el tipo de elemento de trabajo del archivo de categorías.

Para quitar las asignaciones de metastate que solo están asociadas con el tipo de elemento de trabajo que ha quitado y el WorkItemColor elemento que define los códigos de color para el tipo de elemento de trabajo que ha quitado.

P: ¿Desea trabajar con dos o más trabajos pendientes de cartera?

Un: La experiencia predeterminada admite un nivel de trabajo pendiente de cartera. Puede agregar hasta cinco niveles, como se describe en Incorporación de trabajos pendientes de cartera a herramientas de Agile.

P: ¿Desea agregar o cambiar los tipos de elementos de trabajo que aparecen en el panel de tareas o el trabajo pendiente del producto?

Un: Si ha agregado un tipo de elemento de trabajo personalizado y desea agregarlo al trabajo pendiente o al panel de tareas, puede hacerlo. No puedes hacer que aparezcan en ambos lugares. Obtenga información sobre cómo leer Agregar tipos de elementos de trabajo a trabajos pendientes y paneles.