Agregar un tipo de elemento de trabajo a un trabajo pendiente y una placa

Azure DevOps Services (XML hospedado) | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2017

Para satisfacer procesos empresariales selectos, es posible que el equipo quiera realizar un seguimiento de los tipos de elementos de trabajo (WIT) adicionales como requisitos o como tareas. De este modo, puede agregarlas y realizar un seguimiento de ellas en los trabajos pendientes de producto y sprint o kanban y paneles de tareas.

Por ejemplo, puede que desee realizar un seguimiento de los distintos tipos de requisitos en función de su cliente de destino o de diferentes tipos de errores en función de su origen. Aquí, el equipo de Fabrikam Fiber ha agregado el WIT de la aplicación de servicio para realizar un seguimiento del trabajo que respalda a su equipo de servicio al cliente.

Para agregar un WIT para realizar un seguimiento de los requisitos, las tareas o los errores, realice los pasos correspondientes:

• Adición de un WIT para realizar un seguimiento de los requisitos
• Agregar un WIT para realizar un seguimiento como tareas
• Agregar un WIT a la categoría de errores

Secuencia de personalización

Secuencia de personalización del modelo de proceso XML hospedado

Hará los cambios en los archivos de definición de proceso y, a continuación, importará ese proceso para actualizar los proyectos existentes o usar el proceso para crear un proyecto.

• Si no es el propietario de la organización ni miembro del grupo del administrador de Project recopilación, se agrega.
• Exportar el proceso que desea actualizar
• Si no está nuevo en la personalización de un proceso, lea Personalización de un proceso para importar.

Secuencia de personalización del modelo de proceso XML local

Primero exportará los archivos de definición de seguimiento de trabajo, los actualizará y, a continuación, los importará en el proyecto.

• Si no es miembro del grupo administrador de Project o Project administrador de recopilación, se agrega.
• Actualización del proyecto para habilitar las características más recientes
• Exporte los siguientes objetos desde el proyecto:
  • WIT que quiere agregar a los paneles y los trabajo pendientes (si no lo ha creado, haga eso ahora).
  • ProcessConfiguration
• Si no está familiarizado con la personalización de objetos de seguimiento de trabajo, familiarícese con los siguientes recursos:
  • Agregar o modificar un campo
  • Agregar o modificar un tipo de elemento de trabajo
  • Referencia XML de ProcessConfiguration.

Agregar un WIT para realizar un seguimiento como un requisito

Los WIT que agregue a la categoría de requisitos se mostrarán en el trabajo pendiente del producto y en la placa Kanban. Debe asegurarse de que la definición de WIT contiene los campos necesarios para admitir las herramientas de planeamiento de Agile.

1. Exporte el proceso (XML hospedado) o los archivos de definición (XML local) como se indica en Los primeros pasos.

2. Edite la definición de WIT para admitir herramientas de planeamiento.

   Personalizar/ Sintaxis para agregar o actualizar

   Campo Stack Rank (Agile, CMMI)

   <FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">     
   <HELPTEXT>Work first on items with lower-valued stack rank. Set in triage. 
   </HELPTEXT>      
   </FIELD> 
   

   Campo Prioridad de trabajo pendiente (Scrum)

   <FIELD name="Backlog Priority" refname="Microsoft.VSTS.Common.BacklogPriority" type="Double" reportable="detail" /> 
   

   Campo Área de valor

   <FIELD name="Value Area" refname="Microsoft.VSTS.Common.ValueArea" type="String"&gt; 
   <REQUIRED />   
   <ALLOWEDVALUES>    
   <LISTITEM value="Architectural" />   
   <LISTITEM value="Business"/>   
   </ALLOWEDVALUES>   
   <DEFAULT from="value" value="Business" /> 
   <HELPTEXT>Business = delivers value to a user or another system; Architectural = work to support other stories or components  
   </HELPTEXT>   
   </FIELD>
   

   Campo Tipo de requisito (CMMI)

   <FIELD name="Requirement Type" refname="Microsoft.VSTS.CMMI.RequirementType" type="String" reportable="dimension">  
   <REQUIRED />  
   <ALLOWEDVALUES>  
   <LISTITEM value="Scenario" />  
   <LISTITEM value="Quality of Service" />  
   <LISTITEM value="Functional" /> 
   <LISTITEM value="Operational" />  
   <LISTITEM value="Interface" />  
   <LISTITEM value="Security" />  
   <LISTITEM value="Safety" />  
   <LISTITEM value="Business Objective" />  
   <LISTITEM value="Feature" />  
   </ALLOWEDVALUES> 
   <DEFAULT from="value" value="Functional" />  
   </FIELD>
   

   WORKFLOW sección Actualice o compruebe la WORKFLOW sección como se muestra a continuación:

   • Agile, Caso de usuario: agregue transiciones de a y a ; quite las reglas que ActiveRemovedResolvedRemoved rellenan Activated By los campos y Activated Date cuando state=Resolved
   • Scrum, elemento de trabajo pendiente del producto: agregar transición de Committed a Removed
     Si ha personalizado , asegúrese de definir las asignaciones de estado a metaestado necesarias en WORKFLOW la WORKFLOW.

   FORM sección Agregue o compruebe que se han agregado los campos siguientes a la FORM sección :

   • Ágil:

   <Control FieldName="Microsoft.VSTS.Scheduling.StoryPoints" Type="FieldControl" Label="Story Points" LabelPosition="Left" />  
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />  
   

   • CMMI:

   <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.Size" Label="Size" LabelPosition="Left" />
   <Control Type="FieldControl" FieldName="Microsoft.VSTS.CMMI.RequirementType" Label="Type" LabelPosition="Left" /> 
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />  
   

   • Scrum:

   <Control FieldName="Microsoft.VSTS.Scheduling.Effort" Type="FieldControl" Label="Effort" LabelPosition="Left" />  
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />  
   

3. Edite la definición categorías. Agregue wit a la categoría Requisito. Aquí se agrega La aplicación de servicio.

   <CATEGORY name="Requirement Category" refname="Microsoft.RequirementCategory">
      <DEFAULTWORKITEMTYPE name="User Story" />
      <WORKITEMTYPE name="Service App" />
   </CATEGORY>
   

4. Actualice o compruebe la sección Definición de RequirementBacklog ProcessConfiguration: para el WIT que va a agregar. En concreto, asegúrese de que se cumplen las condiciones siguientes:

   • 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"
   • Asegúrese de que solo tiene un estado asignado a . type="Complete"
     Por ejemplo, agregue el estado de flujo de trabajo Pendiente:

   <States>    
        <State value="New" type="Proposed" />  
        <State value="Active" type="InProgress" />  
        <State value="Pending" type="InProgress" />  
        <State value="Resolved" type="InProgress" />  
        <State value="Closed" type="Complete" />  
   </States>   
   

5. Agregue la definición de color WIT a la sección WorkItemColors ProcessConfiguration. Por ejemplo:

   <WorkItemColor primary="FF33CC33" secondary="FFD6F5D6" name="Service App" />
   

6. Actualice el proyecto:

   • XML hospedado: importeel proceso.
   • XML local: importe losarchivos de definición que actualizó en este orden:
     a. WIT b. Categorías
     c. ProcessConfiguration

Agregar un WIT para realizar un seguimiento como una tarea

Los WIT que se agregan a la categoría de tareas se muestran en los paneles de tareas y los trabajo pendientes de sprint. El WIT que agregue debe especificar los campos obligatorios para admitir las herramientas de planeamiento de Agile.

1. Exporte el proceso (XML hospedado) o los archivos de definición (XML local) como se indica en Los primeros pasos.

2. Edite la definición de WIT para admitir herramientas de planeamiento.

   Personalizar/ Sintaxis para agregar o actualizar

   Campo Stack Rank (Agile, CMMI)

   <FIELD name="Stack Rank" refname="Microsoft.VSTS.Common.StackRank" type="Double" reportable="dimension">  
   <HELPTEXT>Work first on items with lower-valued stack rank. Set in triage.  
   </HELPTEXT>   
   </FIELD> 
   

   Campo **Prioridad de trabajo pendiente** (Scrum)

   <FIELD name="Backlog Priority" refname="Microsoft.VSTS.Common.BacklogPriority" type="Double" reportable="detail" />   
   

   Campo de actividad (Agile, Scrum)

   <FIELD name="Activity" refname="Microsoft.VSTS.Common.Activity" type="String" reportable="dimension"> 
   <HELPTEXT&gt;Type of work involved&lt/HELPTEXT> 
   <SUGGESTEDVALUES&gt;  
   <LISTITEM value="Development" />    
   <LISTITEM value="Testing" />    
   <LISTITEM value="Requirements" />    
   <LISTITEM value="Design" />    
   <LISTITEM value="Deployment" />    
   <LISTITEM value="Documentation" />    
   </SUGGESTEDVALUES>    
   </FIELD>    
   

   Campo de disciplina (CMMI)

   <FIELD name="Discipline" refname="Microsoft.VSTS.Common.Discipline" type="String" reportable="dimension">  
   <ALLOWEDVALUES&gt;  
   <LISTITEM value="Analysis" />    
   <LISTITEM value="User Experience" />   
   <LISTITEM value="User Education" />    
   <LISTITEM value="Development" />   
   <LISTITEM value="Test" />   
   </ALLOWEDVALUES>    
   </FIELD>    
   

   Campo de trabajo restante (todos)

   <FIELD name="Remaining Work" refname="Microsoft.VSTS.Scheduling.RemainingWork" type="Double" reportable="measure" formula="sum">    
   <HELPTEXT>    
   An estimate of the work remaining to complete the task (in person hours)  
   </HELPTEXT>
   </FIELD>    
   

   Campos de programación adicionales (Agile, CMMI)

   <FIELD name="Original Estimate" refname="Microsoft.VSTS.Scheduling.OriginalEstimate" type="Double" reportable="measure" formula="sum">    
   <HELPTEXT&gt; The original estimate of work required to complete the task (in person hours)</HELPTEXT>   
   </FIELD>    
   <FIELD name="Remaining Work" refname="Microsoft.VSTS.Scheduling.RemainingWork" type="Double" reportable="measure" formula="sum">    
   <HELPTEXT>An estimate of the work remaining to complete the task (in person hours)
   </HELPTEXT>  
   </FIELD>    
   <FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum">    
   <HELPTEXT>    
   The work that has been completed for this task (in person hours)  
   <HELPTEXT>    
   </FIELD>    
   <FIELD name="Start Date" refname="Microsoft.VSTS.Scheduling.StartDate" type="DateTime" reportable="dimension" />   
   <FIELD name="Finish Date" refname="Microsoft.VSTS.Scheduling.FinishDate" type="DateTime" reportable="dimension" />   
   

   WORKFLOW Sección
   Actualice o compruebe la WORKFLOW sección como se muestra a continuación:

   • Agile, Caso de usuario: agregue transiciones de a y a ; quite las reglas que ActiveRemovedResolvedRemoved rellenan Activated By los campos y Activated Date cuando state=Resolved
   • Scrum, elemento de trabajo pendiente del producto: agregar transición de Committed a Removed
     Si ha personalizado , asegúrese de definir las asignaciones de estado a metaestado necesarias en WORKFLOW la WORKFLOW.

   FORM Sección
   Agregue o compruebe que se han agregado los campos siguientes a la FORM sección :

   • Ágil:

   <Control FieldName="Microsoft.VSTS.Scheduling.StoryPoints" Type="FieldControl" Label="Story Points" LabelPosition="Left" />    
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />    
   

   • CMMI:

   <Control Type="FieldControl" FieldName="Microsoft.VSTS.Scheduling.Size" Label="Size" LabelPosition="Left" /&gt;    
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />    
   

   • Scrum:

   <Control FieldName="Microsoft.VSTS.Scheduling.Effort" Type="FieldControl" Label="Effort" LabelPosition="Left" />   
   <Control FieldName="Microsoft.VSTS.Common.ValueArea" Type="FieldControl" Label="Value area" LabelPosition="Left" />    
   

3. Edite la definición categorías. Agregue el WIT a la categoría Tarea. Aquí se agrega la tarea Servicio.

   <CATEGORY name="Task Category" refname="Microsoft.TaskCategory">
      <DEFAULTWORKITEMTYPE name="Task" />
      <WORKITEMTYPE name="Service Task" />
   </CATEGORY>
   

4. Actualice o compruebe la sección Definición de TaskBacklog ProcessConfiguration: para el WIT que va a agregar.
   En concreto, asegúrese de que se cumplen las condiciones siguientes:

   • Asigne el inicio de cada estado de flujo de trabajo a type="Proposed"
   • Asignar cada estado de flujo de trabajo intermedio al que desea que se muestre en el panel de tareas type="InProgress"
   • Asigne el final de cada estado de flujo de trabajo a type="Complete"
   • Asegúrese de que solo tiene un estado asignado a . type="Complete"

   Por ejemplo, agregue el estado del Blocked flujo de trabajo:

   <States>  
      <State value="New" type="Proposed" />  
      <State value="Active" type="InProgress" />  
      <State value="Blocked" type="InProgress" />  
      <State value="Resolved" type="InProgress" />  
      <State value="Closed" type="Complete" />  
   </States>  
   

5. Agregue la definición de color WIT a la sección WorkItemColors ProcessConfiguration. Por ejemplo:

   <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Service Task" />
   

6. Actualice el proyecto:

   • XML hospedado: importeel proceso.
   • XML local: importe losarchivos de definición que actualizó en este orden:
     a. WIT
     b. Categorías
     c. ProcessConfiguration

7. Confirme que puede agregar wit al panel de tareas. Abra la página del panel de tareas o actualice la página si ya está abierta.
   Debe poder seleccionar Tarea o Tarea de servicio como un elemento de trabajo vinculado a un caso de usuario.
   

   En el panel de tareas, arrastre el elemento de trabajo para actualizar su estado. Observará que no puede arrastrar un elemento a una columna para la que el estado no sea válido. Por ejemplo, no se puede arrastrar tarea al estado Bloqueado o una tarea a un estado resuelto. Si quiere usar estos estados, agréguelos a la definición de flujo de trabajo de la definición de WIT correspondiente.

Agregar un WIT a la categoría de errores

Los WIT que agregue a la categoría de errores se tratarán en función de la configuración de equipo. Dado que estos WIT se pueden tratar como requisitos o tareas, deben cumplir los requisitos de la herramienta de planeamiento de Agile para los requisitos y las tareas.

1. Exporte el proceso (XML hospedado) o los archivos de definición (XML local) como se indica en Los primeros pasos.

2. Edite la definición de WIT para admitir herramientas de planeamiento al cumplir las condiciones enumeradas para el paso 2 de Agregar un WIT para realizar un seguimiento como requisitos y Agregar un WIT para realizar el seguimiento como tareas.

3. Edite la definición categorías. Agregue wit a la categoría de errores. Aquí se agregan dos WIT.

   <CATEGORY name="Bug Category" refname="Microsoft.BugCategory">  
      <DEFAULTWORKITEMTYPE name="Bug" />  
      <WORKITEMTYPE name="Service Bug" />  
      <WORKITEMTYPE name="Feedback" />  
   </CATEGORY>
   

4. Actualice o compruebe la sección Definición de BugWorkItems ProcessConfiguration: para el WIT que va a agregar.

   En concreto, asegúrese de que se cumplen las condiciones siguientes:

   • Asigne el inicio de cada estado de flujo de trabajo a type="Proposed"
   • Asigne cada estado de flujo de trabajo intermedio que quiera que se muestre en el panel de tareas o Kanban a . type="InProgress"
   • Asigne el final de cada estado de flujo de trabajo a type="Complete"
   • Asegúrese de que solo tiene un estado asignado a . type="Complete"

   Por ejemplo, agregue el estado del Investigate flujo de trabajo:

   <States>  
    <State value="New" type="Proposed" />  
    <State value="Active" type="InProgress" />  
    <State value="Investigate" type="InProgress" />  
    <State value="Resolved" type="InProgress" />  
    <State value="Closed" type="Complete" />  
   </States>  
   

5. Agregue la definición de color WIT a la sección WorkItemColors ProcessConfiguration. Por ejemplo:

   <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Service Bug" />  
   <WorkItemColor primary="FFFF00FF" secondary="FFFFCCFF" name="Feedback" />  
   

6. Actualice el proyecto:

   • XML hospedado: importeel proceso.
   • XML local: importe losarchivos de definición que actualizó en este orden:
     a. WIT
     b. Categorías
     c. ProcessConfiguration

7. Elija la configuración del equipo para saber cómo se realiza el seguimiento de los errores.

8. Confirme que el WIT aparece en los paneles y los trabajo pendientes según lo previsto y que puede agregarlo a través de los trabajo pendientes según lo previsto.

Importar y exportar archivos de definición (XML local)

Use los comandos witadmin para importar y exportar archivos de definición. Para más información, consulte witAdmin: Customize and manage objects for tracking work (witAdmin: Personalizar y administrar objetos para realizar el seguimiento del trabajo).

1. Escriba el witadmin comando , sustituyendo los datos por los argumentos que se muestran. Por ejemplo, para importar un WIT:

   witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\WITDefinitionFile.xml"
   

   En CollectionURL, especifique la dirección URL de una colección de proyectos y, en ProjectName, especifique el nombre de un proyecto definido dentro de la colección. Debe especificar la dirección URL con el formato siguiente: http://ServerName:Port/VirtualDirectoryName/CollectionName .

   En DirectoryPath, especifique la ruta de acceso a la carpeta que contiene la plantilla de proceso que descargó. La ruta de acceso al directorio debe seguir esta estructura: Drive:\TemplateFolder\WorkItem Tracking\TypeDefinitions .

   Por ejemplo, importe el WIT de ServiceApp:

   witadmin importwitd /collection:"http://MyServer:8080/tfs/DefaultCollection"/p:MyProject /f:"DirectoryPath/ServiceApp.xml"
   

Use estos comandos para exportar e importar WIT, categorías y configuración de procesos:

witadmin exportwitd /collection:CollectionURL /p:"ProjectName" /n:TypeName /f:"DirectoryPath\WITDefinitionFile.xml"  
witadmin importwitd /collection:CollectionURL /p:"ProjectName" /f:"DirectoryPath\WITDefinitionFile.xml"  
witadmin exportcategories /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/categories.xml"  
witadmin importcategories /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/categories.xml"   
witadmin exportprocessconfig /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/ProcessConfiguration.xml"  
witadmin importprocessconfig /collection:"CollectionURL" /p:"ProjectName" /f:"DirectoryPath/ProcessConfiguration.xml"  

Artículos relacionados

Acaba de mostrar cómo agregar otro WIT a los backlogs o paneles. Sin embargo, si desea agregar otro WIT para que actúe como un trabajo pendiente de cartera, consulte Add portfolio backlogs(Agregar trabajo pendiente de cartera).

Consulte Personalización de la experiencia de seguimiento de trabajo para obtener información general de todas las opciones disponibles para personalizar objetos de seguimiento de trabajo.

Para obtener información sobre cómo se muestran los elementos jerárquicos o anidados en un trabajo pendiente o una placa, vea Cómo muestran los registros pendientes y los paneles elementos jerárquicos (anidados).