Share via

Agregar un campo y cambiar el diseño de un tipo de elemento de trabajo existente

  • Artículo

Para hacer un seguimiento de datos adicionales para un elemento de trabajo, se puede agregar un campo a un tipo de elemento de trabajo, mostrarlo en el formulario de elemento de trabajo y hacer que sea incluido en los informes.También se puede cambiar el diseño de un formulario de elemento de trabajo para adaptarlo a las necesidades de su equipo.En este tema, Julia y Peter, miembros del equipo Fabrikam Fibra, personalizan dos tipos diferentes de elementos de trabajo para admitir sus objetivos de seguimiento.

  • Para hacer un seguimiento de dónde se originan las solicitudes para las nuevas características, Julia agrega un campo personalizado con un menú desplegable de opciones y cambia el diseño del formulario de elemento de trabajo para el elemento de trabajo pendiente del producto.Julia realiza cinco tareas para agregar un campo personalizado con una lista desplegable de opciones y cambiar el diseño del formulario de elemento de trabajo para el elemento de trabajo pendiente del producto.

  • Para mejorar el seguimiento del trabajo y mejorar la capacidad suya y del equipo de estimar el trabajo, Peter agrega un campo al tipo de elemento de trabajo de tarea.

Tal como muestra la siguiente ilustración, Julia y Peter realizan las tareas independientemente, pero en una secuencia prescrita.

Cambiar el diseño de un formulario de elemento de trabajo.

Secuencia para agregar un campo a un tipo de elemento de trabajo

Agregar un campo a un formulario de elemento de trabajo

Agregar un campo a un tipo de elemento de trabajo

Para revisar los campos de elemento de trabajo y los campos asignados como atributos para informes en las plantillas de proceso predeterminadas para Team Foundation Server, consulte Referencia de campos de elementos de trabajo para Visual Studio ALM y Referencia de campos para informe para Visual Studio ALM.

Requisitos

  • Para poder llevar a cabo este procedimiento, debe ser miembro del grupo Team Foundation Administrators o Project Administrators para el proyecto.Para obtener más información, vea Permisos de Team Foundation Server.

[!NOTA]

Si está ejecutando Windows Vista podría no tener el conjunto de permisos para ciertas carpetas.Si intenta exportar el tipo de elemento de trabajo a una ubicación para la que no tiene permisos establecidos, la tecnología de virtualización del Registro redirige automáticamente el archivo exportado y lo guarda en el almacén virtual.Para evitar esta redirección, puede exportar el archivo a una ubicación en la que tenga permisos establecidos.Para obtener más información sobre la virtualización del registro, consulte las páginas siguientes en el sitio web de Microsoft: Virtualización de registro y Problemas frecuentes de virtualización de archivos y registro en Windows Vista.

1.Exportar una definición de tipo de elemento

Cuando se descargue la definición de tipo del proyecto de equipo, asegúrese de que esté trabajando con la última versión.

[!NOTA]

Si se tienen que hacer pequeños cambios y se siente cómodo trabajando con el formato XML, se pueden modificar los archivos utilizando el Bloc de Notas u otro editor de texto.O bien, se puede utilizar el Editor de procesos, que es una herramienta eficaz que se instala como un complemento en Visual Studio.Con esta herramienta, no se tienen que importar o exportar las definiciones de tipo.En su lugar, se pueden abrir mediante el Editor de procesos y modificarlas a través de la interfaz del editor.

Se puede descargar esta eficaz herramienta en la siguiente página del sitio web de Microsoft: Herramientas avanzadas de Team Foundation Server.

Para obtener información sobre cómo descargar los archivos de esquema de las plantillas de proceso, vea Índice de definiciones de elementos XML de complementos de plantillas de procesos.

Para exportar un archivo de definición del tipo de elemento de trabajo desde un proyecto de equipo existente

  1. Para ejecutar la herramienta de la línea de comandos witadmin, abra una ventana de símbolo del sistema donde se haya instalado Visual Studio o Team Explorer y escriba:

    cd %programfiles%\Microsoft Visual Studio 11.0\Common7\IDE

    En una edición de 64 bits de Windows, reemplace %programfiles% con %programfiles(x86)%.

  2. Escriba el comando siguiente, sustituyendo los datos de los argumentos que se muestran aquí, donde urlDeColeccion especifica la dirección URL de una colección de proyectos de equipo, nombreProyecto especifica el nombre de un proyecto de equipo definido dentro de esa colección, nombreTipoItemdeTrabajo especifica el nombre del tipo de elemento de trabajo para exportar y nombredeArchivo especifica la ubicación y el nombre del archivo de definición de tipos exportada.A continuación presione la tecla Entrar .

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName

    Ejemplo: Exportar la definición del elemento de trabajo pendiente del producto

    Por ejemplo, Julia utiliza el siguiente comando para exportar la definición de tipo para su proyecto de equipo de FabrikamFiber para el elemento de trabajo pendiente del producto a FF_ProductBItem.xml.

    witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:"Product Backlog Item" /f:FF_ProductBItem.xml

    Ejemplo: Exportar la definición de la tarea

    Y Peter utiliza el siguiente comando para exportar la definición de tipo para la tarea y guardarla en el archivo denominado FF_Task.xml.

    witadmin exportwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /n:Task /f:FF_Task.xml

    Si la tarea se realiza correctamente, aparece el siguiente mensaje:

    Operación completada.

2.Agregar un campo a una definición de tipo

Para agregar un campo a una definición de tipo, se debe agregar un elemento FIELD dentro de la sección FIELDS y un elemento Control dentro de la sección FORM .Además, se recomienda cumplir las convenciones de nomenclatura establecidas para los campos.

Agregar un campo a un tipo de elemento de trabajo

  1. Busque la sección del archivo XML que define los campos del tipo y que empieza por FIELDS.

  2. Agregue el elemento FIELD que especifica el nombre del campo personalizado a agregar.Se deben especificar los atributos necesarios siguientes: name (Nombre descriptivo), refname (Nombre de referencia) y type (Tipo).Para obtener más información, vea FIELD (Definición) (Elemento).

    [!NOTA]

    El nombre de la referencia, o refname, es el nombre de programación para el campo.Las demás reglas deberían hacer referencia a este refname.Para obtener más información, vea Convenciones de nomenclatura para objetos de seguimiento de elementos de trabajo.

    Ejemplo: Agregar un campo personalizado con una lista de menú

    Por ejemplo, Julia escribe el texto siguiente para agregar el campo personalizado, Solicitante, con un nombre de referencia de FabrikamFiber.MyTeam.Requestor, a la definición de tipo del elemento de trabajo pendiente del producto.Ella también especifica la lista de selección de valores permitidos para este campo junto con el valor predeterminado del cliente de la lista.

    <FIELD name="Requestor" refname="FabrikamFiber.MyTeam.Requestor" type="String" reportable="Dimension">
   <ALLOWEDVALUES>
      <LISTITEM value="Customer" />
      <LISTITEM value="Executive Management" />
      <LISTITEM value="Other" />
      <LISTITEM value="Support" />
      <LISTITEM value="Team" />
      <LISTITEM value="Technicians" />
      <DEFAULTVALUE value="Customer" />
    </ALLOWEDVALUES>
</FIELD>

    Para obtener más información sobre listas de elección, consulte Definir listas desplegables.

    Ejemplo: Agregar un campo predefinido

    Para la definición de tipo para la tarea, Peter agrega el campo predefinido, el trabajo completado, con un nombre de referencia de Microsoft.VSTS.Scheduling.CompletedWork.

    <FIELD name="Completed Work" refname="Microsoft.VSTS.Scheduling.CompletedWork" type="Double" reportable="measure" formula="sum" />

    Para obtener una lista de todos los campos predefinidos, consulte Referencia de campos de elementos de trabajo para Visual Studio ALM.

  3. Agregue el elemento CONTROL dentro de la sección FORM de modo que el campo personalizado aparezca en el formulario de elemento de trabajo dentro del grupo de elementos donde desea que aparezca.Se debe especificar el atributo type del control.Para obtener más información, vea Referencia de elementos Control de XML.

    Ejemplo: Agregar el campo personalizado al formulario para el elemento de trabajo pendiente del producto

    Ejemplo: Agregar el elemento control para un campo

    Por ejemplo, Julia agrega el elemento Control para el campo del solicitante que aparece debajo del campo Motivo en el formulario de elemento de trabajo, como se muestra en el siguiente ejemplo de código.

    <Column PercentWidth="50">
   <Group Label="Status">
      <Column PercentWidth="100">
         <Control FieldName="System.AssignedTo" Type="FieldControl" Label="Assi&amp;gned To:" LabelPosition="Left" />
         <Control FieldName="System.State" Type="FieldControl" Label="&amp;State:" LabelPosition="Left" />
         <Control FieldName="System.Reason" Type="FieldControl" Label="Reason:" LabelPosition="Left" ReadOnly="True" />
         <Control FieldName="FabrikamFiber.MyTeam.Requestor" Type="FieldControl" Label="Requestor:" LabelPosition="Left" ReadOnly="True" />
      </Column>
   </Group>
</Column>
    SugerenciaSugerencia

    La definición de esquema para el seguimiento de elementos de trabajo establece todos los elementos secundarios del elemento FORM con la convención Camello y escribe los demás elementos en mayúsculas.Si se producen errores al validar los archivos de definición de tipos, compruebe la estructura del uso de mayúsculas y minúsculas en sus elementos.También, la estructura del uso de mayúsculas y minúsculas en las etiquetas de apertura y cierre deben ajustarse a las reglas sintácticas de XML.

    La siguiente ilustración muestra que el formulario de elemento de trabajo para el elemento de trabajo pendiente del producto contiene ahora el nuevo campo.

    Campo personalizado agregado al formulario y definición de tipo

    Ejemplo: Agregar el campo predefinido al formulario para la tarea

    Para el elemento de trabajo de tarea, Peter agrega el campo Control para que aparezca sobre el campo Trabajo restante como se muestra en el siguiente ejemplo de código:

    <Column PercentWidth="50">
   <Group Label="Details">
      <Column PercentWidth="100">
         <Control FieldName="Microsoft.VSTS.Scheduling.CompletedWork" Type="FieldControl" Label="Completed Work:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Scheduling.RemainingWork" Type="FieldControl" Label="Remaining Work:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Common.BacklogPriority" Type="FieldControl" Label="Backlog Priority:" LabelPosition="Left" />
         <Control FieldName="Microsoft.VSTS.Common.Activity" Type="FieldControl" Label="Activity:" LabelPosition="Left" />
         <Control FieldName="System.AreaPath" Type="WorkItemClassificationControl" Label="Area:" LabelPosition="Left" />
      </Column>
   </Group>
</Column>

    La siguiente ilustración muestra que el formulario de elemento de trabajo para la tarea ahora contiene el campo trabajo completado.

    Agregar trabajo completado al formulario y tipo de tarea

  4. Guardar sus cambios en el archivo de XML.

Para obtener más información sobre agregar campos de elemento de trabajo a las definiciones de tipo

3.Cambiar el diseño del formulario para los grupos de pestañas de dos columnas a una columna

Julia desea cambiar el diseño del formulario para el elemento de trabajo pendiente del producto para que el campo de descripción ocupe el ancho del formulario.Tal como muestra la siguiente ilustración, el diseño predeterminado muestra dos conjuntos de grupos de pestañas.Para cambiar el diseño en un único conjunto de grupos de pestañas, Jill necesita cambiar el elemento de la primera columna a ancho del 100 por ciento, y quitar los elementos extraños Column y TabGroup de la sección FORM .

Diseño de grupo de pestañas de dos columnas

Para cambiar el diseño del formulario de dos columnas de grupos de pestañas a una columna de grupos de pestañas

  1. Busque la sección TabGroup del archivo XML.Observe que existen elementos Tab para elementos como Descripción, Tareas, Criterios de aceptación e Historial en las que cada elemento de Tab contiene un elemento de Control que muestra el control respectivo.

    <Group>
   <Column PercentWidth="50">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
   <Column PercentWidth="50">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>

  2. Consolidar todos los elementos <Tab> . . . </Tab> en un TabGroup.Quitar Group, Column y los elementos extraños TabGroup.En el siguiente ejemplo de código se muestra la nueva estructura de sintaxis XML.

    <Group>
   <Column PercentWidth="100">
      <TabGroup>
      . . .
      </TabGroup>
   </Column>
</Group>

    [!NOTA]

    Para obtener los mejores resultados, cada control o grupo debe aparecer en una columna, aun cuando esta ocupe todo el ancho del formulario.A su vez, cada columna debe aparecer en un grupo, aun cuando este no tenga ninguna etiqueta ni límite visible.Para obtener más información, vea Diseñar y personalizar un formulario de elementos de trabajo.

    La ilustración siguiente muestra grupos de pestañas de una sola columna.

    Grupo de pestañas de una columna

  3. Guarde los cambios en el archivo de XML.

4.Importar una definición de tipo elemento de trabajo

Una vez personalizada la definición de tipo, se debe importar al proyecto de equipo para comprobar los cambios y hacer que estén disponibles para su uso.El archivo XML que importa sobrescribirá el contenido de la definición del tipo actual.El proceso de importación valida la sintaxis XML antes de la carga.

Para importar un tipo de elemento de trabajo a un proyecto de equipo existente

  • Desde la ventana del símbolo del sistema y el directorio especificado en el paso 1, 1. Exportar una definición de tipo de elemento , descrita anteriormente en este tema, escriba el comando siguiente y, a continuación, elija Entrar .

    witadmin importwitd /collection:CollectionURL /p:ProjectName /n:WorkItemTypeName /f:FileName

    Ejemplo: Importar la definición del elemento de trabajo pendiente del producto

    Por ejemplo, Jill utiliza el siguiente comando para importar la definición de tipo de su elemento de trabajo pendiente que ha exportado a FF_ProductBItem.xml al proyecto de equipo FabrikamFiber.

    witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_ProductBItem.xml

    Ejemplo: Importar la definición de tarea

    Y Peter utiliza el siguiente comando para importar la definición de tipo para la tarea que se guardaron en FF_Task.xml.

    witadmin importwitd /collection:http://julia-fabrikam:8080/tfs/Collection1 /p:"FabrikamFiber" /f:FF_Task.xml

    Si la tarea se realiza correctamente, aparece el siguiente mensaje:

    La importación de tipos de elemento de trabajo se ha completado.

5.Actualizar el proyecto de equipo y comprobar los cambios realizados a una definición de tipo

Después de importar una definición de tipo, se debe actualizar la memoria caché en el Explorador de equipos para que los cambios estén disponibles.Se debe actualizar la caché sólo si Visual Studio estaba abierto y conectado a Team Foundation Server al importar las definiciones de tipo.

Actualice el Explorador de equipos y cree un elemento de trabajo pendiente del producto

Actualizar el proyecto de equipo y comprobar los cambios

Para actualizar la memoria caché

  1. En Team Explorer, elija el botón ActualizarActualizar.

    Las últimas actualizaciones se descargan del servidor, incluso los cambios que acaba de importar.

    Espere varios segundos hasta que la actualización finalice.

  2. Elija Elementos de trabajo.

  3. Elija Nuevo elemento de trabajo y elija el tipo de elemento de trabajo que se modificó, por ejemplo Elemento de trabajo pendiente del producto o Tarea.

  4. Compruebe que los cambios realizados aparecen en el formulario de elemento de trabajo.

  5. Elija el botón Cerrar para cerrar el elemento de trabajo.Elija el botón No cuando se le pida que guarde el elemento de trabajo.