Referencia de elemento XML de la configuración del proceso
La configuración del proceso define la configuración predeterminada y las capacidades funcionales a las que pueden acceder los equipos mediante las herramientas de planeación de Agile.
Estas herramientas, que puede ver a través de Team Web Access (TWA), muestran un conjunto filtrado de elementos de trabajo basados en la configuración creada en las secciones PortfolioBacklog, RequirementBacklog y TaskBacklog del archivo de definición XML de configuración del proceso. Además, la configuración de proceso define las asignaciones de los estados del flujo de trabajo a un metaestado para todos los tipos de elemento de trabajo (WIT) que requieren asignación.
Para obtener más información, vea Configurar y personalizar herramientas de planeación ágiles para un proyecto de equipo.
Áreas que puede personalizar:
Configurar una página de trabajo pendiente
Asignar metaestados para una categoría de tipos de elemento de trabajo
Personalizar las columnas y la secuencia de columnas predeterminadas
Personalizar el panel de adición rápida
Cambiar el número de elementos de trabajo que pueden aparecer en el panel de tareas
Asignar metaestados para los tipos de elemento de trabajo específicos de la herramienta
Asignar campos utilizados en herramientas de planeación y gráficos Agile
Especificar los días del fin de semana
Cambiar el color de un tipo de elemento de trabajo
Para actualizar la configuración de proceso, exporte el archivo de definición XML, edítelo y, a continuación, importe el archivo. Utilice la herramienta de línea de comandos witadmin para importar y exportar el archivo.
Nota
Los ejemplos de sintaxis mostrados en este tema corresponden a las asignaciones predeterminadas definidas en la plantilla de proceso de Visual Studio Scrum 2013.Para tener acceso 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.
Configurar una página de trabajo pendiente
Hay tres tipos de páginas de trabajo pendiente: trabajo pendiente del producto, iteración o trabajo pendiente del sprint, y trabajo pendiente de cartera. Puede personalizar cada página de trabajo pendiente de las maneras siguientes:
Asignaciones de metaestados: asigne estados del flujo de trabajo a metaestados. Estas asignaciones admiten la presentación de todas las páginas de planeación Agile, incluidos el panel kanban y el panel de tareas.
Panel de adición rápida: especifique los WIT 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 la secuencia de columnas y los campos predeterminados.
Configure las páginas de trabajo pendiente dentro de las secciones XML que aparecen en el ejemplo siguiente:
<PortfolioBacklogs>
<PortfolioBacklog category="Microsoft.FeatureCategory" pluralName="Features" singularName="Feature">
. . .
</PortfolioBacklog>
</PortfolioBacklogs>
<RequirementBacklog category="Microsoft.RequirementCategory" pluralName=" Backlog items" singularName=" Backlog item">
. . .
</RequirementBacklog>
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task">
. . .
</TaskBacklog>
Elemento |
Descripción |
---|---|
PortfolioBacklogs |
Opcional. Elemento contenedor para las páginas de trabajo pendiente de cartera. |
PortfolioBacklog |
Opcional. Hasta cinco instancias. Elemento contenedor que define las asignaciones de metaestado, las columnas predeterminadas y el panel de adición rápida a una página de trabajo pendiente de cartera.
Asigne valores a los atributos como se describe:
|
RequirementBacklog |
Requerido. Una instancia única. Elemento contenedor que define las asignaciones de metaestados, las columnas predeterminadas y el panel Agrega rápidamente para la página de trabajo pendiente del producto. El trabajo pendiente del producto muestra todos los elementos activos en el trabajo pendiente del equipo.
|
TaskBacklog |
Requerido. Una instancia única. Elemento contenedor utilizado para personalizar el diseño de las páginas que muestran elementos de trabajo asignados a una iteración concreta.
De forma predeterminada, el panel de tareas está limitado a un total de 500 elementos de trabajo. Puede cambiar este límite si especifica un valor para el atributo workItemCountLimit. |
Notas sobre la implementación
Los valores asignados a CategoryName deben corresponder a un grupo de categorías definido para el proyecto de equipo. Puede especificar grupos de categorías en el archivo de definición de las categorías. Para obtener más información, consulta Referencia de elementos XML de categorías.
Utilice los trabajos pendientes de cartera para ver el resumen de elementos de trabajo pendiente en los niveles inferiores y el progreso de varios equipos. Los proyectos de equipo nuevos y actualizados contienen un nivel con la etiqueta Características. Puede agregar hasta cuatro niveles adicionales.
Nota
El uso de las páginas de cartera puede requerir que se le conceda acceso Avanzado.Para obtener información detallada, vea Cambiar niveles de acceso.
Para obtener información sobre cómo utilizar las páginas de trabajo pendiente de la cartera, vea Trabajar con trabajos pendientes de cartera.
El trabajo pendiente del producto representa una lista de requisitos para el producto que se está desarrollando. Los elementos de trabajo pendiente corresponden a un tipo específico de elemento de trabajo basado en la plantilla de proceso utilizada para crear el proyecto de equipo, como elemento de trabajo pendiente del producto, caso de usuario o requisito. Si se utilizan diferentes tipos de elemento de trabajo o se capturan los requisitos mediante dos o más tipos de elemento de trabajo, se puede personalizar la página de trabajo pendiente del producto para admitir su uso.
Para obtener información sobre cómo utilizar las páginas de trabajo pendiente del producto, vea Crear el trabajo pendiente.
Las páginas de trabajo pendiente del sprint o de iteración muestran el conjunto de requisitos que usted y su equipo han impuesto a un ciclo de iteración concreto y las tareas que se han vinculado a dichos requisitos. Las tareas deben vincularse a los requisitos mediante el tipo de vínculo secundario. Como los tipos de elemento de trabajo que aparecen en estas páginas corresponden a los mismos tipos que aparecen en la página de trabajo pendiente del producto, gran parte del trabajo de personalización que se realiza para la página de trabajo pendiente del producto definirá la funcionalidad de las páginas de trabajo pendiente de tarea.
Para obtener información sobre cómo utilizar las páginas de trabajo pendiente del sprint, vea Trabajar con sprints.
Asignar estados del flujo de trabajo a metaestados
La mayoría de los WIT requieren asignar sus estados del flujo de trabajo a un metaestado. 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 de Scrum definen una progresión de cuatro estados, desde Nuevo, Aprobado, Confirmado hasta Listo, y también incluyen un quinto estado, Quitado, para tener en cuenta un estado quitado del trabajo pendiente sin implementar.
Por otra parte, los metaestados determinan cómo tratan las herramientas de planeación Agile cada uno de los estados de flujo de trabajo. Los metaestados principales utilizados por el trabajo pendiente y el panel de tareas son Proposed, InProgress y Complete.
Asociando los estados del flujo de trabajo a un metaestado, las operaciones en segundo plano realizadas para mostrar los paneles de trabajo pendiente y de tareas saben cómo interpretar correctamente el estado de cada elemento de trabajo. Por ejemplo, se definen las siguientes asignaciones para las páginas de trabajo pendiente del producto 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 categorías de metaestados: Agile, Error y Comentarios. En la tabla siguiente se describen los atributos y valores de asignación.
Elemento |
Descripción |
---|---|
State |
Requerido. Asigna un estado de flujo de trabajo a un metaestado.
Los valores válidos para TypeName corresponden a un valor asignado a un STATE dentro de la sección WORKFLOW de los WIT asignados al grupo de categorías. Los valores válidos para ValueName corresponden a uno de los valores enumerados siguientes:
|
States |
Especifica una colección de elementos State que asocian estados del flujo de trabajo WIT a metaestados. Elemento necesario para los elementos primarios siguientes:
|
Personalizar las columnas y la secuencia de columnas predeterminadas
Puede agregar o quitar columnas, cambiar la secuencia de las columnas o cambiar el ancho de columna en las páginas que muestran una página de trabajo pendiente. Los cambios realizados en la página mediante el cuadro de diálogo Opciones de columna se mantienen hasta que se cambian de nuevo. En la sección de código siguiente se define la secuencia y el conjunto de columnas predeterminados.
<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>
Elemento |
Descripción |
---|---|
Columns |
Especifica una colección de elementos de Column. Elemento necesario para los elementos de la página de trabajo pendiente: PortfolioBacklog, RequirementBacklog y TaskBacklog. |
Column |
Especifica que un campo debe aparecer como una columna en una página de trabajo pendiente.
|
Encabezados de columna del panel de tareas
Los encabezados de columna que aparecen en la página del 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 del flujo de trabajo definidos para el tipo de tarea predeterminado en la categoría de tarea deben asignarse a un metaestado válido como se describe en Asignar metaestados 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 Valor empresarial al panel de trabajo pendiente del producto.
El panel solo muestra los campos incluidos en la sección FIELDS de la definición de WIT para el WIT seleccionado. Por ejemplo, si selecciona el WIT de error, solo se muestra el título, puesto que Valor empresarial no se ha definido para los errores. Para agregar otro WIT al panel, agréguelo a la categoría de requisito como se describe aquí.
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>
Elemento |
Descripción |
---|---|
AddPanel |
Elemento contenedor utilizado para especificar la experiencia de "adición rápida"; los campos que aparecerán dentro del área del panel donde se definen los nuevos elementos de trabajo pendiente. |
Fields |
Especifica una colección de elementos de Field. |
Field |
Especifica que un campo de elemento de trabajo debe aparecer dentro del panel de la página de trabajo pendiente del producto.
El mismo campo debe aparecer en el formulario del elemento de trabajo de cada WIT incluido en la categoría del trabajo pendiente. |
Cambiar el número de elementos de trabajo que pueden aparecer en el panel de tareas
Por razones de rendimiento, el panel de tareas puede mostrar un máximo de 500 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 atributo workItemCountLimit del elemento TaskBacklog.
Por ejemplo, puede aumentar el límite si agrega workItemCountLimit="800":
<TaskBacklog category="Microsoft.TaskCategory" pluralName="Tasks" singularName="Task" workItemCountLimit="800" >
. . .
</TaskBacklog>
Asignar metaestados para los tipos de elemento de trabajo específicos de la herramienta
Las asignaciones de metaestados 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 los errores en la categoría de requisito y, por tanto, define las asignaciones de metaestados 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 metaestados para los tipos de elemento de trabajo específicos de la herramienta. Vea Asignar metaestados para una categoría de tipos de elemento de trabajo para obtener información sobre la asignación de los valores y tipos de estado reales. CategoryName debe corresponder a una categoría definida para el proyecto de equipo.
Elemento |
Descripción |
---|---|
BugWorkItems |
Opcional. Elemento contenedor que define las asignaciones de metaestados para los tipos de elemento de trabajo asignados a la categoría de error. Además de controlar cómo se utilizan estas asignaciones en la presentación de las páginas de planeación Agile de TWA, también controlan cómo actualiza la característica Mi trabajo de Team Explorer el estado de los errores mientras los desarrolladores mueven los errores mediante Mi trabajo. Para obtener más información, vea Escriba el código de Nuevo para un caso de usuario.
|
FeedbackRequestWorkItems |
Requerido. No lo personalice. Elemento contenedor que define las asignaciones de metaestados para los tipos de elemento de trabajo asignados a la categoría de solicitud de comentarios.
|
FeedbackResponseWorkItems |
Requerido. No lo personalice. Elemento contenedor que define las asignaciones de metaestados para los tipos de elemento de trabajo asignados a la categoría de respuesta a comentarios.
|
TestPlanWorkItems |
Se requiere únicamente si se personaliza el estado del flujo de trabajo para un plan de pruebas y se admiten las conexiones con el proyecto de equipo de Test Manager instalado con Visual Studio 2013.2 o versiones anteriores. Elemento contenedor que define las asignaciones de metaestados para los tipos de elemento de trabajo asignados a la categoría de plan de pruebas. Por ejemplo:
|
TestSuiteWorkItems |
Se requiere únicamente si se personaliza el estado del flujo de trabajo para un conjunto de pruebas y se admiten las conexiones con el proyecto de equipo de Test Manager instalado con Visual Studio 2013.2 o versiones anteriores. Elemento contenedor que define las asignaciones de metaestados para los tipos de elemento de trabajo asignados a la categoría de conjunto de pruebas. Por ejemplo:
|
Para asignar metaestados para TestPlanWorkItems o TestSuiteWorkItems, debe actualizar su servidor de la capa de aplicación a TFS 2013.3. Posteriormente puede personalizar el estado del flujo de trabajo de los planes de pruebas y los conjuntos de pruebas.
Para obtener más información, vea Importar y exportar la configuración del proceso.
Asignar campos utilizados en herramientas de planeación y gráficos Agile
Puede cambiar los campos de elementos de trabajo que se utilizan para calcular la capacidad, los gráficos de evolución, la previsión y la velocidad. 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>
Elemento |
Descripción |
---|---|
TypeFields |
Requerido. Especifica una colección de elementos de TypeField. |
TypeField |
Requerido. 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.
Especifique el formato solo cuando type="RemainingWork". Puede especificar cualquier cadena de texto para la TimeUnitString que desea que aparezca en las barras de capacidad en la página actual del trabajo pendiente de iteración y en el panel de tareas. Para las páginas de planeación Agile:
Para el formulario de solicitud de comentarios: Nota No debe tener que cambiar las asignaciones predeterminadas creadas 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.
|
TypeFieldValues |
Necesario para TypeFieldValue cuando type="ApplicationType". Especifica una colección de elementos TypeFieldValue que se usan en el formulario de solicitud de comentarios. |
TypeFieldValue |
Requerido. No lo personalice. Especifica el nombre de un tipo de aplicación que aparecerá en el formulario de solicitud de comentarios.
Las asignaciones predeterminadas corresponden a los valores permitidos especificados en la definición de tipo para el formulario de solicitud de comentarios.
|
Notas sobre la 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 Effort, 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.
Asignar días no laborables
Los gráficos de planeación de capacidad y de evolución hacen referencia a los días festivos. Dentro de cada plantilla de proceso de TFS se definen los días festivos siguientes.
<Weekends>
<DayOfWeek>Saturday</DayOfWeek>
<DayOfWeek>Sunday</DayOfWeek>
</Weekends>
Elemento |
Descripción |
---|---|
DayOfWeek |
Elemento secundario necesario del elemento Weekends. Especifica un día de la semana correspondiente a un día no laborable.
Los nombres válidos corresponden a los días de la semana en inglés: Sunday, Monday, Tuesday, Wednesday, Thursday, Friday y Saturday. Nota Debe especificar el día de una semana en inglés, independientemente del idioma instalado de Team Foundation Server. |
Weekends |
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. Alguna nota sobre cómo aparece esto en el gráfico de evolución y no se puede quitar. |
Cambiar el color de un tipo de elemento de trabajo
De un vistazo, puede diferenciar los WIT al ver el resultado de una consulta o un trabajo pendiente según el color asignado al WIT.
Dentro de la plantilla de proceso Scrum se definen las asignaciones de color siguientes.
<WorkItemColors>
<WorkItemColor primary="FF009CCC" secondary="FFD6ECF2" name="ProductBacklogItem" />
<WorkItemColor primary="FF773B93" secondary="FFEEE2F2" name="Feature" />
<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" />
</WorkItemColors>
Elemento |
Descripción |
---|---|
WorkItemColors |
Opcional. Elemento contenedor para especificar los colores de los tipos de elemento de trabajo. |
WorkItemColor |
Especifica los colores utilizados para mostrar un WIT dentro de TWA. El color principal se utiliza en las listas y el color secundario en los paneles, como el panel de tareas o el panel kanban.
|
Preguntas y respuestas
P: ¿Cómo se personalizan otras funciones que aparecen en las herramientas de planeación de Agile en TWA?
R: Se pueden realizar algunas personalizaciones a través de la interfaz de usuario. Otras requieren la modificación de la configuración del proceso u otros objetos de proyectos de equipo. Para obtener información general, vea Configurar y personalizar herramientas de planeación ágiles para un proyecto de equipo.
P: ¿Desea trabajar con dos o más trabajos pendientes de cartera?
R: La experiencia predeterminada admite un nivel de trabajo pendiente de cartera. Puede agregar hasta cinco niveles, como se describe en Agregar un registro de trabajo pendiente a Administración de carteras Agile.
P: ¿Desea agregar o cambiar los WIT que aparecen en el panel de tareas o en el trabajo pendiente del producto?
R: Si ha agregado un WIT personalizado y desea agregarlo al trabajo pendiente o al panel de tareas, puede hacerlo. No puede aparecer en ambos lugares. Para ver cómo hacerlo, lea Agregar errores al trabajo pendiente o al panel de tareas.
P: ¿Desea ver un ejemplo que funciona para importar y exportar la configuración del proceso?
R: Se incluye un ejemplo aquí: Importar y exportar la configuración del proceso [witadmin].