Juanlu, elGuerre: TFS Integration Tool: Integrando/migrando de CMMI 4.2 a CMMI 5 y mapeos para Task y Requirements

martes, 18 de octubre de 2011

TFS Integration Tool: Integrando/migrando de CMMI 4.2 a CMMI 5 y mapeos para Task y Requirements

Muy buenas,

No tenía pensado comentar nada al respecto, pero después de aprender a usar la herramienta, detectar algunos bugs y un poco de trabajo de “chinos”, creo que es una pequeña ayuda para que podáis entender la migración entre distintos “Team Projects” con distintas plantillas de procesos:

Antes de nada, para el que no conozca “TFS Integration Tool (o, TFS Integration Platform)” es un herramienta de CodePlex, que facilita la migración/integración entre diferentes versiones de Work Items, Bug Tracking, etc.

Aunque está en beta, siempre que no se haya “customizado” complicadamente algún work item, cosa que no es de extrañar en algún caso, Risa ), la herramienta funciona bastante bien, salvo algunas limitaciones en cuanto a items que no son migrados a día de hoy:

Check-in notes
~~Labels~~
Permissions
Workspaces
Pending Changes
Shelvesets
File encodings
Subscriptions
Test Cases
Check-in policies
Reports
Team Portal / SharePoint
Process Templates
Work item queries
Builds
Warehouse data

Hasta donde he podido llegar, los “Labels” si los migra, Risa .

Aunque podemos encontrarnos casos más complejos, entre otros, que el TeamProject destino exista y ya tenga bastante código, Work Items, changesets, etc, por el momento, os dejo un resumen de mi caso en concreto (desde “MSF for CMMI Process Improvement v4.2” a “MSF for CMMI Process Improvement CMMI5”) donde el TeamProject destino está recién creado:

Crea el “TeamProject” destino basado en la Platilla “MSF for CMMI Process Improvement v5.0”
Abre la consola de administración de TFS y asignar el usuario con el que se vaya a lanzar la migración desde el “TFS Integration” dentro del grupo “Team Foundation Services Account”. Como en la mayoría de los casos seremos nosotros mismos, los que lancemos la migración, pues bastará con seguir los pasos (1) y (2) según indico en la siguiente figura, y si ya apareces como “Administrator Console Users”, haz click en “Reaply” para que se puedan aplicar los permisos oportunos y, todo listo. Si quieres conocer más información al respecto de este punto, echa un vistazo a este post de “Willy’s Cave”.

Abre el “TFS Integration”, crea una nueva configuración(“Create new”) y elige “VersionControlAndWorkItemTracking.xml”
Selecciona el “Workflow Type” “Custom” (el resto, en la versión “2.1.10324.0” no parece que vayan del todo bien, no se guardan las reglas, tienes que aplicar de nuevo la migración y finalmente la esta nunca se produce !!!)

Utiliza los siguientes valores para realizar tu configuración de Mapeo/Migración:

En el paso (2) aparecerá una nueva ventana donde tendrás que indicar los mapeos entre los distintos Work Items y sus campos.

Este mapeo está listo para los Work Items de tipo “Requirement” y “Task”, el resto podrás crearlos tu mismo sin mayor esfuerzo una vez que entiendas estos, eso si, tendrás que conocer las diferencias de campos y poder hacer así el mapeo.

        1: <SettingXml>

       2:   <WITSessionCustomSetting>

       3:     <Settings />

       4:     <WorkItemTypes>

       5:       <WorkItemType LeftWorkItemTypeName="Task" RightWorkItemTypeName="Task" fieldMap="Migrate2Tasks" />

       6:       <WorkItemType LeftWorkItemTypeName="Requirement" RightWorkItemTypeName="Requirement" fieldMap="Migrate2Requirements" />

       7:       <WorkItemType LeftWorkItemTypeName="Bug" RightWorkItemTypeName="Bug" fieldMap="*" />

       8:       <WorkItemType LeftWorkItemTypeName="Issue" RightWorkItemTypeName="Issue" fieldMap="*" />

       9:       <WorkItemType LeftWorkItemTypeName="Change Request" RightWorkItemTypeName="Issue" fieldMap="*" />

    </WorkItemTypes>

    <FieldMaps>

 

      <FieldMap name="Migrate2Tasks">

        <MappedFields>

 

          <!-- Mapeo de todos los campos -->

          <MappedField LeftName="*" RightName="*" MapFromSide="Left" />

 

          <!--- Excepciones a los mapeos  -->

          <!-- Mapeos sin destino -->

          <MappedField LeftName="Severity" RightName="" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Issue" RightName="" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Start Change Date" RightName="" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Exit Criteria" RightName="" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Test Id" RightName="" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Test Name" RightName="" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Test Path" RightName="" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Estimate" RightName="Microsoft.VSTS.Scheduling.OriginalEstimate" MapFromSide="Left" valueMap="" />

          <!-- Mapeos con cambio en el destino -->

          <MappedField LeftName="Triage" RightName="Microsoft.VSTS.Common.Triage" MapFromSide="Left" valueMap="TriageMap" />

          <MappedField LeftName="Priority" RightName="Microsoft.VSTS.Common.Priority" MapFromSide="Left" valueMap="PriorityMap" />

          <MappedField LeftName="Discipline" RightName="Microsoft.VSTS.Common.Discipline" MapFromSide="Left" valueMap="DisciplineMap" />

          <MappedField LeftName="Task Type" RightName="Microsoft.VSTS.Common.TaskType" MapFromSide="Left" valueMap="TaskTypeMap" />          

 

        </MappedFields>

      </FieldMap>

 

      <FieldMap name="Migrate2Requirements">

        <MappedFields>

 

          <MappedField LeftName="*" RightName="*" MapFromSide="Left" />

 

          <MappedField LeftName="Issue" RightName="" MapFromSide="Left" valueMap="" />

          

          <MappedField LeftName="Rank" RightName="Microsoft.VSTS.Common.StackRank" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Estimate" RightName="Microsoft.VSTS.Scheduling.OriginalEstimate" MapFromSide="Left" valueMap="" />

 

          <MappedField LeftName="Requirement Type" RightName="Microsoft.VSTS.CMMI.RequirementType" MapFromSide="Left" valueMap="RequirementType2Map" />

          <MappedField LeftName="Priority" RightName="Microsoft.VSTS.Common.Priority" MapFromSide="Left" valueMap="PriorityMap" />          

          <MappedField LeftName="Triage" RightName="Microsoft.VSTS.Common.Triage" MapFromSide="Left" valueMap="TriageMap" />

 

          <!-- These are not exist on target  -->

          <!--<MappedField LeftName="Start Date" RightName="Microsoft.VSTS.Scheduling.StartDate" MapFromSide="Left" valueMap="" />

          <MappedField LeftName="Finish Date" RightName="Microsoft.VSTS.Scheduling.FinishDate" MapFromSide="Left" valueMap="" />-->

 

        </MappedFields>

      </FieldMap>      

    </FieldMaps>

 

    <ValueMaps>

      <!-- Tasks values  -->

      <ValueMap name="TriageMap">

        <Value LeftValue="Pending" RightValue="Pending"/>

        <Value LeftValue="More Info" RightValue="More Info"/>

        <Value LeftValue="Info Recv" RightValue="Info Received"/>

        <Value LeftValue="Triaged" RightValue="Triaged"/>

      </ValueMap>

 

      <ValueMap name="PriorityMap">

        <Value LeftValue="1" RightValue="1" />

        <Value LeftValue="2" RightValue="2" />

        <Value LeftValue="3" RightValue="3" />

        <!--<Value LeftValue="" RightValue="4" />-->

      </ValueMap>

 

      <ValueMap name="DisciplineMap">

        <Value LeftValue="Analysis" RightValue="Analysis" />

        <Value LeftValue="User Experience" RightValue="User Experience" />

        <Value LeftValue="User Education" RightValue="User Education" />

        <Value LeftValue="Test" RightValue="Test" />

      </ValueMap>

 

      <ValueMap name="TaskTypeMap">

        <Value LeftValue="Analysis" RightValue="Corrective Action" />

        <Value LeftValue="User Experience" RightValue="Mitigation Action" />

        <!--<Value LeftValue="" RightValue="Planned" />-->

      </ValueMap>

 

      <ValueMap name="RequirementType2Map">

        <Value LeftValue="Scenario" RightValue="Scenario"/>

        <Value LeftValue="Quality of Service" RightValue="Quality of Service"/>

        <Value LeftValue="Functional" RightValue="Functional"/>

        <Value LeftValue="Operational" RightValue="Operational"/>

        <Value LeftValue="Interface" RightValue="Interface"/>

        <Value LeftValue="Security" RightValue="Security"/>

        <Value LeftValue="Safety" RightValue="Safety"/>

        <!--<Value LeftValue="" RigthValue="Business Objective"/>

        <Value LeftValue="" RigthValue="Feature"/>-->

      </ValueMap>

    </ValueMaps>

  </WITSessionCustomSetting>

</SettingXml>

<SettingXmlSchema />

Algunas notas aclaratorias sobre el mapeo:
- Las líneas de la 5 a la 9, indican los Work Items a mapear.
- Las líneas 5 y 6 incluyen el atributo “fieldMap” cuyo valor indica el mapeo en particular, que se corresponden con las líneas 17 y 38 respectivamente.
- Adicionalmente en este código hago algunas aclaraciones al respecto, así que no habrá problema en entenderlo.
- Las líneas de la 60 a la 100, indican los diferentes valores para las opciones posibles de ciertos campos.
- Las líneas comentadas se corresponden principalmente con aquellos mapeos de campos que no existen en origen pero si en el destino (en el nuevo TeamProject), por tanto no las mapeo, puesto que no son requeridas.

Nota: Para completar el resto de mapeos, haz uso de los fichero “XML” de las distintas plantillas, así podrás conocer el detalle de los mapeos a realizar.

Guarda los cambios “Save to Database.

Y comienza con la integración/migración “Current Migration” – “Start”

Una vez finalizado el proceso, podrás comprobar que el nuevo TeamProject contiene todo el código; Work Items, labels, Branching (sin “Trak Changeset” !), changeset asociados, etc., y si estableces como parámetro de configuración, el “Workflow Type”, “Custom” para un “Frecuency”, “ContinousAutomatic”, podrás comprobar que a medida que cambias código, haces “CheckIn”, etc., todo se verá reflejado en el nuevo como si se tratara del mismo TeamProject.

De la misma manera que este proceso de integración entre dos TeamProject ha sido un éxito, también podrás hacerlo para distintas “Queries” de origen y por tanto, “Area Path”, etc. El peso principal recae sobre cada uno de los mapeos según he comentado antes, y podrás hacerlo, para distintas plantillas de proceso, Scrum, MSF Agile, etc., e incluso entre distintas plantillas origen y destino.

Mucha suerte y espero que sirva de ayuda/aclaración, Guiño