Agregar una instancia de elemento de trabajo a una plantilla de proceso
TFS 2017 | TFS 2015 | TFS 2013
Nota
Esta característica ha quedado en desuso para TFS 2018 y versiones posteriores. La definición de instancias de elementos de trabajo es opcional. Las plantillas de proceso predeterminadas no contienen ninguna instancia de elemento de trabajo. Para TFS 2018 y versiones posteriores, se omitirán todas las instancias de elemento de trabajo que defina.
Al agregar elementos de trabajo a la plantilla de proceso, se define un conjunto de tareas u otros elementos que actúan como recordatorios para que cada administrador de proyectos realice una vez creado el proyecto. Por ejemplo, puede crear una tarea para asignar permisos a los miembros del equipo, definir hitos y áreas de producto, configurar definiciones de compilación y determinar la estrategia de bifurcación para el control de versiones.
Definición de una instancia de elemento de trabajo
Para definir una instancia de elemento de trabajo, especifique el tipo de elemento de trabajo junto con los valores de campo de dichos elementos de trabajo. Use los elementos WI y FIELD que se encuentran dentro del elemento WORKITEMS. Especifique el conjunto de instancias de elemento de trabajo dentro de un elemento taskXml en el archivo de complemento WorkItemTracking.
El atributo type del elemento WI especifica qué tipo de elemento de trabajo se está creando, como tarea, caso de usuario o problema. Debe asignar valores a cada campo obligatorio en función del tipo de elemento de trabajo.
En el ejemplo siguiente se especifica una tarea de elemento de trabajo que recuerda a los administradores de proyecto que deben asignar los miembros del equipo a uno o varios grupos de seguridad. Los valores se asignan a todos los campos obligatorios. Dado que las instancias de elemento de trabajo dependen de las definiciones de tipo de los elementos de trabajo, debe especificar la tarea para crear instancias de elemento de trabajo después de la tarea para crear tipos de elemento de trabajo.
<task id="WIT_Instances" name="Work Item tasks definitions" plugin="Microsoft.ProjectCreationWizard.WorkItemTracking" completionMessage="Work item instances created">
<dependencies>
<dependency taskId="WITs" />
</dependencies>
<taskXml>
<WORKITEMS>
<WI type="Task">
<FIELD refname="System.Title" value="Setup: Set Permissions" />
<FIELD refname="System.IterationPath" value="$$PROJECTNAME$$\Iteration 0" />
<FIELD refname="System.State" value="Active" />
<FIELD refname="System.Reason" value="New" />
<FIELD refname="System.Description" value="Using the admin UI in Visual Studio adds team members to one of the three groups: Project administrators, Contributors, or Readers." />
</WI>
</WORKITEMS>
</taskXml>
</task>
Elementos WORKITEMS
La sintaxis siguiente muestra la estructura del elemento WORKITEMS y sus elementos secundarios. Estos elementos se especifican dentro de un elemento taskXml en el archivo de complemento WorkItemTracking.
<WORKITEMS>
<WI type="TypeA">
<FIELD refname="Field1" value="Value1" />
<FIELD refname="Field2" value="Value2" />
. . .
<FIELD refname="FieldN" value="ValueN" />
</WI>
. . .
</WORKITEMS>
| Elemento | Descripción y sintaxis |
|---|---|
| CAMPO | Elemento secundario requerido de WI. Especifica el nombre de referencia de un campo y el valor que se va a asignar a ese campo.<FIELD refname="FieldReferenceName" value="Value" /> |
| HIPERVÍNCULO | Elemento secundario opcional de WI. Define un hipervínculo para la instancia del elemento de trabajo. Puede especificar true o falsepara la ruta de acceso relativa.<HYPERLINK URL="URL" relativePath="false" /> |
| WI | Elemento secundario requerido de WORKITEMS. Define el tipo de elemento de trabajo que se va a crear y los valores que se asignan a campos específicos. |
| WORKITEMS | Elemento secundario opcional del elemento taskXml para el complemento WorkItemTracking. Contiene una colección de elementos WI que definen una instancia de elemento de trabajo. |