Referencia del elemento XML de configuración del proceso

Azure DevOps Server 2022: Azure DevOps Server 2019

La configuración del proceso define la configuración predeterminada y las funcionalidades funcionales a las que los equipos pueden acceder mediante las herramientas ágiles del portal web. Estas herramientas incluyen el trabajo pendiente del producto, los trabajos pendientes de sprint, la placa y el panel de tareas, y son personalizables para cada equipo que agregue al proyecto.

Los elementos de configuración especifican los tipos de elementos de trabajo (WIT), las columnas predeterminadas, los campos utilizados por las herramientas y otros elementos. Las configuraciones principales realizadas determinan qué elementos se mostrarán para los trabajos pendientes de cartera, producto y sprint definiendo las secciones PortfolioBacklog, RequirementBacklog y TaskBacklog del archivo de definición XML de configuración del proceso. Además, la configuración del proceso define la asignación de flujo de trabajo de la categoría de estado a estado para todas las WIT que requieren asignación.

Para obtener un resumen de lo que puede configurar a través de la interfaz de usuario, consulte Personalización del seguimiento del trabajo, Adición de equipos y configuración de sus herramientas de Scrum y Kanban.

Áreas que puede personalizar a través de ProcessConfiguration:

Actualización de la configuración del proceso

Para actualizar la configuración del proceso de un proyecto, exporte el archivo de definición XML, edítelo y, a continuación, importe el archivo. Estos archivos se exportan mediante la exportación de un proceso o la exportación del archivo de definición de configuración del proceso.

Configuración de un trabajo pendiente

Puede personalizar los siguientes elementos para el trabajo pendiente del producto, los trabajos pendientes de sprint y los trabajos pendientes de cartera:

• Asignaciones de categorías de estado: asigne estados de flujo de trabajo a categorías de estado (anteriormente denominadas metastate). Estas asignaciones admiten la visualización de todas las herramientas de planeamiento de Agile, incluidos el panel y los paneles de tareas.

• Panel de adición rápida: especifique los campos WIT y elemento de trabajo que aparecen para agregar rápidamente elementos al trabajo pendiente.

  Para cambiar los tipos de elementos de trabajo que se consideran elementos de trabajo pendientes o tareas, agréguelos a la categoría correspondiente. Para obtener un ejemplo, vea Agregar errores al panel de tareas o al trabajo pendiente.

• Campos de columna: defina los campos predeterminados y la secuencia de columnas.

Los trabajos pendientes se configuran en las secciones XML que aparecen en el ejemplo siguiente:

<PortfolioBacklogs>
      <PortfolioBacklog category="Microsoft.EpicCategory" pluralName="Epics" singularName="Epic" workItemCountLimit="1000">
. . . 
      </PortfolioBacklog>
      <PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature" parent="Microsoft.EpicCategory" workItemCountLimit="1000">
. . . 
      </PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Stories" singularName="User Story" workItemCountLimit="1000">
. . . 
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="1000">
. . . 
</TaskBacklog>

Sintaxis de los elementos PortfolioBacklogs

<PortfolioBacklog category="PortfolioCategory" parent="ParentCategory"  
pluralName="PluralName" singularName="SingleName" workItemCountLimit="MaximumLimit>  
<States> . . . </States>  
<Columns> . . . </Columns>  
<AddPanel> . . . </ AddPanel>  
</PortfolioBacklog >  

<RequirementBacklog category="RequirementCategory"  
pluralName="PluralName" singularName="SingleName"   
workItemCountLimit="MaximumLimit" >  
<States> . . . </States>
<Columns> . . . </Columns>
<AddPanel> . . . </ AddPanel>
</RequirementBacklog >

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" 
singularName="Task workItemCountLimit="MaximumLimit">
. . . 
</TaskBacklog > 

Notas de implementación

• De forma predeterminada, cada trabajo pendiente está restringido a un total de 1000 elementos de trabajo. Puede cambiar este límite especificando un valor para el workItemCountLimit atributo .
• Los valores asignados a CategoryName deben corresponder a un grupo de categorías definido para el proyecto. Los grupos de categorías se especifican en el archivo de definición de Categories.
• Puede usar trabajos pendientes de cartera para organizar el trabajo pendiente, ver la acumulación de elementos de trabajo pendiente en niveles inferiores y ver el progreso en varios equipos. Los proyectos nuevos y actualizados contienen dos niveles de trabajo pendiente de cartera: características y epopeyas. Puede agregar hasta tres niveles adicionales. Solo el trabajo pendiente de cartera de nivel superior no especifica una categoría primaria.
• El trabajo pendiente del producto corresponde al plan del proyecto, la hoja de ruta para lo que el equipo planea entregar. Enumera los elementos de trabajo cuyos WIT pertenecen a la categoría de requisitos. Para administrar diferentes WIT que las proporcionadas por el proyecto predeterminado, puede agregar WIT a la Categoría de requisitos y asignar los estados de flujo de trabajo a las categorías de estado.
• Los trabajos pendientes de sprint o iteración muestran el conjunto de requisitos que usted y su equipo se han comprometido en un ciclo de sprint específico y las tareas que ha vinculado a esos requisitos. Las tareas se vinculan a los requisitos mediante el tipo de vínculo primario-secundario. Dado que los WIT que aparecen en estos trabajos pendientes corresponden a los mismos tipos que aparecen en el trabajo pendiente del producto, gran parte del trabajo de personalización que realiza para el trabajo pendiente del producto definirá la funcionalidad del trabajo pendiente de sprint.

Asignar estados de flujo de trabajo de categoría WIT a categorías de estado

Varias WIT requieren que sus estados de flujo de trabajo se asignen a una categoría de estado. Los estados de flujo de trabajo definen cómo avanza un elemento de trabajo desde la primera activación o creación hasta cerradas o completadas. Por ejemplo, los estados definidos para el elemento de trabajo pendiente del producto Scrum definen una progresión de cuatro estados, desde New, Approved, Committed, to Done, y también incluye un quinto estado, Removed, para tener en cuenta un estado quitado del trabajo pendiente sin implementarse. Los estados de flujo de trabajo están asociados al value atributo .

Por otro lado, las categorías de estado determinan cómo las herramientas de planeamiento ágil tratan cada estado de flujo de trabajo. Las categorías de estado principal usadas por el trabajo pendiente y el panel de tareas son Propuesta, InProgress y Complete. Las categorías de estado están asociadas al type atributo . Para obtener más información, consulte Estados de flujo de trabajo y categorías de estado.

Al asociar cada estado de flujo de trabajo a una categoría de estado, las operaciones en segundo plano realizadas para mostrar el trabajo pendiente y los paneles de tareas saben cómo interpretar correctamente el estado de cada elemento de trabajo. Por ejemplo, las siguientes asignaciones se definen para el trabajo pendiente del producto Scrum.

<RequirementBacklog category="Microsoft.RequirementCategory" pluralName="Backlog items" singularName="Backlog item">
      <States>
      <State value="New" type="Proposed" />
      <State value="Approved" type="Proposed" />
      <State value="Committed" type="InProgress" />
      <State value="Done" type="Complete" />
      </States>
 . . .
</RequirementBacklog>

Hay tres grupos de categorías de estado: Agile, Bug y Feedback. En la tabla siguiente se describen los atributos y valores de asignación.

Sintaxis para los elementos States (categoría WIT)

<State value="ValueName" type="TypeName" />

Establecer columnas predeterminadas

Especifique los campos que desea mostrar en cada trabajo pendiente dentro de la sección Columnas . Los cambios que realice a través del cuadro de diálogo Opciones de columna se conservan hasta que vuelva a cambiarlos.

Esta es la configuración predeterminada definida por la plantilla de proceso de Scrum para el trabajo pendiente del producto.

<Columns>
      <Column refname="Microsoft.VSTS.Common.Priority" width="400" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.Effort" width="50" />
      <Column refname="System.IterationPath" width="200" />
</Columns>

Sintaxis para los elementos Columns

<Column refname="FieldReferenceName"  width="FieldWidth" />

Encabezados de columna del panel de tareas

Los encabezados de columna que aparecen en el panel de tareas corresponden a los estados de flujo de trabajo asignados al WIT predeterminado asignado a la categoría de tarea. La secuencia de columnas corresponde a la progresión natural de las transiciones de flujo de trabajo, pasando de izquierda a derecha. Para modificar el diseño de columna, modifique el flujo de trabajo para el WIT asignado a la categoría de tareas. Los estados de flujo de trabajo definidos para el tipo de tarea predeterminado en la categoría de tarea deben asignarse a una categoría de estado válida, tal como se describe en Categorías de estado de mapa para una categoría de tipos de elementos de trabajo.

Personalización del panel de adición rápida

Puede agregar campos para cualquier panel de adición rápido. Por ejemplo, en el ejemplo siguiente se agrega Valor empresarial al panel de trabajo pendiente del producto.

El panel solo muestra los campos que se incluyen en la sección CAMPOS de la definición 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 errores. Para agregar otro WIT al panel, agréguelo a la categoría de requisitos, tal como se describe en Agregar un tipo de elemento de trabajo a un trabajo pendiente y un panel.

El código siguiente corresponde a las asignaciones predeterminadas definidas en las plantillas de proceso de Visual Studio Scrum y MSF para Agile.

<AddPanel>
      <Fields>
      <Field refname="System.Title" />
      </Fields>
</AddPanel>

Sintaxis para elementos AddPanel

<Field refname="FieldReferenceName"/>

Establecer el número de elementos de trabajo del panel de tareas

Por motivos de rendimiento, el panel de tareas está restringido para mostrar un máximo de 1000 elementos de trabajo. Al abrir el panel de tareas, todos los elementos de trabajo se cargan en la memoria caché. Limitar el número de elementos de trabajo puede producir tiempos de carga más rápidos. Puede cambiar este límite especificando un valor para el workItemCountLimit atributo del elemento TaskBacklog .

Por ejemplo, puede reducir el límite especificando workItemCountLimit="800":

<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>

Categorías de estado de asignación para tipos de elementos de trabajo específicos de la herramienta

Las asignaciones de categorías de estado se definen para categorías WIT adicionales. Para la plantilla de proceso de Scrum, esto incluye asignaciones para las categorías de solicitud y respuesta de comentarios. Para las plantillas de proceso de MSF Agile y CMMI, también incluye asignaciones para la categoría de errores. (Scrum incluye errores en la categoría de requisitos y, por tanto, define las asignaciones de categorías de estado dentro de Sección RequirementBacklog ).

<FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" pluralName="Feedback Requests" singularName="Feedback Request">
      <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
      </States>
</FeedbackRequestWorkItems>
<FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" pluralName="Feedback Responses" singularName="Feedback Response">
      <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
      </States>
</FeedbackResponseWorkItems>

En la tabla siguiente se describen los elementos adicionales usados para definir las asignaciones de categorías de estado para los tipos de elementos de trabajo específicos de la herramienta. Vea Asignar categorías de estado para obtener una categoría de tipos de elementos de trabajo para obtener información sobre cómo asignar los tipos y valores de estado reales. CategoryName debe corresponder a una categoría definida para el proyecto.

Sintaxis para elementos de asignación de categorías de estado específicos de la herramienta

<BugWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</BugWorkItems>

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackRequestWorkItems>

<FeedbackResponseWorkItems category="CategoryName"  
pluralName="PluralName" singularName="SingleName">
<States>
. . .
</States>
</FeedbackResponseWorkItems>```

<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="Authoring" />
<State type="InProgress" value="Testing" />
<State type="Complete" value="Completed" />
</States>
</TestSuiteWorkItems>

Asignar campos de herramientas ágiles

Puede cambiar los campos de elemento de trabajo que se usan para calcular la capacidad, los gráficos de agotamiento, la previsión y la velocidad. Cualquier cambio que realice en una de las asignaciones predeterminadas debe corresponder a un cambio realizado en el WIT usado para definir y capturar información para ese valor.

Por ejemplo, si cambia el refname asignado a type="Activity" , debe incluir el mismo campo en la definición de WIT asignada a la categoría de tarea que captura la información de actividad.

<TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname=" Microsoft.VSTS.Common.BacklogPriority" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.Effort" type="Effort" />
    <TypeField refname="Microsoft.VSTS.Common.Activity" type="Activity" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationStartInformation" type="ApplicationStartInformation" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationLaunchInstructions" type="ApplicationLaunchInstructions" />
    <TypeField refname="Microsoft.VSTS.Feedback.ApplicationType" type="ApplicationType">
        <TypeFieldValues>
            <TypeFieldValue value="Web application" type="WebApp" />
            <TypeFieldValue value="Remote machine" type="RemoteMachine" />
            <TypeFieldValue value="Client application" type="ClientApp" />
        </TypeFieldValues>
    </TypeField>
</TypeFields>

Sintaxis de los elementos TypeFields

<TypeField refname="FieldReferenceName"  
type="NameOfType" [format="{0} TimeUnitString"] / >

<TypeFieldValue value="ApplicationTypeName" type="TypeApp"/>

<TypeFieldValues>
<TypeFieldValue value="Web application" type="WebApp" />
<TypeFieldValue value="Remote machine" type="RemoteMachine" />
<TypeFieldValue value="Client application" type="ClientApp" />
</TypeFieldValues>

Notas de implementación

• Si cambia un campo dentro de la sección TypeFields , debe realizar el cambio correspondiente en la definición de WIT. Por ejemplo, si cambia los campos asignados para capturar el trabajo esfuerzo, debe realizar el mismo cambio en las definiciones wiT para el artículo de trabajo pendiente del producto y el error (para Scrum).

• Puede buscar el nombre de referencia de un campo mediante este índice.

Establecer días no laborables

Los días no laborables se quitan de los cálculos realizados por la herramienta de planeamiento de capacidad y los gráficos de agotamiento. Procesos predeterminados: Agile, Scrum o CMMI, especifique sábado y domingo como días no laborables.

<Weekends>
   <DayOfWeek>Saturday</DayOfWeek>
   <DayOfWeek>Sunday</DayOfWeek>
</Weekends>

Sintaxis para los elementos Weekends

<DayOfWeek>NameOfADay</DayOfWeek>

Cambiar el color de un tipo de elemento de trabajo

De un vistazo, puede diferenciar los WIT al ver un resultado de consulta o un trabajo pendiente en función del color y el icono asignados al WIT. El sistema aplica el color definido para el tipo de elemento de trabajo al icono especificado para el WIT.

La plantilla de proceso de Scrum define las siguientes asignaciones de color. Se realizan similares para las plantillas Agile y CMMI.

<WorkItemColors>
      <WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
      <WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
   <WorkItemColor primary="FFFF7B00" secondary="FFFFD7B5" name="Epic" />
      <WorkItemColor primary="FFF2CB1D" secondary="FFF6F5D2" name="Task" />
      <WorkItemColor primary="FFCC293D" secondary="FFFAEAE5" name="Bug" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Request" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Code Review Response" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Request" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Feedback Response" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Impediment" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Step" />
      <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Case" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Plan" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Test Suite" />
   <WorkItemColor primary="FFFF9D00" secondary="FFFCEECF" name="Shared Parameter" />
</WorkItemColors>

Sintaxis para elementos WorkItemColors

<WorkItemColor primary="HexColorCode" secondary="HexColorCode"  
name="witName" />

Especificar propiedades y comportamientos

Las dos primeras propiedades que puede establecer BugsBehavior y HiddenBacklogs establecer el valor predeterminado de un proyecto. Sin embargo, cada equipo puede cambiar el comportamiento a través de su configuración de equipo. La tercera propiedad StateColors define los colores asociados a los estados de flujo de trabajo para todas las WIT. Los valores establecidos se usan para todos los equipos de un proyecto.

Configuración de ejemplo Properties :

 <Properties>  
      <Property name="BugsBehavior" value="AsTasks" />  
      <Property name="HiddenBacklogs" value="Microsoft.EpicCategory" />  
      <Property name="StateColors" value="Active=#FF00FF00,Resolved=#FFFF0000" />
      <Property name="WorkItemTypeIcons" value="Epic=Icon_Crown,Feature=Icon_Trophy,User Story=icon_book,
        Task=icon_clipboard,Bug=icon_insect,Issue=icon_traffic_cone,
        Test Plan=icon_test_plan,Test Suite=icon_test_suite,Test Case=icon_test_case,Shared Steps=icon_test_step,
        Shared Parameter=icon_test_parameter" />  
  </Properties>  

La BugsBehavior propiedad determina cómo se muestran los errores y otros WIT definidos en la categoría de errores, en trabajos pendientes y paneles. Básicamente, puede configurar si los errores se tratan como requisitos, como tareas, o no aparecen en trabajos pendientes y paneles. Para obtener más información, consulte Mostrar errores en trabajos pendientes y panel.

La HiddenBacklogs propiedad determina qué trabajos pendientes o trabajos pendientes de cartera aparecen de forma predeterminada. El valor predeterminado es mostrar solo el trabajo pendiente del producto y un nivel de trabajo pendiente de cartera, el trabajo pendiente características. Teams puede determinar si quieren activar el trabajo pendiente de Epics o realizar otros cambios. Para obtener más información, consulte Organizar el trabajo pendiente, Activar los niveles de trabajo pendiente para su equipo.

Sintaxis para los elementos Properties

<Property name="WorkItemTypeIcons" 
value="Epic=Icon_Crown,Feature=Icon_Trophy,  
User Story=icon_book,Task=icon_clipboard,Bug=icon_insect,  
Issue=icon_traffic_cone,Test Plan=icon_test_plan,Test Suite=icon_test_suite,  
Test Case=icon_test_beaker,Shared Steps=icon_test_step,Shared Parameter=icon_test_parameter" />

Especificar colores de estado de flujo de trabajo

El color asociado a los estados del elemento de trabajo aparecerá en todo el producto. Esto incluye las siguientes áreas:

• Formulario de elemento de trabajo (portal web, consulte Nueva experiencia de elemento de trabajo)
• Control de vínculos de formulario de elemento de trabajo (portal web, vea Referencia de elementos XML LinksControlOptions)
• Tarjetas que se muestran en el panel y los paneles de tareas (para la configuración, consulte Personalizar tarjetas)
• Todos los trabajos pendientes (agregar estado a través de las opciones de columna)
• Resultados de la consulta (agregar estado a través de las opciones de columna)

Aquí se muestra cómo aparece en el formulario del elemento de trabajo:

Detalles:

• Debe especificar el color como un valor hexadecimal de ocho dígitos, similar al usado para el color definido para un WIT.
• Para agregar o editar colores, simplemente vuelva a importar la configuración del proceso con la propiedad actualizada.
• Los colores de estado se definen por nombre en todos los tipos de elementos de trabajo, es decir, no hay ninguna manera de que "Active" sea un color para user Story y un color diferente para Bug
• Los colores no asignados se establecen de forma predeterminada en tiempo de ejecución en función de su asignación de metadatos
• Los estados sin ningún color definido y ninguna asignación de metadatos mostrará un círculo vacío.

Especificar iconos WIT

A continuación se muestra el conjunto admitido de iconos que puede especificar para un tipo de elemento de trabajo.

El sistema aplica el color definido para el tipo de elemento de trabajo al icono. Los colores e iconos aparecen en el portal web donde se muestran los elementos de trabajo. Esto incluye en Trabajo relacionado en solicitudes de incorporación de cambios, lista de vínculos, las páginas del proyecto , así como trabajos pendientes, paneles, consultas y planes.

Por ejemplo, aquí verá una vista de lista...

y aquí se muestra el icono dentro del formulario de elemento de trabajo.

Artículos relacionados

Obtenga más información sobre el formulario de elemento de trabajo web y cómo personalizarlo a partir de estos temas adicionales:

• Agregar o modificar un tipo de elemento de trabajo
• Personalizar el nuevo formulario
• Elementos WebLayout y Control
• Modelo de proceso XML local

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