Actualizar una plantilla de proceso personalizada para obtener acceso a nuevas características

Artículo
06/09/2015

Si el asistente para Configurar características no puede actualizar su proyecto de equipo, se debe a que su proyecto de equipo se creó a partir de una plantilla de proceso distinta a las proporcionadas por TFS o a que ha personalizado su proyecto de equipo, de tal forma que el asistente no puede aplicar las actualizaciones. En cualquiera de estos casos, tiene estas opciones para actualizar sus proyectos de equipo existentes:

Opción A: agregar características a su plantilla de proceso personalizada y ejecutar el asistente para Configurar características.

Lleve a cabo los pasos: , , y

Elija esta opción cuando haya realizado numerosas personalizaciones en la plantilla de proceso.
Opción B: aplicar sus personalizaciones a la plantilla de proceso más reciente y ejecutar a continuación el asistente para Configurar características.

LLeve a cabo los pasos: , , y .

Elija esta opción cuando haya realizado muy pocas personalizaciones en la plantilla de proceso.
Opción C: actualizar manualmente su proyecto de equipo para agregar características

Elija esta opción cuando haya realizado personalizaciones en el proyecto de equipo que no estén presentes en ninguna de sus plantillas de proceso.
Opción D: actualizar varios proyectos de equipo mediante programación. Primero, elija la Opción A o la Opción B para actualizar la plantilla de proceso personalizada. Luego, realice una actualización por lotes de todos los proyectos de equipo de una colección mediante los siguientes recursos e información sobre cómo configurar características para numerosos proyectos de equipo y la solución de CodePlex basada en Features4tfs.

Elija esta opción cuando tenga numerosos proyectos de equipo creados a partir de la misma plantilla de proceso.

Para obtener más información sobre las adiciones realizadas en las plantillas de proceso predeterminadas más recientes, consulte Cambios de configuración realizados para agregar nuevas características.

1.Descargar la plantilla de proceso más reciente

Paso 1 Los archivos de la carpeta de la última versión de la plantilla de proceso que descargue se copiarán o se agregarán a la carpeta correspondiente que contenga las definiciones de plantilla de procesos personalizadas.

Si va a actualizar una plantilla de proceso basada en una versión anterior a MSF 6.0 o Visual Studio Scrum 2.0, aplique primero las actualizaciones proporcionadas en la versión de 2012 de este tema.

Puede comprobar el archivo ProcessTemplate.xml para obtener información de versión.
Si no ha actualizado el servidor de capa de aplicación a la versión de TFS que contenga las características que desea, hágalo ahora. Obtenga la descarga y Actualizar Team Foundation Server.
Si no es miembro del grupo Administradores de la colección de proyectos, use la opción para agregarse a este. Debe establecer el permiso Administrar plantillas de proceso como Permitir para descargar y administrar las plantillas de proceso.
Una vez que se haya actualizado TFS, descargue la plantilla de proceso más reciente desde TFS y elija la plantilla de proceso que más se parezca a la usada para crear su proyecto de equipo.

Consulte Descargar la versión más reciente de las plantillas de proceso.

Para descargar o cargar plantillas de proceso, debe conectarse a TFS 2013 desde Visual Studio 2013 o Team Explorer 2013.
Copie la plantilla de proceso a una nueva carpeta en la que aplicará sus personalizaciones (Opción B) o copie las definiciones XML para agregar nuevas características a su plantilla de proceso existente (Opción C).

2.Agregar características a la plantilla de proceso personalizada (Opción A)

Paso 2 Actualice su plantilla de proceso personalizada agregando los siguientes tipos de elementos de trabajo (WIT):

Característica admite la administración de trabajos pendientes de cartera.
Parámetro compartido admite la repetición de pruebas con datos diferentes.
Plan de pruebas y conjunto de pruebas admite la personalización de estos artefactos y permite realizar consultas en estos WIT. Se introdujeron cambios adicionales, tal y como se describe en los dos temas siguientes: Nuevas características habilitadas para Team Web Access y Planear pruebas manuales.

Copie o agregue archivos de la carpeta de la última versión de la plantilla de proceso que descargue a la carpeta correspondiente que contenga las definiciones de plantilla de proceso personalizadas.

Agregar Característica y compatibilidad de trabajos pendientes de cartera (se requiere TFS 2013)

Copie el archivo Feature.xml de la carpeta WorkItem Tracking/TypeDefinitions en la carpeta correspondiente de la plantilla de proceso personalizada.

Agregue Feature Category al archivo Categories ubicado en la carpeta WorkItem Tracking.

<CATEGORY name="Feature Category" refname="Microsoft.FeatureCategory">
    <DEFAULTWORKITEMTYPE name="Feature" />
  </CATEGORY>

Abra el archivo del complemento WorkItems ubicado en la carpeta WorkItem Tracking.

Agregue una tarea para cargar la característica de tipo de elemento de trabajo a la sección <WORKITEMTYPES>.
```
<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\Feature.xml" />
```

Reemplace ambas tareas de configuración de procesos dentro del elemento PROCESSCONFIGURATION…

<PROCESSCONFIGURATION>
   <CommonConfiguration fileName="WorkItem Tracking\Process\CommonConfiguration.xml"/>
   <AgileConfiguration fileName="WorkItem Tracking\Process\AgileConfiguration.xml"/>
</PROCESSCONFIGURATION>

.. por la instrucción de elemento único que hace referencia al archivo ProcessConfiguration.

<PROCESSCONFIGURATION>
   <ProjectConfiguration fileName="WorkItem Tracking\Process\ProcessConfiguration.xml"/>
</PROCESSCONFIGURATION>

Copie el archivo ProcessConfiguration de la carpeta WorkItem Tracking/Process de la plantilla de proceso descargada en la carpeta de plantilla personalizada en la misma ubicación.

Incluya en ProcessConfiguration cualquier personalización que haya realizado en los archivos AgileConfiguration o CommonConfiguration. Para obtener más información, vea el artículo sobre referencia XML de configuración de procesos.
Elimine los archivos AgileConfiguration y CommonConfiguration de la carpeta WorkItem Tracking/Process.

Ahora, la configuración de proceso se admite mediante el archivo único ProcessConfiguration.
Reemplace los archivos Backlog/Stories/Requirement Overview.rdl y Stories/Requirements Progress.rdl de la carpeta Reports en la carpeta de plantilla personalizada por los archivos de la plantilla de proceso descargada en la misma ubicación.

Estas actualizaciones reflejan los cambios necesarios con la incorporación del tipo de elemento de trabajo pendiente de cartera de característica, tal como se describe en esta entrada de blog para actualizar los informes de progreso e información general para admitir trabajos pendientes de cartera.
Reemplace la carpeta Process Guidance, ubicada bajo la carpeta Windows SharePoint Services, por el contenido de la última carpeta.

Estos archivos proporcionan vínculos al contenido más reciente de la guía de procesos.

Agregar compatibilidad con Parámetros compartidos (se requiere TFS 2013.2)

Copie el archivo SharedParameter.xml de la carpeta WorkItem Tracking/TypeDefinitions en la carpeta correspondiente de la plantilla de proceso personalizada.

Agregue Shared Parameter Category al archivo Categories ubicado en la carpeta WorkItem Tracking.

<CATEGORY name="Shared Parameter Category" refname="Microsoft.SharedParameterCategory">
    <DEFAULTWORKITEMTYPE name="Shared Parameter" />
  </CATEGORY>

Agregue Shared Parameter a Hidden Types Categories.

<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="Shared Parameter" />  </CATEGORY>

Abra el archivo del complemento WorkItems ubicado en la carpeta WorkItem Tracking.
Agregue una tarea para cargar el WIT Parámetro compartido a la sección <WORKITEMTYPES>.
```
<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\SharedParameter.xml" />
```

Agregar tipos de elementos de trabajo de planes de pruebas y conjuntos de pruebas (se requiere TFS 2013.3)

Al actualizar el servidor de la capa de aplicación a TFS 2013.3, el asistente para actualización de TFS actualiza automáticamente los proyectos de equipo existentes para admitir nuevos objetos de seguimiento de elementos de trabajo para planes de pruebas y conjuntos de pruebas.

Los cambios se realizan en el proyecto de equipo, pero no en las plantillas de proceso personalizadas existentes. Sin embargo, puede actualizar manualmente las plantillas de proceso personalizadas. Entre las razones para hacerlo, se incluyen la compatibilidad con futuras actualizaciones de TFS que requieren el uso del asistente para Configurar características, o bien si planea la creación de proyectos de equipo con la plantilla de proceso personalizada en el servidor actualizado. Debe agregar estos objetos manualmente a las plantillas de proceso personalizadas.

Copie los archivos TestPlan.xml y TestSuite.xml de la carpeta WorkItem Tracking/TypeDefinitions a la carpeta correspondiente de la plantilla de proceso personalizada.

Agregue Test Plan Category y Test Suite Category al archivo Categories ubicado en la carpeta WorkItem Tracking.

<CATEGORY name="Test Plan Category" refname="Microsoft.TestPlanCategory">
    <DEFAULTWORKITEMTYPE name="Test Plan" />
  </CATEGORY>
  <CATEGORY name="Test Suite Category" refname="Microsoft.TestSuiteCategory">
    <DEFAULTWORKITEMTYPE name="Test Suite" />
  </CATEGORY>

Agregue Test Plan Category y Test Suite Categorya Hidden Types Categories.

<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="Shared Parameter" />
    <WORKITEMTYPE name="Test Plan" />
    <WORKITEMTYPE name="Test Suite" />
  </CATEGORY>

Abra el archivo del complemento WorkItems ubicado en la carpeta WorkItem Tracking.

Agregue una tarea para cargar tipos de elemento de trabajo de plan de pruebas y conjunto de pruebas a la sección <WORKITEMTYPES>.

<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestPlan.xml" />
<WORKITEMTYPE fileName="WorkItem Tracking\TypeDefinitions\TestSuite.xml" />

3.Aplicar sus personalizaciones a la plantilla de proceso (Opción B)

Paso 3 Con esta opción puede aplicar las personalizaciones que haya hecho en su proyecto de equipo o en su plantilla de proceso a la plantilla de proceso más reciente que más se asemeje a la plantilla usada para crear su proyecto de equipo.

Aplique las personalizaciones que haya hecho a la nueva carpeta de plantillas de proceso:
- Aplique las personalizaciones que haya hecho a las definiciones de tipos de elementos de trabajo (WIT) predeterminados. Esto podría incluir las adiciones de campos o las modificaciones en el flujo de trabajo o formulario.
- Agregue tipos de elementos de trabajo (WIT) personalizados a la carpeta de seguimiento de elementos de trabajo y actualice el archivo de definición de WorkItems según corresponda. Consulte Agregar definiciones de tipo de elementos de trabajo a una plantilla de proceso.
  
  Si quiere usar un WIT personalizado que contenga el mismo nombre que los incluidos en la plantilla de proceso predeterminada, asegúrese de intercambiar los archivos de definición de WIT. Si quiere usar un WIT personalizado con un nombre distinto al proporcionado en la plantilla de proceso predeterminada, debe modificar las categorías y los archivos de definición de la configuración de proceso antes de realizar la importación para que reflejen la otra nomenclatura.
- Aplique las personalizaciones al archivo de definición de Categories.
- Aplique las personalizaciones al archivo de definición de ProcessConfiguration. Compruebe que los WIT que quiere estén representados en las categorías adecuadas y que todos los estados de flujo de trabajo estén asignados a metaestados.
- Copie todos los archivos de plantillas de proceso adicionales que haya personalizado en la carpeta de plantillas de proceso pertinente. Para ver una lista completa de archivos de plantillas de proceso e información sobre su personalización, consulte Información general sobre los archivos de plantillas de procesos.

Repase sus cambios usando esta lista de comprobación para asegurarse de que haya aplicado todas las personalizaciones requeridas:

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 requisito (Un WIT puede pertenecer a la categoría de requisito o a la categoría de tareas, pero no a ambas).	Para incluir los campos siguientes: El valor de campo asignado a type=Order en el archivo de configuración del proceso (Prioridad del trabajo pendiente en Scrum, Rango en la pila en Agile o CMMI) El valor de campo asignado a type=Effort en el archivo de configuración del proceso (Trabajo en Scrum, Puntos de caso en Agile o Tamaño en CMMI) La 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 están incluidos en la sección AddPanel del archivo de configuración del proceso (los campos deben estar definidos dentro de la sección FIELDS pero no tienen que estar incluidos dentro de la sección FORM).	Para contener las asignaciones de metaestado necesarias en la sección RequirementBacklog: Asigne los estados iniciales de cada WIT de la categoría de requisito 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" Puede asignar más de un estado 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 WIT en la categoría de requisito	N/D	Para contener las asignaciones de metaestado necesarias según se ha descrito anteriormente para agregar un WIT a la categoría de requisito.
Agregar un WIT a la categoría de tareas	Para incluir los campos siguientes: El valor de campo asignado a type=Order en el archivo de configuración del proceso (Prioridad del trabajo pendiente en Scrum, Rango en la pila en Agile o CMMI) El valor de campo asignado a type=Activity en el archivo de configuración del proceso (Actividad en Scrum o Agile, o Disciplina en CMMI) La ruta de acceso del área o el valor de campo asignado a type=Team en el archivo de configuración del proceso El valor de campo asignado a type=RemainingWork en el archivo de configuración del proceso (Trabajo restante) (Opcional) Trabajo original y Trabajo completado (únicamente Agile y CMMI)	Para contener las asignaciones de metaestado necesarias en la sección TaskBacklog: Asigne los estados iniciales de cada WIT de la categoría de tarea a type="Proposed" 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" Puede asignar más de un estado 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 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 error o cambiar el flujo de trabajo de un WIT en la categoría de error (solo en Agile y CMMI) (consulte la Nota A)	Para admitir la opción configurable de equipo que permite agregar errores al trabajo pendiente, incluya los siguientes campos: El valor de campo asignado a type=Order en el archivo de configuración del proceso (Prioridad del trabajo pendiente en Scrum, Rango en la pila en Agile o CMMI) El valor de campo asignado a type=Effort en el archivo de configuración del proceso (Trabajo en Scrum, Puntos de caso en Agile o Tamaño en CMMI)	Para contener las asignaciones de metaestado necesarias en la sección BugWorkItems: Asigne el estado inicial de cada WIT de la categoría de error a type="Proposed" Asigne cada estado de flujo de trabajo intermedio que desee que aparezca en el panel de Kanban o en Mi trabajo a type="InProgress" Asigne el final de cada estado de flujo de trabajo type="Complete" Puede asignar más de un estado a type="Complete" Para obtener más información, consulte Compatibilidad con el estado de actualización de errores mediante Mi trabajo.
Quitar un WIT de la categoría de requisito 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	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.
Cambiar el nombre de un WIT	Actualizar el archivo de categorías con los nombres nuevos	Actualizar el archivo de configuración de proceso con los nombres nuevos

Notas:

Si ha actualizado a TFS 2013.4, vea Agregar errores al panel de tareas o de trabajo pendiente. TFS 2013.4 incluye un ajuste de configuración que permite que cada equipo vea los errores en el trabajo pendiente y en el panel Kanban. Esta característica hace referencia a las asignaciones de metaestado realizadas en BugWorkItems.

4.Cambiar el nombre y cargar la plantilla de proceso en TFS

Paso 4 Para que el asistente para Configurar características seleccione la versión más reciente de una plantilla de proceso, debe actualizar la instrucción version para que distinga la versión de la plantilla de proceso actualizada de las versiones anteriores.

Abra el archivo de complemento ProcessTemplate ubicado en la carpeta superior.

Actualice el nombre para reflejar los cambios de versión realizados. Por ejemplo:
```
<name>MyCompany Custom Scrum 2013.3  </name>
```

Actualice el fragmento de código que aparece después del elemento description. Aumente la versión secundaria para que refleje que ha realizado actualizaciones en la plantilla de proceso existente y diferenciarla de la plantilla de proceso de TFS predeterminada.

La elección del fragmento de código se basa en la categoría de la plantilla que se va a actualizar:

Categoría	Instrucción version
Agile	`<version type="ADCC42AB-9882-485E-A3ED-7678F01F66BC" major="7" minor="20"/>`
CMMI	`<version type="27450541-8E31-4150-9947-DC59F998FC01" major="7" minor="10"/>`
Scrum	`<version type="6B724908-EF14-45CF-84F8-768B5384DA45" major="3" minor="10"/>`

Categoría

Instrucción version

Agile

<version type="ADCC42AB-9882-485E-A3ED-7678F01F66BC" major="7" minor="20"/>

CMMI

<version type="27450541-8E31-4150-9947-DC59F998FC01" major="7" minor="10"/>

Scrum

<version type="6B724908-EF14-45CF-84F8-768B5384DA45" major="3" minor="10"/>

Cargue la plantilla de proceso.

Para comprobar los cambios, cree un proyecto de prueba. Vea Crear un proyecto de equipo.

5.Ejecutar el asistente para Configurar características

Paso 5 Cuando haya comprobado que la plantilla de proceso admite sus personalizaciones, ejecute el asistente Configurar características para actualizar sus proyectos de equipo existentes. Consulta Configurar características después de una actualización de TFS.

Preguntas y respuestas

P: ¿Qué tipos de personalizaciones impiden que el asistente para Configurar características pueda actualizar un proyecto de equipo?

P: Los siguientes cambios realizados en una plantilla de procesos pueden interferir con la capacidad para ejecutarse del asistente para Configurar características:

Los WIT eliminados o con nombres cambiados que pertenezcan a la categoría de requisito o de tareas.
Los estados con nombre cambiado o los estados de flujo de trabajo personalizados definidos para WIT que pertenezcan a la categoría de requisito o de tareas. Los metaestados definen cómo tratan las herramientas de planificación a cada estado de flujo de trabajo. Al menos un estado de flujo de trabajo debe asignar a los metaestados InProgress y Completed.
Eliminación de campos definidos para WIT que pertenezcan la categoría de requisito o de tareas. Estos campos se definen en el archivo de definición de ProcessConfiguration e incluyen los campos usados para administrar la prioridad de los trabajos pendientes, esfuerzo, tarea, actividad o disciplina y trabajo restante.

Para obtener más información, vea Referencia de elemento XML de la configuración del proceso.

P: ¿Cómo se usa la instrucción version en las plantillas de proceso?

R: El asistente para Configurar características usa la instrucción version para determinar qué versión de la plantilla de proceso dentro de una categoría es la más reciente y selecciona esa versión automáticamente.

Si la instrucción version no está presente, el asistente para Configurar características no puede seleccionar la plantilla de proceso para actualizar un proyecto de equipo. Asimismo, si se ha cargado en TFS más de una plantilla de proceso con el mismo número de versión más reciente, no se podrá seleccionar ninguna de estas plantillas para actualizar un proyecto de equipo.

P: Soy nuevo en lo referente a trabajar con plantillas de proceso.¿Qué debería saber sobre hacer actualizaciones de forma manual?

R: Recuerde estas sugerencias a la hora de modificar archivos de plantillas de procesos:

Si desea ver información general sobre lo que son las plantillas de procesos y sus archivos y carpetas, consulte Personalizar una plantilla de proceso e Información general sobre los archivos de plantillas de procesos.
No elimine un archivo ni una tarea para cargar un archivo salvo que tenga claro cuál es la función del archivo y que no va a necesitarlo
Para localizar las personalizaciones que haya realizado puede llevar a cabo una operación de comparación en los archivos comparables que existan entre las dos plantillas. No obstante, podría encontrarse con algunos falsos positivos si la secuencia de definiciones de elementos ha cambiado entre las dos versiones.
Puede buscar el elemento dependency en todos los archivos de complemento para ver qué tareas dependen de otras tareas que se estén completando. Por ejemplo, Microsoft Test Manager y Lab Management requieren los tipos de elemento de trabajo SharedSteps y TestCase, los tipos de vínculo SharedSteps y TestedBy, y categorías. Consulta Definir dependencias para grupos de tareas y tareas en archivos de complemento.

P: ¿Cómo cambio el nombre de un tipo de elemento de trabajo?

R: Use el comando witadmin renamewitd para cambiar el nombre y a continuación actualice el archivo de definición de Categorías. Para obtener más información, vea Modificar o agregar un tipo de elemento de trabajo (WIT) personalizado.

P: ¿Qué ocurre si deseo usar más de un nivel de trabajo pendiente de cartera?

R: Puede agregar hasta cinco trabajos pendientes de cartera. Esto incluye el trabajo pendiente predeterminado de característica. Puede agregarse a una plantilla de proceso personalizada o después de actualizar el proyecto de equipo. Para comenzar, consulte el tema para agregar un trabajo pendiente de cartera.

P: ¿Dónde puedo obtener más información sobre los archivos de definición que hay que modificar?

R: Vea los siguientes temas para obtener más información:

P: ¿Dónde puedo ir si tengo más preguntas?

R: Puede publicar una pregunta o buscar respuestas en uno de estos foros: Team Foundation Server - Work Item Tracking o Team Web Access.

Share via