Referencia de elemento XML de la configuración del proceso

Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

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, el panel Kanban y el panel de tareas, y son personalizables para cada equipo que agregue al proyecto.

Los elementos de configuración especifican los tipos de elemento de trabajo (WIT), las columnas predeterminadas, los campos que las herramientas usan 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 Scrum y Kanban.

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

Trabajos pendientes	Tipos de elementos de trabajo (WIT)	Otras herramientas
- Configuración del panel de adición rápida - Definición de columnas predeterminadas - Asignar categorías de estado para una categoría WIT - Establecer el número de elementos del panel de tareas - Establecer días de fin de semana (Scrum)1 - Establecer el valor predeterminado Mostrar errores en los trabajos pendientes1 - Establecer trabajos pendientes ocultos predeterminados1	- Especificar el color WIT - Especificar el color de estado del flujo de trabajo2 - Especificar el icono de WIT3	- Asignación de campos de herramientas ágiles - Asignar categorías de estado específicas de la herramienta - Especificar propiedades

Nota

1. Los elementos indicados con un asterisco establecen un valor predeterminado para el proyecto. Estos elementos se pueden cambiar para cada equipo a través de la configuración del equipo.
2. Compatible con XML hospedado y para XML local para TFS 2015.2 o una versión posterior.
3. Compatible con XML hospedado y para XML local para TFS 2017.2 o una versión posterior.

Importante

Si desea personalizar el proyecto para agregar tipos de elementos de trabajo personalizados para que aparezcan en los trabajos pendientes o paneles o agregar trabajos pendientes de cartera personalizados, vea Agregar un tipo de elemento de trabajo a un trabajo pendiente y un panel y Agregar trabajos pendientes de cartera.

Actualización de la configuración del proceso

Nota

Para acceder a la versión más reciente de las plantillas de proceso, instale la versión más reciente de TFS y descargue las plantillas mediante el Administrador de plantillas de 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.

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.

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 el Administrador de proyectos de equipo de TFS, un cliente de código abierto disponible en GitHub.

Configurar un trabajo pendiente

Puede personalizar los siguientes elementos de trabajo pendiente, trabajos pendientes del sprint y 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 presentación de todas las herramientas de planeación de Agile, incluidos el panel kanban y el panel de tareas.

• Panel de adición rápida: especifique los campos WIT y elementos 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 pendiente 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 dentro de 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>

Nota

Dependiendo del proceso asociado a su archivo ProcessConfiguration (Agile, Scrum o CMMI), el correspondiente pluralNameRequirementCategory corresponderá a Stories (Agile), Backlog Items (Scrum) o Requirements (CMMI). Los tres son similares: describen el valor del cliente que se va a entregar y el trabajo que se va a realizar.

Sintaxis de los elementos PortfolioBacklogs

Element

Descripción

PortfolioBacklogs

Opcional. Elemento contenedor de los trabajos pendientes de cartera.

PortfolioBacklog

Opcional. Hasta cinco instancias.

Elemento contenedor que define las asignaciones de categorías de estado, las columnas predeterminadas y el panel de adición rápida para un trabajo pendiente de cartera.

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

Asigne valores a los atributos como se describe:

• category: especifique el nombre de una categoría que ha definido en el archivo de definición de categorías para el proyecto que contiene los WIT que se van a asociar a este tipo de trabajo pendiente.

• primario: especifique el nombre de la categoría que representa el trabajo pendiente de cartera primario dentro de la jerarquía.

• pluralName: especifique la etiqueta plural que se va a usar al hacer referencia a los WIT asociados a este tipo de trabajo pendiente. Por ejemplo, Casos, Objetivos, Iniciativas o Epopeyas.

• singularName: especifique la etiqueta singular que se usará al hacer referencia a los WIT asociados a este tipo de trabajo pendiente. Por ejemplo, Caso, Objetivo, Iniciativa o Epopeya.

• workItemCountLimit: especifique un entero. El valor predeterminado es 1000. Los trabajos pendientes y los paneles restringirán el número de elementos que se muestran en función de este límite.

RequirementBacklog

Necesario. Una instancia única.

Elemento contenedor que define las asignaciones de categorías de estado, las columnas predeterminadas y el panel de adición rápida para el trabajo pendiente del producto. El trabajo pendiente del producto muestra todos los elementos activos en el trabajo pendiente del equipo.

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

TaskBacklog

Necesario. Una instancia única.

Elemento contenedor que se usa para personalizar el diseño de los trabajos pendientes del sprint.

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

Notas de implementación

• Cada trabajo pendiente está restringido de forma predeterminada 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.
• Los trabajos pendientes de cartera se usan 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. Se pueden agregar hasta cuatro niveles más. Solo el trabajo pendiente de cartera de nivel superior no especifica una categoría primaria.
• El trabajo pendiente del producto se corresponde con el plan del proyecto, la hoja de ruta para lo que su equipo planea entregar. Muestra 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 a los que usted y su equipo se han comprometido en un ciclo de sprint específico y las tareas vinculadas a esos requisitos. Las tareas se vinculan a los requisitos con el tipo de vínculo primario-secundario. Como los WIT que aparecen en estos trabajos pendientes corresponden a los mismos tipos que aparecen en el trabajo pendiente, gran parte del trabajo de personalización que se realiza para el trabajo pendiente 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 del flujo de trabajo definen cómo progresa un elemento de trabajo desde la primera activación o creación hasta que se cierra o completa. Por ejemplo, los estados definidos para el elemento de trabajo pendiente del producto Scrum definen una progresión de cuatro estados, de Nuevo, Aprobado, Confirmado, a Listo, e incluye también un quinto estado, Eliminado, 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 utilizadas por el trabajo pendiente y el panel de tareas son Propuesta, InProgress y Completado. Las categorías de estado están asociadas al type atributo . Para 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 están definidas para el trabajo pendiente de 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)

Element

Descripción

State

Necesario. Asigna un estado de flujo de trabajo a una categoría de estado.

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

Los valores válidos de ValueName corresponden a un valor asignado a un estado dentro de la sección FLUJO de trabajo de esas WIT asignadas al grupo de categorías.

Los valores válidos para TypeName corresponden a uno de los siguientes valores enumerados:

• Agile: se usa para todos los tipos de elemento de trabajo.
• Propuesta: indica los elementos de trabajo que son nuevos, aún no confirmados o que aún no se están trabajando.
• InProgress: indica los elementos de trabajo confirmados o en los que se está trabajando activamente.
• Completado: indica los elementos de trabajo que se han implementado. Para que el panel Kanban sea válido, se debe asignar exactamente un estado de flujo de trabajo a la categoría Estado completo . Si es necesario representar estados de flujo de trabajo adicionales, se pueden asignar a la categoría Estado resuelto .
  Una vez que un estado de flujo de trabajo pasa a un estado que está asociado con el metastate Completo , el elemento de trabajo asociado quedará fuera del trabajo pendiente del producto. Sin embargo, seguirá apareciendo en la última columna del panel Kanban.
  
  Los elementos de trabajo en un estado de flujo de trabajo que no están asignados a una de las categorías de estado no aparecen en el trabajo pendiente ni en el panel.
• Error: solo se usa para los tipos de elemento de trabajo agrupados dentro de la categoría Error. Además de las categorías de estado de Agile, incluye la categoría Estado resuelto que indica errores que se han resuelto.
  
  

Nota

Solo puede asignar la categoría estado Resuelto a un estado de flujo de trabajo especificado en el elemento BugWorkItems .

• Comentarios: solo se usa para los tipos de elemento de trabajo agrupados dentro de las categorías Solicitud de comentarios o Respuesta a comentarios. Solicitado, recibido, revisado y rechazado.

Estados

Especifica una colección de elementos State que asocian estados de flujo de trabajo WIT con categorías de estado.

Elemento necesario para los elementos primarios siguientes:

• BugWorkItems
• PortfolioBacklog
• RequirementBacklog
• TaskBacklog
• TestPlanWorkItems
• TestSuiteWorkItems
• FeedbackRequestWorkItems
• FeedbackResponseWorkItems

Establecer columnas predeterminadas

Especifique los campos que desea mostrar en cada trabajo pendiente dentro de la sección Columnas . Los cambios realizados 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

Element

Descripción

Columnas

Especifica una colección de elementos Column . Elemento obligatorio para los elementos de trabajo pendiente: PortfolioBacklog, RequirementBacklog y TaskBacklog.

Columna

Especifica que un campo aparece como una columna en un trabajo pendiente.

<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 del 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 del flujo de trabajo, que es de izquierda a derecha. Para modificar el diseño de columna, modifique el flujo de trabajo del WIT asignado a la categoría de tarea. 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.

Personalizar el 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.

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 Title, 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 y 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 for Agile.

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

Sintaxis para los elementos AddPanel

Element

Descripción

AddPanel

Elemento contenedor usado para especificar la experiencia de "adición rápida", los campos que aparecerán dentro del área del panel donde se definen nuevos elementos de trabajo pendiente.

Fields

Especifica una colección de elementos Field .

Campo

Especifica que un campo de elemento de trabajo debe aparecer dentro del panel de trabajo pendiente.

<Field refname="FieldReferenceName"/>

El mismo campo debe aparecer en el formulario del elemento de trabajo de cada WIT incluido en la categoría del trabajo pendiente.

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

Por razones de rendimiento, el panel de tareas puede mostrar un máximo de 1000 elementos de trabajo. Al abrir el panel de tareas, todos los elementos de trabajo se cargan en memoria caché. La limitación del 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>

Asignar categorías de estado 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 Scrum, esto incluye asignaciones para las categorías de solicitud de comentarios y respuesta a comentarios. Para las plantillas de procesos de MSF for Agile y MSF for CMMI, también incluye asignaciones para la categoría de error. (Scrum incluye errores en la categoría de requisitos y, por tanto, define las asignaciones de categorías de estado dentro de la 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 que se usan 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

Element

Descripción

BugWorkItems

Opcional. Elemento contenedor que define las asignaciones de categorías de estado para los tipos de elementos de trabajo asignados a la categoría de errores. Además de cómo se usan estas asignaciones en la presentación de herramientas de Agile, también controlan cómo la característica Mi trabajo en Team Explorer actualiza el estado de error a medida que los desarrolladores mueven errores mediante Mi trabajo. Para más información, consulte Obtención del código revisado (TFVC).

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

FeedbackRequestWorkItems

Necesario. No lo personalice. Elemento contenedor que define las asignaciones de categorías de estado para los tipos de elementos de trabajo asignados a la categoría de solicitud de comentarios.

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

FeedbackResponseWorkItems

Necesario. No lo personalice. Elemento contenedor que define las asignaciones de categorías de estado para los tipos de elementos de trabajo asignados a la categoría de respuesta de comentarios.

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

TestPlanWorkItems

Solo es necesario cuando se personaliza el estado de flujo de trabajo para el plan de pruebas y se admiten conexiones al proyecto desde versiones de Test Manager instaladas con Visual Studio 2013.2 o versiones anteriores.

Elemento contenedor que define las asignaciones de categorías de estado para los tipos de elementos de trabajo asignados a la categoría plan de prueba. Por ejemplo:

<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

Solo es necesario cuando se personaliza el estado de flujo de trabajo para Test Suite y se admiten conexiones al proyecto desde versiones de Test Manager instaladas con Visual Studio 2013.2 o versiones anteriores.

Elemento contenedor que define las asignaciones de categorías de estado para los tipos de elementos de trabajo asignados a la categoría Test Suite. Por ejemplo:

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

Nota

Disponibilidad de características: Para asignar categorías de estado para TestPlanWorkItems o TestSuiteWorkItems, debe actualizar el servidor de nivel de aplicación a TFS 2013.3 o una versión posterior. Posteriormente puede personalizar el estado del flujo de trabajo de los planes de pruebas y los conjuntos de pruebas. Para más información, consulte Características de Test Plan y Test Suite.

Asignar campos de herramientas ágiles

Puede cambiar los campos de elemento de trabajo que se utilizan para calcular la capacidad, los gráficos de evolución, la previsión y el progreso. Cualquier cambio realizado en una de las asignaciones predeterminadas debe corresponder a un cambio realizado en el WIT utilizado para definir y para 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 para los elementos TypeFields

Element

Descripción

TypeFields

Necesario. Especifica una colección de elementos TypeField .

TypeField

Necesario. Especifica el nombre de referencia de un campo cuyo valor admite un tipo de actividad para un área de características. Los campos que se especifiquen deben corresponder a los campos que se usen en los WIT utilizados para capturar la información de características.

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

Especifique el formato solo cuando type="RemainingWork". Puede especificar cualquier cadena de texto para TimeUnitString que desee que aparezca en las barras de capacidad en el trabajo pendiente de sprint actual y en el panel de tareas.

Para herramientas de Agile:

• Actividad: se usa para admitir la característica de capacidad por actividad. Especifique el mismo campo utilizado en el WIT asignado a la categoría de tarea.

Nota

Los valores mostrados por la herramienta Capacity reflejan una unión de todos los valores definidos para el campo en todos los proyectos de la instancia de la colección de proyectos. Por lo tanto, para restringir los valores que aparecen para la capacidad de sprint, debe hacer que los valores coincidan en todos los proyectos del campo asignado a type="Activity".

• Esfuerzo: se usa para calcular la velocidad del equipo. Especifique el mismo campo utilizado en el WIT asignado a la categoría de requisito que se utiliza para capturar el nivel estimado de esfuerzo, los puntos de caso o el tamaño de la cantidad de trabajo que un elemento de trabajo pendiente necesita para implementarse.

• Orden: se usa para definir el criterio de ordenación de los elementos en los trabajos pendientes y paneles. El sistema muestra una lista de los elementos de trabajo según el orden ascendente tal y como se define en el campo para este tipo.

Nota

Puede mover elementos arrastrándolos hacia arriba o hacia abajo en la lista en un trabajo pendiente o panel. A medida que mueve elementos, un proceso en segundo plano actualiza el campo asignado a .type="Order"

• RemainingWork: se usa para calcular el trabajo restante y los gráficos de agotamiento. Especifique el mismo campo utilizado en el WIT asignado a la categoría de tarea que se utiliza para capturar las horas, los días u otra unidad de medida que quedan para finalizar una tarea.
  El valor que especifique para el formato se usa en los trabajos pendientes de sprint y en los paneles de tareas donde se notifique el trabajo restante. Por ejemplo, al notificar la capacidad por actividad o la capacidad por miembro del equipo, o junto al encabezado de columna para los estados de tarea en el panel de tareas.
  En TimeUnitString, especifique cualquier cadena de texto que quiera usar para reflejar el valor de hora, como horas o días.
  Por ejemplo, todos los valores siguientes son válidos:
  format="{0} h"
format="{0} hours"
format="hours {0}"
format="time {0}"
• Equipo: se usa para asociar los trabajos pendientes a un equipo. El valor predeterminado es System.AreaPath. Para desacoplar equipos de rutas de acceso de área, puede especificar un campo diferente, como se describe en Usar campos de equipo en lugar de rutas de acceso de área para admitir equipos.
  Para el formulario de solicitud de comentarios:
  

Nota

No debe tener que cambiar las asignaciones predeterminadas realizadas para los siguientes elementos TypeField . Estas asignaciones corresponden a los campos utilizados para capturar la información correspondiente en el WIT asignado a la categoría Solicitud de comentarios.

• ApplicationStartInformation: se usa para capturar la ruta de acceso para ejecutar la aplicación.

• ApplicationLaunchInstructions: se usa para capturar instrucciones de inicio.

• ApplicationType: se usa para capturar el tipo de aplicación. Los tipos mostrados corresponden a los valores permitidos especificados en la definición de WIT de la solicitud de comentarios.

TypeFieldValues

Obligatorio para TypeFieldValue cuando type="ApplicationType". Especifica una colección de elementos TypeFieldValue que se usan en el formulario de solicitud de comentarios.

TypeFieldValue

Necesario. No lo personalice. Especifica el nombre de un tipo de aplicación que aparecerá en el formulario de solicitud de comentarios.

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

Las asignaciones predeterminadas corresponden a los valores permitidos especificados en la definición de tipo para el formulario de solicitud de comentarios.

<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 esfuerzo de trabajo, debe realizar el mismo cambio en las definiciones de WIT para el elemento 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. Los procesos predeterminados (Agile, Scrum o CMMI) especifican sábado y domingo como días no laborables. Después de crear un proyecto, cada equipo puede establecer sus días no laborables específicos.

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

Sintaxis para los elementos Weekends

Element

Descripción

DayOfWeek

Elemento secundario obligatorio del elemento Weekends .

Especifica un día de la semana correspondiente a un día no laborable.

<DayOfWeek>NameOfADay</DayOfWeek>

Los nombres válidos corresponden a los días en inglés de la semana: domingo, lunes, martes, miércoles, jueves, viernes y sábado.

Nota

Debe especificar el día de una semana en inglés, independientemente del idioma instalado en su TFS local.

Fines de semana

Opcional. Elemento contenedor utilizado para especificar los días no laborables.

Especifique los días no laborables cuando desee tenerlos en cuenta en el cálculo de los gráficos de evolución y capacidad.

Cambiar el color de un tipo de elemento de trabajo

De un vistazo, puede diferenciar los WIT al ver un resultado de consulta o 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 otras similares para las plantillas de 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

Element

Descripción

WorkItemColors

Opcional. Elemento contenedor para especificar los colores de los tipos de elemento de trabajo.

WorkItemColor

Especifica los colores usados para mostrar un WIT dentro del portal web. El color principal se usa en las pantallas de lista. Ya no se hace referencia al color secundario, pero debe especificarlo para que la sintaxis se valide.

Al especificar el color, siempre debe prefijar el código de color hexadecimal de seis dígitos con FF , lo que indica que el color debe ser totalmente visible.

<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 directamente no aparecen en los trabajos pendientes y paneles. Para obtener más información, consulte Mostrar errores en trabajos pendientes y placa.

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. Los equipos pueden 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 niveles de trabajo pendiente para el equipo.

Sintaxis de los elementos Properties

Element

Descripción

Propiedades

Opcional. Elemento contenedor para especificar los comportamientos y propiedades predeterminados.

Propiedad

Especifica la asignación predeterminada realizada a nuevos equipos o equipos existentes al actualizar un proyecto con nuevas características. Los equipos pueden elegir el comportamiento que quieran a través de su configuración de equipo.

Los nombres de propiedad válidos son:

• BugsBehavior establece el valor predeterminado para mostrar errores en trabajos pendientes y placa. Los valores permitidos corresponden a:
  
• AsRequirements : los errores aparecen en trabajos pendientes y paneles similares a los requisitos (valor predeterminado para el proceso Scrum)
• AsTasks : los errores aparecen en trabajos pendientes y paneles similares a las tareas (valor predeterminado para los procesos agile y CMMI)
• Desactivado: los errores no aparecen en trabajos pendientes o paneles
  
• HiddenBacklogs especifica el trabajo pendiente inactivo de forma predeterminada.
• StateColors establece los valores de color de los estados de flujo de trabajo. (Requiere TFS 2017 o una versión posterior)
  El valor de la propiedad es una lista separada por comas de nombres de estado y colores hexadecimales. Prefijo el código de color hexadecimal de seis dígitos con FF, que indica que el color debe ser totalmente visible.
  <Property name="StateColors" value="stateName1=color1, stateName2=color2,..." />
  
  

Nota

Disponibilidad de características: Puede especificar colores de estado de flujo de trabajo si usa XML hospedado o, para XML local, ha actualizado a TFS 2015.2 o a una versión posterior.
Para obtener más información, consulte la sección siguiente , Especificar colores de estado de flujo de trabajo.

• WorkItemTypeIcons define el icono que se va a mostrar para cada tipo de elemento de trabajo. El icono se muestra en listas de elementos de trabajo y en formularios de elementos de trabajo. La entrada predeterminada para el proceso de Agile es como se muestra. Solo puede especificar un icono de la lista de iconos compatible.
  
  

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

Nota

Disponibilidad de características: Puede personalizar los iconos usados para los tipos de elementos de trabajo si usa XML hospedado o, para XML local, ha actualizado a TFS 2017.2 o una versión posterior.

Especificar colores de estado de flujo de trabajo

Nota

Disponibilidad de características: para especificar colores de estado de flujo de trabajo, debe actualizar a TFS 2015.2 o una versión posterior.

El color que asocie a los estados del elemento de trabajo aparecerá en 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 mostradas en el panel Kanban y paneles de tareas (para la configuración, consulta 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:

Nota

No se muestran colores en los formularios de elementos de trabajo del cliente ni en el control de vínculos antiguos dentro del formulario de cliente.

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 metaestado
• Los estados sin ningún color definido y ninguna asignación de metaespacio mostrará un círculo vacío.

Especificación de iconos WIT

Nota

Disponibilidad de características: Puede personalizar los iconos usados para los tipos de elementos de trabajo si usa XML hospedado o, para XML local, ha actualizado a TFS 2017.2 o una versión posterior.

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

icon_headphone

Nota

Los iconos indicados con un asterisco se admiten en Azure DevOps Services y TFS 2017.3 y versiones posteriores.

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