Compartir a través de


Definir el complemento de clasificación

Las clasificaciones facilitan el seguimiento, la agrupación y los informes en el trabajo basado en categorías útiles, como las características de producto relacionadas y los hitos de proyecto. Debe definir áreas en las que organizar los elementos de trabajo en categorías lógicas, físicas o funcionales. Debe definir iteraciones para agrupar elementos de trabajo en hitos o categorías de ciclo de tiempo. Por ejemplo, un equipo puede organizar el trabajo de un producto en un área de cliente, un área de servidor y un área de extensibilidad. Las iteraciones definidas determinan la cantidad de veces que un equipo repetirá un conjunto determinado de actividades importantes, como las de planeación, desarrollo y prueba.

Las clasificaciones definidas aparecen en las páginas Áreas e Iteraciones del nuevo proyecto de equipo, como se muestra en la siguiente ilustración. Se accede a esta página desde el portal web de administración.

Página Áreas de un proyecto de equipo, contexto de administración de TWA

Para abrir el contexto de administración, seleccione el icono de engranaje Configuración Icono de configuración (Team Web Access).

Elegir el icono de engranaje para abrir la administración

Para obtener información sobre cómo conectarse al portal web, acceda aquí.

Cuando se haya creado el proyecto de equipo, debe modificar las áreas y las iteraciones desde el portal web. Además, puede definir permisos para controlar el acceso a un área de proyecto o iteración.

Además de las áreas y las iteraciones, debe especificar el archivo de asignación de Microsoft Project para subirlo en el complemento Clasificación y en la propiedad de la plantilla de proceso.

Nombre y ubicación del complemento Clasificación

En la siguiente tabla se enumeran el nombre del archivo, la carpeta y el complemento de las plantillas de proceso predeterminadas:

Nombre del archivo:

Classification.xml

Nombre de la carpeta:

Clasificación

Nombre del complemento:

Microsoft.ProjectCreationWizard.Classification

Nota

Puede cambiar los nombres del archivo XML y de la carpeta pero no el del complemento.TFS no incluye ningún mecanismo para la implementación de complementos de cliente, directivas u otras modificaciones.Si desea implementar este tipo de funcionalidad, debe utilizar su propio programa de instalación y distribución.

Tareas y dependencias de Clasificación

El archivo del complemento Clasificación debe adherirse a su definición de esquemas, tal como se especifica en el archivo Css.xsd. El complemento debe especificarse en su propio archivo.

En el archivo XML, especifique una o más tareas y sus dependencias. En general, solo necesita una tarea para especificar todas las iteraciones y los nodos que necesita un proyecto de equipo.

Nota

Si modifica las áreas o las iteraciones de una plantilla de proceso, asegúrese de no romper ninguna asignación usada para las consultas de elementos de trabajo o los elementos de trabajo definidos en la plantilla de proceso.Por ejemplo, la consulta del elemento de trabajo Iteration1Backlog.wiq correspondiente a la plantilla de proceso de Agile hace referencia a la iteración 1.Para más información, vea Agregar consultas de elementos de trabajo a una plantilla de proceso.

Definir las áreas de producto iniciales

Especifique el nodo raíz de las áreas utilizando la siguiente sintaxis:

<Node StructureType="ProjectModelHierarchy" Name="Area" >

Especifique cero o más nodos secundarios para tantas áreas como desee para su proceso. Use el elemento Node para especificar cada área y establecer el atributo StructureType en ProjectModelHierarchy.

<Node StructureType="ProjectModelHierarchy" Name="NodeName" ></Node>

El siguiente ejemplo muestra cómo especificar dos áreas, Cliente y servidor:

<?xml version="1.0" encoding="utf-8" ?>
<tasks>
   <task
      id="UploadStructure"
      name="Creating project structure"
      plugin="Microsoft.ProjectCreationWizard.Classification"
      completionMessage="Portfolio project structure created.">
      <taskXml>
         <Nodes>
            <Node StructureType="ProjectModelHierarchy" Name="Teams" >
               <Children>
                  <Node StructureType="ProjectModelHierarchy" Name="Client"></Node>
                  <Node StructureType="ProjectModelHierarchy" Name="Server"></Node>
               </Children>
            </Node>
         </Nodes>
      </taskXml>
   </task>
</tasks>

Especificar las rutas de iteración iniciales

Especifique el nodo raíz de las iteraciones utilizando la siguiente sintaxis:

<Node StructureType="ProjectLifecycle" Name="NodeName" >

Especifique cero o más nodos secundarios para tantas iteraciones como desee para su proceso. Use el elemento Node para especificar cada iteración y establecer el atributo StructureType en ProjectLifecycle.

En el ejemplo siguiente se muestra cómo especificar cuatro iteraciones: Milestone 1, Milestone 2, Beta y RTM.

<?xml version="1.0" encoding="utf-8" ?>
<tasks>
   <task
      id="UploadStructure"
      name="Creating project structure"
      plugin="Microsoft.ProjectCreationWizard.Classification"
      completionMessage="Team project structure created.">
      <taskXml>
         <Nodes>
            <Node StructureType="ProjectLifecycle" Name="Iteration" >
               <Children>
                  <Node StructureType="ProjectLifecycle" Name="Sprint 1"></Node>
                  <Node StructureType="ProjectLifecycle" Name="Sprint 2"></Node>
                  <Node StructureType="ProjectLifecycle" Name="Sprint 3"></Node>
                  <Node StructureType="ProjectLifecycle" Name="Sprint 4"></Node>
               </Children>
            </Node>
         </Nodes>
      </taskXml>
   </task>
</tasks>

Especificar propiedades de la plantilla de proceso

En esta sección se especifican dos propiedades: el archivo de asignación de campos de Project a TFS y la plantilla de proceso. El archivo de asignación especifica cómo se asignan los campos de TFS a los campos definidos en Project. La segunda propiedad asocia la plantilla de proceso a un valor único. En el ejemplo siguiente se muestra la estructura de la sintaxis de esta entrada:

<properties>
   <property name="MSPROJ" 
             value="Classification\FileMapping.xml" 
             isFile="true" />
   <property name="Process Template" value="Agile"/>
</properties>

Para personalizar el archivo FileMapping.xml, vea Asignar campos de Microsoft Project a campos de Team Foundation.

Referencia del elemento del complemento Clasificación

Especifique los siguientes elementos dentro de un elemento contenedor taskXml en el archivo del complemento Clasificación. Vea Definir las tareas para procesar un complemento para obtener información sobre taskXml.

Defina áreas e iteraciones especificando una ruta de árbol de nodos anidados y nodos secundarios. Para más información, vea Agregar y modificar rutas de acceso de área e iteración.

Elemento

Descripción

Children

Children es un elemento secundario opcional de Node.

Contiene las definiciones de las áreas o iteraciones secundarias.

<Children>
    <Node> . . . </Node>
</Children>

Node

Node es un elemento secundario opcional de Nodes y Children.

Define la estructura del árbol. Utilice ProjectLifecycle para las iteraciones y ProjectModelHierarchy para las áreas. Los nombres de nodo no deben superar los 255 caracteres.

<Node StructureType="ProjectLifecycle | ProjectModelHierarchy" Name="NodeName">
   <Node> . . . </Node>
   <Children> . . . </Children>
</Node>

Nodes

Nodes es un elemento secundario obligatorio de taskXml para el complemento Classification.

Contiene las definiciones de área y de iteración.

<Nodes>
   <Node> . . . </Node>
</Nodes>

properties

Elemento secundario opcional de taskXml del complemento Classification.

<properties>
   <property />
</properties>

property

property es un elemento secundario obligatorio de properties.

Define los datos relacionados con el proyecto, tales como los datos de asignación XML para Microsoft Project.

<property name="property name" value="Classification\FileName" isFile="true | false" />

Donde las siguientes definiciones se aplican para cada atributo:

  • name: obligatorio. Define el nombre de la propiedad. Los únicos nombres válidos son MSPROJ y Process Template.

  • value: obligatorio.

    • Para MSPROJ, define la ruta de acceso relativa al archivo de asignación de campos.

    • Para Process Template, contiene el nombre del proceso que está asociado a la plantilla de proceso. Esta propiedad se agrega al archivo de clasificación al importar un proceso a Visual Studio Online.

  • isFile: opcional. Especifica si la propiedad se define en un archivo. Si el valor es true, debe existir el archivo. De lo contrario, fallará la validación de la plantilla de proceso.

Advertencia

El archivo de esquema Css.xsd no define los elementos property o properties.Al cargar la plantilla de proceso en Visual Studio Online o en TFS, se llevan a cabo comprobaciones de validación en cada elemento.

Las plantillas de proceso predeterminadas no especifican ningún nodo de área, pero sí especifican nodos de iteración, que se denominan Iteración 1, Iteración 2 e Iteración 3. Se hace referencia a los nodos de iteración en la definición de consultas de los elementos de trabajo, mientras que las tareas se definen en los complementos WorkItemTracking y Portal.

Para obtener instrucciones y restricciones de nomenclatura aplicables a las clasificaciones, vea Agregar y modificar rutas de acceso de área e iteración. Para obtener información sobre los campos que realizan un seguimiento de las áreas y las iteraciones, vea Referencia de campos de áreas e iteraciones.

Vea también

Conceptos

Agregar y modificar rutas de acceso de área e iteración