Referencia de elementos XML de configuración de procesos

Los archivos de configuración de proceso determinan el diseño y la funcionalidad de las siguientes características: trabajo pendiente del producto y progreso del equipo, trabajo pendiente de iteración, la capacidad, y gráficos de evolución, secretaría de la tarea, comentarios de interés, y Mi trabajo.Puede exportar estos archivos de configuración, AgileConfiguration y CommonConfiguration, del proyecto de equipo o tener acceso a la plantilla de proceso que se descarga de Visual Studio Team Foundation Server 2012.Personalice el diseño de las páginas del trabajo pendiente modificando las definiciones especificadas en AgileConfiguration, y personalizar áreas comunes a varias funciones mediante la modificación de las definiciones especificadas en CommonConfiguration.

Para obtener información general sobre las características que se pueden personalizar, vea Personalizar las páginas de panel y de trabajo pendiente mediante la configuración del proceso.

[!NOTA]

Para obtener información acerca de cómo un equipo utiliza las páginas de trabajo pendiente y de tareas de mesa, vea Iteraciones y planeación de Agile.

En este tema

• AgileConfiguration: sintaxis de estructura y de elementos

• CommonConfiguration: sintaxis de estructura y de elementos

AgileConfiguration: sintaxis de estructura y de elementos

Personalice la página del trabajo pendiente modificando los elementos contenidos dentro del elemento AgileProjectConfiguration.Para personalizar la página del trabajo pendiente del producto, modifique los elementos dentro del elemento ProductBacklog, y para personalizar las páginas del trabajo pendiente de iteración, modifique los elementos contenidos en los elementos IterationBacklog.

El siguiente ejemplo de XML muestra la estructura del código que define la configuración de proceso ágil contenida dentro del archivo de AgileConfiguration.xml.Este ejemplo corresponde a la sintaxis predeterminada definida para el MSF para Agile Software Development v6.0.

<?xml version="1.0" encoding="utf-8"?>
<AgileProjectConfiguration>
  <ProductBacklog>
    <Columns>
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.IterationPath" width="200" />
    </Columns>
    <AddPanel>
      <Fields>
        <Field refname="System.Title" />
      </Fields>
    </AddPanel>
  </ProductBacklog>
  <IterationBacklog>
    <Columns>
      <Column refname="Microsoft.VSTS.Scheduling.StoryPoints" width="50" />
      <Column refname="System.Title" width="400" />
      <Column refname="System.State" width="100" />
      <Column refname="System.AssignedTo" width="100" />
      <Column refname="Microsoft.VSTS.Scheduling.RemainingWork" width="50" />
    </Columns>
  </IterationBacklog>
</AgileProjectConfiguration>

Volver al principio

Elementos XML para las páginas del trabajo pendiente

En la tabla siguiente se describen los elementos secundarios del elemento raíz AgileProjectConfiguration.Puede usar estos elementos para especificar las columnas y los campos que deben aparecer en la página del trabajo pendiente.

Elemento	Descripción y sintaxis	Notas
AddPanel	Elemento contenedor utilizado para especificar la experiencia "adición rápida", los campos para aparecer dentro del área del panel donde se definen los nuevos elementos de trabajo pendiente. <AddPanel>     <Fields>        <Field . . . />        . . .    </Fields> </AddPanel>	Requerido.Una instancia única. Debe especificar al menos un elemento Fields. La experiencia “adición rápida” sólo aparece en la página del trabajo pendiente del producto en Team Web Access.
Column	Especifica un campo para que aparezca como una columna en una página de trabajo pendiente. <Column refname="FieldReferenceName" width="FieldWidth" />	Requerido. Para cada columna que desee que aparezca en las páginas que muestran una lista del trabajo pendiente, se debe especificar el nombre de referencia para un campo que se ha definido para el tipo de elemento de trabajo relacionado con elementos del trabajo pendiente.Debe especificar un entero positivo para el ancho del campo.
Columns	Especifica una colección de elementos de Column. <Columns>    <Column . . . />    . . . </Columns>	Requerido.Una instancia sólo para cada IterationBacklog y elementos primarios del ProductBacklog . Debe especificar las columnas que desea que aparezca en las páginas que muestran el trabajo pendiente del producto o un trabajo pendiente de iteración.
Field	Especifica un campo para que aparezca en el panel de la página del trabajo pendiente del producto. <Field refname=”FieldReferenceName” />	Requerido.Uno o más elementos contenidos dentro del elemento primario Fields . Cuando se define un elemento de trabajo para agregar el trabajo pendiente, puede especificar un valor para los campos que se enumeran en la sección AddPanel del proceso de configuración. La configuración predeterminada especifica el campo Título como único campo para mostrar, como se muestra en el siguiente ejemplo de código de muestra: <AddPanel>    <Fields>       <Field refname="System.Title" />    </Fields> </AddPanel>
Fields	Especifica una colección de elementos de Field. <Fields> <Field . . . />    . . . </Fields>	Requerido.Una instancia definida sólo para el elemento primario AddPanel. Especifique los campos que desea especificar rápidamente al agregar elementos al trabajo pendiente del producto.
IterationBacklog	Elemento contenedor utilizado para personalizar el diseño de páginas que muestran elementos de trabajo asignados a una iteración concreta. <IterationBacklog workItemCountLimit="MaximumLimit" >    <Columns> . . . </Columns>    . . .  </IterationBacklog >	Requerido.Una instancia única. Especifica el número de columnas, el ancho, y los campos que rellenan cada columna para esas páginas que muestren la lista de elementos de trabajo pendiente asignados a una iteración. De forma predeterminada, el panel de tareas se limita a un total de 500 elementos de trabajo.Puede cambiar este límite especificando un valor para el atributo workItemCountLimit .
ProductBacklog	Elemento contenedor utilizado para personalizar el diseño de la página que muestra el trabajo pendiente del producto y contiene un panel para agregar elementos de trabajo al trabajo pendiente. <ProductBacklog>    <Columns> . . . </Columns>    <AddPanel> . . . </ AddPanel> </ProductBacklog >	Requerido.Una instancia única. Especifica el número de columnas, el ancho, y los campos que rellenan cada columna para esas páginas que muestren la lista de elementos de trabajo pendiente asignados al trabajo pendiente de un producto.El trabajo pendiente del producto muestra todos los elementos activos en el trabajo pendiente, incluidos los asignados a una iteración.

Volver al principio

CommonConfiguration: sintaxis de estructura y de elementos

Personalice el panel de tareas mediante el elemento CommonProjectConfiguration, que admite varios elementos secundarios.El TypeFields especifica el campo que se utiliza en tipos de elementos de trabajo para capturar información específica.Varios de los demás elementos secundarios, por ejemplo, RequirementWorkItems, TaskWorkItems, y BugWorkItems especifican el grupo de categorías para asociar con este tipo que están referenciadas por áreas específicas de proceso de características de configuración.

El siguiente ejemplo de XML muestra la estructura del código que define la configuración del proceso común contenida dentro del archivo de CommonConfiguration.xml.Este ejemplo corresponde a la sintaxis predeterminada definida para el MSF para Agile Software Development v6.0.

<?xml version="1.0" encoding="utf-8"?>
<CommonProjectConfiguration>
  <TypeFields>
    <TypeField refname="System.AreaPath" type="Team" />
    <TypeField refname="Microsoft.VSTS.Scheduling.RemainingWork" type="RemainingWork" format="format h" />
    <TypeField refname="Microsoft.VSTS.Common.StackRank" type="Order" />
    <TypeField refname="Microsoft.VSTS.Scheduling.StoryPoints" 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>
  <RequirementWorkItems category="Microsoft.RequirementCategory" plural="Stories">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Resolved" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </RequirementWorkItems>
  <TaskWorkItems category="Microsoft.TaskCategory">
    <States>
      <State value="New" type="Proposed" />
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </TaskWorkItems>
  <BugWorkItems category="Microsoft.BugCategory">
   <States>
        <State value="Active" type="InProgress" />
        <State value="Resolved" type="Resolved" />
        <State value="Closed" type="Complete" />
      </States> 
  </BugWorkItems>
  <FeedbackRequestWorkItems category="Microsoft.FeedbackRequestCategory" plural="Feedback Requests">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackRequestWorkItems>
  <FeedbackResponseWorkItems category="Microsoft.FeedbackResponseCategory" plural="Feedback Responses">
    <States>
      <State value="Active" type="InProgress" />
      <State value="Closed" type="Complete" />
    </States>
  </FeedbackResponseWorkItems>
  <Weekends>
    <DayOfWeek>Saturday</DayOfWeek>
    <DayOfWeek>Sunday</DayOfWeek>
  </Weekends>
</CommonProjectConfiguration>

Volver al principio

Elementos XML para las áreas comunes

En la tabla siguiente se describen los elementos secundarios del elemento CommonProjectConfiguration.Estos elementos configuran áreas que soportan las páginas que muestran tanto en Team Web Access, Team Explorer y el formulario de solicitud de información.

Importante

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 la última versión de Visual Studio Team System, se han definido cinco categorías nuevas.Para obtener más información, vea Categorías, configuración de proceso, y deshabilitar la creación de tipos específicos de elementos de trabajo.

Elemento	Descripción y sintaxis	Notas
BugWorkItems	Especifica la categoría que corresponde a los elementos de trabajo asociados a los errores y estados de flujo de trabajo de los elementos del trabajo pendiente con los metastates. <BugWorkItems category=”CategoryName”>     <States>        <State . . . />        . . .    </States> </BugWorkItems	Requerido.El CategoryName debe corresponder a una categoría definida para el proyecto de equipo.
DayOfWeek	Especifica un día de la semana correspondiente a un día festivo. <DayOfWeek>NameOfADay</DayOfWeek>	Secundario necesario del elemento Weekends. Los nombres válidos corresponden a los días en inglés de la semana: 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.
FeedbackResponseWorkItems	Especifica la categoría que corresponde a los tipos de elemento que se utilizan para capturar respuesta de retroalimentación y asociados de los estados de flujo de trabajo de estos artículos con los metastates.	Requerido.No personalizar. El CategoryName debe corresponder a un grupo de categorías definidas para el proyecto de equipo.
FeedbackRequestWorkItems	Especifica la categoría que corresponde a los tipos de elemento que se utilizan para capturar las solicitudes de retroalimentación y asocia los estados de flujo de trabajo de estos elementos con los metastates.	Requerido.No personalizar. El CategoryName debe corresponder a un grupo de categorías definidas para el proyecto de equipo.Especifique los grupos de categorías mediante el archivo de Categories.xml.
RequirementWorkItems	Especifica la categoría que corresponde a elementos del trabajo pendiente, como las historias de usuario, los requisitos y elementos del trabajo pendiente de productos y asocia los estados de flujo de trabajo de los elementos del trabajo pendiente con los metastates. <RequirementWorkItems category="CategoryName" plural="NameOfBacklogItems" >    <States>       <State . . . />       . . .    </States> </RequirementWorkItems>	Requerido. El CategoryName debe corresponder a un grupo de categorías definidas para el proyecto de equipo.Especifique los grupos de categorías mediante el archivo de Categories.xml.
State	Asigna a un estado de flujo de trabajo a un metastate.Metastates representa una agrupación de estados de flujo de trabajo que admiten la administración de estados de flujo de trabajo en el panel de tareas u otros componentes del proceso de configuración. <State type="TypeName" value="ValueName"/>	Requerido. Los valores válidos para TypeName corresponden a un valor asignado a STATE dentro del flujo de trabajo definido para los tipos de elementos de trabajo que se encuentran en el grupo de categorías, respectivamente. Los valores válidos para ValueName corresponden a uno de los siguientes valores enumerados: dentro del flujo de trabajo definido para los tipos de elementos de trabajo que se encuentran en el grupo de categorías, respectivamente. Ágil: Proposed: Indica los elementos de trabajo que son nuevos, aún no confirmados, o aún no se han trabajado. 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. Error: Además de los metastates ágiles, incluye el metastate Resolved que indica los errores que se han sido resueltos. Retroalimentación: Requested, Received, Reviewed, y Declined. Para obtener más información, vea Estados de flujo de trabajo, metastates, y configuración de proceso.
States	Especifica una colección de elementos State que asocia los estados de flujo de trabajo de los tipos de elementos de trabajo con los metastates. <States>    <State . . . />    . . . </States>	Elemento necesario para BugWorkItems, FeedbackResponseWorkItems, FeedbackRequestWorkItems, RequirementWorkItems y los elementos TaskWorkItems . Los elementos State se utilizan para asignar los estados del flujo de trabajo a los metastates.
TaskWorkItems	Especifica la categoría que corresponde a los elementos de tarea y asociados de los estados de flujo de trabajo de tareas con los metastates. <TaskWorkItems category="CategoryName">    <States>       <State . . . />       . . .    </States> </TaskWorkItems>	Requerido. El CategoryName debe corresponder a un grupo de categorías definidas para el proyecto de equipo.Puede especificar grupos de categorías utilizando el archivo Categories.xml. Las páginas de trabajo pendiente y del panel muestran los elementos de trabajo que corresponden a los valores de estados especificados en el elemento States.
TypeField	Especifica el nombre de referencia de un campo cuyo valor está referenciado a apoyar un tipo de actividad para un área de características compatibles.Especifique este elemento dentro del elemento contenedor TypeFields . <TypeField refname=”FieldReferenceName” type=”NameOfType” [format="{0} TimeUnitString"] / > Especificar el formato sólo es válido cuando type="RemainingWork".Puede especificar cualquier cadena de texto para el 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.	Requerido.Debe especificar los campos que corresponden a los campos que se utilizan dentro de los tipos de elementos de trabajo para capturar información específica. Para las páginas del panel de tareas y de trabajo pendiente: Activity: Se utiliza para admitir la característica de la capacidad por actividad.Especifique un campo definido por el tipo de tarea de elemento de trabajo que se utiliza para especificar el tipo de actividad a realizar. Effort: Especifica el campo utilizado para calcular la velocidad del equipo.Especifique un campo definido para el tipo de trabajo pendiente de elemento de trabajo que se utiliza para capturar el nivel de esfuerzo o la clasificación relativa de la cantidad de trabajo que un elemento de trabajo pendiente requerirá implementar. Order: Especifica el campo utilizado para definir el orden de los elementos del trabajo pendiente de iteración y páginas del panel de tareas.Especifique el campo que utiliza para capturar la prioridad relativa asignada a los elementos de trabajo pendiente.Los elementos de trabajo se muestran en la página según el orden ascendente tal como se define en el campo para este tipo. RemainingWork: Especifica el campo utilizado para calcular gráficos de trabajo restante y de evolución.Especifique el campo que utiliza para capturar el número de horas o días que quedan para finalizar una tarea. El valor especificado para format se utiliza en las páginas del trabajo pendiente y del panel de tareas donde el trabajo restante se informa.Por ejemplo, al informar sobre capacidad por actividad o capacidad por los miembros del equipo, o del encabezado de columna para los estados de tarea en el panel de tareas. Para TimeUnitString, especifique cualquier cadena de texto que desea utilizar para reflejar el tiempo, como horas o días. Por ejemplo, los siguientes valores son válidos: format="{0} h" format="{0} hours" format="hours {0}" format="time {0}" Team: Especifica el campo utilizado para asociar las páginas del trabajo pendiente y del panel de tareas con un equipo.Este campo debe permanecer establecido en su valor predeterminado, System.AreaPath. Para el formulario de solicitud de retroalimentación: Nota No debería tener que cambiar las asignaciones predeterminadas creadas para los siguientes elementos TypeField.Estas asignaciones corresponden a los campos utilizados para capturar información correspondiente en el tipo de solicitud de retroalimentación del elemento de trabajo. ApplicationStartInformation: Especifica el campo utilizado para capturar la ruta para ejecutar la aplicación. ApplicationLaunchInstructions: Especifica el campo utilizado para capturar instrucciones de lanzamiento. ApplicationType: Especifica el campo utilizado para capturar el tipo de aplicación.Los tipos que aparecen corresponden a los valores permitidos especificados en la definición del tipo de la solicitud de retroalimentación.
TypeFields	Especifica una colección de elementos de TypeField. <TypeFields>    <TypeField . . . />    . . . </TypeFields>	Requerido. Debe especificar los tipos de campos que desea que se hagan referencia a admitir las características que aparecen en el trabajo pendiente, el panel de tareas, y el formato de la solicitud de retroalimentación.
TypeFieldValue	Especifica el nombre de un tipo de aplicación que aparezca en el formulario de solicitud de comentarios. <TypeFieldValue value="ApplicationTypeName" type="TypeApp"/>	Requerido.No personalizar. Las asignaciones predeterminadas corresponden a los valores permitidos especificados en la definición del tipo para el formato de la solicitud de retroalimentación. <TypeFieldValues>    <TypeFieldValue value="Web application" type="WebApp" />    <TypeFieldValue value="Remote machine" type="RemoteMachine" />    <TypeFieldValue value="Client application" type="ClientApp" /> </TypeFieldValues>
TypeFieldValues	Especifica una colección de elementos de TypeFieldValue. <TypeFieldValues>    <TypeFieldValue . . . />    . . . </TypeFieldValues>	Requerido para el TypeFieldValue cuando type="ApplicationType". Debe especificar los valores para los tipos de campos que desea que aparezcan en el formulario de solicitud de información.
Weekends	Elemento contenedor utilizado para especificar los días no laborables. <Weekends>    <DayOfWeek> . . . </DayOfWeek >    . . . </ Weekends >	Opcional. Especifique los días festivos cuando quiere tener en cuenta los días festivos en el cálculo de las gráficas de la capacidad y la evolución.

Volver al principio

Vea también

Referencia

Administrar la configuración de proceso [witadmin]

Conceptos

Actualizar un proyecto de equipo actualizado para tener acceso a nuevas características

Personalizar las páginas de panel y de trabajo pendiente mediante la configuración del proceso