Referencia de elemento XML de la configuración del proceso

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

Importante

Este artículo se aplica a la personalización de proyectos para los modelos de proceso XML locales. Para obtener información general sobre los modelos de proceso, consulte Personalización de la experiencia de seguimiento de trabajo.

La configuración del proceso define la configuración predeterminada y las funcionalidades funcionales a las que los equipos pueden acceder mediante las herramientas de Agile 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 trabajo pendientes de cartera, producto y sprint mediante la definición de las secciones PortfolioBacklog, RequirementBacklogy 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 todos los WIT que requieren asignación.

Process configuration XML elements

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
- -
- -
- -
- -
- - 1
- - 1
- - 1
- -
- - 2
- - 3
- -
- -
- -

Nota

  1. Los elementos anotados 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 xml local para TFS 2015.2 o una versión posterior.
  3. Compatible con XML hospedado y 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, consulte Agregar un tipo de elemento de trabajo a un trabajo pendiente y un panel y Agregar trabajos pendientesde 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 procesos.

Para actualizar la configuración del proceso de un proyecto, exporte el archivo de definición XML, edílo e importe el archivo. Puede exportar estos archivos exportando un proceso o exportando el archivo de definición de configuración de proceso.

Export ProcessConfig definition fileEdit XML definition fileImport WIT definition fileRefresh and verify changes

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.

O bien, puede usar TFS Team Project Manager,un cliente de código abierto disponible en GitHub.

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

O bien, puede usar TFS Team Project Manager,un cliente de código abierto disponible en GitHub.

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 TFS Power Tools. O bien, puede usar TFS Team Project Manager,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 los estados de flujo de trabajo a categorías de estado (anteriormente denominadas metaestado). 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ónrápida: especifique los wi-fi y los campos de 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 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 con el archivo ProcessConfiguration ——Scrumo CMMI,para se corresponderá con RequirementCategoryStories (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ía 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 haya definido en el archivo de definición de categorías para el proyecto que contiene los WIT que se asociarán a este tipo de trabajo pendiente.

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

  • pluralName:especifique la etiqueta plural que se 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ía 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. Especifique grupos de categorías en el archivo de definición para Categorías.
  • 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 de proyecto, la hoja de ruta de lo que el equipo planea entregar. Muestra los elementos de trabajo cuyos WIT pertenecen a la categoría de requisitos. Para administrar diferentes WIT que los proporcionados por el proyecto predeterminado, puede agregar WIT a la categoría Requisitos y asignar los estados de flujo de trabajo a categorías de estado.
  • Los trabajos pendientes de sprint o iteración muestran tanto el conjunto de requisitos a los que usted como 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 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

Varios 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 ytambién incluye un quinto estado, Quitado, 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 de Agile tratan cada estado de flujo de trabajo. Las categorías de estado principal usadas por el trabajo pendiente y el panel de tareas son Proposed, InProgressy Complete. 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 de 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 para ValueName corresponden a un valor asignado a un estado dentro de la sección WORKFLOW de los WIT asignados 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.
  • Propuesto:indica los elementos de trabajo nuevos, no confirmados aún o en los que aún no se está trabajando.
  • InProgress:indica los elementos de trabajo que se han confirmado o en los que se está trabajando activamente.
  • Complete: 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 asociado al metaestado Completo, el elemento de trabajo asociado se desasoye del trabajo pendiente del producto. Sin embargo, se seguirá enumerando 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 o la placa.
  • 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 Agile, incluye la categoría Estado resuelto que indica los 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,Revisadoy Rechazado.

States

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 que se muestren en cada trabajo pendiente dentro de la sección Columnas. Los cambios que realice a través del Opciones de columna diálogo persistente hasta que vuelva a cambiarlos.

Default columns and sequence for backlog page

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 de elementos Columns

Element

Descripción

Columnas

Especifica una colección de elementos Column. Elemento requerido para los elementos de trabajo pendiente: PortfolioBacklog, RequirementBacklogy 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 tareas deben asignarse a una categoría de estado válida como se describe en Asignar categorías de estado para una categoría de tipos de elemento 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 Business Value al panel de trabajo pendiente del producto.

Backlog panel with Business Value field added

El panel solo muestra los campos que se incluyen en la sección CAMPOS de la definición de WIT para el WIT seleccionado. Por ejemplo, si selecciona el error WIT, solo se muestra Título, porque Business Value no está definido para los errores. Para agregar otro WIT al panel, agrégrelo 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 de los elementos AddPanel

Element

Descripción

AddPanel

Elemento contenedor que se usa para especificar la experiencia de "adición rápida", los campos que aparecen dentro del área del panel donde se definen los 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 workItemCountLimit

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ía de estado se definen para categorías de 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ía 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ía de estado para los tipos de elementos de trabajo específicos de la herramienta. Vea Asignar categorías de estado para 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ía de estado específicos de la herramienta

Element

Descripción

BugWorkItems

Opcional. Elemento contenedor que define las asignaciones de categoría 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 las herramientas de Agile, también controlan cómo la característica Mi trabajo de Team Explorer actualiza el estado de los errores a medida que los desarrolladores mueven errores mediante Mi trabajo. Para más información, consulte Get your code reviewed (TFVC) (Obtener el 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ía 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ía 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 del flujo de trabajo para el plan de prueba 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ía 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 del 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ía de estado para los tipos de elementos de trabajo asignados a la categoría Conjunto de pruebas. 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 o , debe actualizar el servidor de nivel de aplicación a TestSuiteWorkItems 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 Test Plan and Test Suite features (Características de Test Plan y Conjunto de pruebas).

Asignación de campos de herramientas de Agile

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 asignado a , debe incluir el mismo campo en la definición de WIT asignada a la Categoría de tarea que captura la información refnametype="Activity" 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

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 del trabajo pendiente de sprint actual y en el panel de tareas.

Para herramientas de Agile:

  • Actividad:se usa para admitir la característica 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 Capacidad reflejan una unión de todos los valores definidos para el campo en todos los proyectos dentro de la instancia de colección de proyectos. Por lo tanto, para restringir los valores que aparecen para la capacidad del sprint, debe hacer que los valores coincidan en todos los proyectos para el 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.

  • Order: se usa para definir el criterio de ordenación de los elementos de los paneles y los trabajo pendientes. 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 los gráficos de trabajo y de reducción de datos restantes. 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 los paneles de tareas siempre que se notifica 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 desee 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 trabajo pendientes a un equipo. El valor predeterminado es System.AreaPath. Para desacoplar los equipos de las rutas de acceso de área, puede especificar un campo diferente, como se describe en Uso de campos de equipo en lugar de rutas de acceso de área paraadmitir equipos .

    Para el formulario de solicitud de comentarios:

Nota

No debería 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 .

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 reducción de datos. Los procesos ——Scrumo CMMIespecifican 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 de los elementos Weekends

Element

Descripción

DayOfWeek

Elemento secundario requerido 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 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 WIT.

Query results showing wit color, icon, and state color

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 de los 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 se valide la sintaxis.

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

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

Especificar propiedades y comportamientos

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

Configuración Properties de ejemplo:

 <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 propiedad determina cómo se muestran los errores y otros WIT definidos en la categoría de errores en los BugsBehavior paneles y los trabajo pendientes. 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 los trabajo pendientes y la placa.

La propiedad determina qué trabajo pendiente o trabajo pendiente de cartera HiddenBacklogs 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 determinar si quieren activar el trabajo pendiente de epopeyas o realizar otros cambios. Para más información, consulte Organización del 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 los trabajo pendientes y la placa. Los valores permitidos corresponden a:
  • AsRequirements Los errores aparecen en los backlogs y paneles similares a los requisitos (valor predeterminado para el proceso de 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 los paneles o los trabajo pendientes
  • HiddenBacklogs especifica el trabajo pendiente que está inactivo de forma predeterminada.
  • StateColors establece los valores de color para 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. Antefiese 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 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 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 agile es como se muestra. Solo puede especificar un icono de la lista de iconos admitidos.

<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 los colores de estado del flujo de trabajo, debe actualizar a TFS 2015.2 o una versión posterior.

El color que asocie a los estados de los elementos de trabajo aparecerá en el producto. Esto incluye las siguientes áreas:

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

Bug work item form header, State color shown

Nota

No se muestran colores en los formularios de elementos de trabajo del cliente o 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 que se usa para el color definido para 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 otro color para Bug.
  • Los colores no asignados tienen el valor predeterminado en tiempo de ejecución en función de su asignación de metaestado
  • Los estados sin color definido y sin asignación de metaes estado mostrarán 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 de iconos admitido que puede especificar para un tipo de elemento de trabajo.

icon_airplane, icon_asterisk, icon_book, icon_car, icon_chart, icon_chat_bubble, icon_check_box, icon_clipboard, icon_code_response, icon_code_reviewicon_palette, icon_crown, icon_database_storage, icon_diamond, icon_flame, icon_gavel, icon_gear, icon_gift, icon_government, icon_headphoneicon_insect, icon_key, icon_list, icon_megaphone, icon_paint_brush, icon_parachute, icon_response, icon_review, icon_ribbon, icon_sticky_noteicon_star, icon_test_beaker, icon_test_parameter, icon_test_plan, icon_test_step, icon_test_suite, icon_traffic_cone, icon_trophy

Nota

Los iconos anotados 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 y los iconos aparecen en el portal web donde se muestran los elementos de trabajo. Esto incluye en Trabajo relacionado en LAS, lista de vínculos, páginas de Project, así como Trabajos pendientes, paneles, consultas y planes.

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

Web portal, list of work items with icons

y, aquí, el icono se muestra en el formulario de elemento de trabajo.

Bug work item form header, Work item type icon shown

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

Si ha agregado un WIT personalizado y desea agregarlo al trabajo pendiente o al panel de tareas, puede hacerlo. Simplemente 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.