Agregar o modificar un tipo de elemento de trabajo

Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018

El proyecto contiene varios tipos de elementos de trabajo, según el proceso (Agile, Scrum o CMMI) que se usa para crear el proyecto. Un tipo de elemento de trabajo es el objeto que se usa para realizar un seguimiento de diferentes tipos de trabajo.

Puede modificar un tipo de elemento de trabajo existente o agregar un tipo de elemento de trabajo personalizado en función de los requisitos de seguimiento o los procesos de flujo de trabajo del equipo. Las razones más comunes para modificar un tipo de elemento de trabajo son agregar o modificar el conjunto de campos o reglas de campo, cambiar el flujo de trabajo o personalizar el formulario de elemento de trabajo.

Consulte Agregar o modificar un campo si desea agregar un campo personalizado o modificar las reglas de campo o los atributos de un campo existente.

La mayoría de las personalizaciones de tipo de elemento de trabajo se realizan en la definición XML del tipo de elemento de trabajo; sin embargo, se realizan otras personalizaciones a través de la definición de configuración del proceso o a través de la herramienta de línea de comandos witadmin .

Nota:

Para obtener Azure DevOps Services o para colecciones que usan el modelo de proceso heredado, consulte Adición y administración de tipos de elementos de trabajo.

Definición de tipo de elemento de trabajo

Definición de ProcessConfiguration

Cambio de línea de comandos

Requisitos previos

  • Para enumerar los tipos de elementos de trabajo, debe tener el permiso Ver información de nivel de proyecto para el proyecto en el conjunto de recopilación en Permitir.
  • Para agregar o personalizar un tipo de elemento de trabajo personalizando una plantilla de proceso, debe ser miembro del grupo administradores de recopilación de Project o tener el permiso Editar proceso establecido en Permitir.
  • Para enumerar los tipos de elementos de trabajo, debe tener el permiso Ver información de nivel de proyecto para el proyecto en el conjunto de recopilación en Permitir.
  • Para agregar o personalizar un tipo de elemento de trabajo, debe ser miembro del grupo administradores de Project o tener el permiso Editar información de nivel de proyecto establecido en Permitir.

Para agregarse como administrador, consulte Cambio de permisos de nivel de colección de proyectos.

¿Cómo afectan las modificaciones a los tipos de elemento de trabajo existentes?

En la tabla siguiente se resume el efecto en los elementos de trabajo existentes al modificar campos o definiciones de tipo de elemento de trabajo.

Acción Efecto en los elementos de trabajo existentes
Quitar campos de un tipo de elemento de trabajo Los datos de los campos que se han quitado permanecen en el almacén de datos. Sin embargo, no se pueden agregar nuevos datos, ya que los ha quitado de la definición de tipo de elemento de trabajo.
Cambiar el nombre de un campo Los datos de los campos cuyos nombres se han cambiado permanecen en el almacén de datos con el nuevo nombre descriptivo.
Eliminación de campos Los datos de los campos eliminados se quitan del almacén de datos.
Cambiar el nombre de un tipo de elemento de trabajo Todos los datos permanecen intactos con el nuevo nombre.
Eliminar un tipo de elemento de trabajo Todos los datos de los elementos de trabajo creados como el tipo de elemento de trabajo eliminado se quitan permanentemente sin posibilidad de recuperación.

Si desea quitar completamente los campos del almacén de datos, use la witadmin deletefield herramienta de línea de comandos.

Importar y exportar archivos de definición de tipo de elemento de trabajo

Nota:

Si usa el modelo de proceso XML hospedado, debe importar y exportar la plantilla de proceso usada por el proyecto. Para obtener más información, consulte Personalización del formulario web de seguimiento de elementos de trabajo.

  1. Si no tiene permisos de administración para el proyecto, consíguelos.

    1. Abra una ventana del símbolo del sistema según las instrucciones proporcionadas en witAdmin: Personalizar y administrar objetos para realizar el seguimiento del trabajo. Por ejemplo:
  2. Exporte el archivo de definición de tipo de elemento de trabajo donde desea modificar o agregar un campo. Especifique el nombre del tipo de elemento de trabajo y un nombre para el archivo.

    witadmin exportwitd /collection:CollectionURL /p:ProjectName /n:TypeName /f:"DirectoryPath/FileName.xml"

    Un ejemplo de collectionURL es http://MyServer:8080/tfs/TeamProjectCollectionName.

  3. Edite el archivo. Para obtener más información, consulte Index to XML element definitions (Index to XML element definitions).

  4. Importe el archivo de definición.

    witadmin importwitd /collection:CollectionURL /p:ProjectName /f:"DirectoryPath/FileName.xml"

  5. Abra el portal web o actualice la página para ver los cambios.

    Para obtener más información sobre el uso witadminde , vea Importar, exportar y administrar tipos de elementos de trabajo.

Agregar o modificar un tipo de elemento de trabajo

Para agregar un tipo de elemento de trabajo personalizado o modificar un tipo de elemento de trabajo existente, defina o modifique el archivo de definición XML y, a continuación, impórtelo en el proyecto en función del modelo de proceso que use. Para modificar un tipo de elemento de trabajo, especifique los elementos definidos en las tres secciones principales del archivo de definición: FIELDS, WORKFLOW y FORM.

Summary of work item type elements

La manera más fácil de agregar un nuevo tipo de elemento de trabajo es copiar un tipo de elemento de trabajo existente y, a continuación, modificar el archivo de definición.

Agregar o modificar campos, reglas de campo, etiquetas o texto vacío

Cualquier campo que quiera usar para realizar un seguimiento de los datos debe agregarse al archivo de definición. Esto es así para todos los campos del sistema pero (campos cuyo nombre de referencia empieza por System.). Todos los campos del sistema se definen para todos los tipos de elementos de trabajo, independientemente de que los incluya o no en la definición de tipo de elemento de trabajo. Para obtener más información sobre cada campo, consulte Índice de campo de elemento de trabajo.

Agregue campos y reglas de campo a la sección CAMPOS . Para que el campo aparezca en el formulario de elemento de trabajo, también debe agregarlo a la sección FORMULARIO de la definición.

Por ejemplo, para agregar el identificador del elemento de trabajo a un formulario, especifique la siguiente sintaxis XML dentro de la FORM sección .

<Control FieldName="System.ID" Type="FieldControl" Label="ID" LabelPosition="Left" />

Para obtener más información sobre cómo definir campos, consulte Agregar o modificar un campo.

Modificación del flujo de trabajo

Las secciones ESTADOS y RAZONES del flujo de trabajo especifican los valores de la lista de selección en los campos Estado y Motivo . Realizan el seguimiento del estado de los elementos de trabajo. La sección TRANSITIONS especifica las transiciones válidas entre estados, como se muestra en la ilustración siguiente. Especifique tanto las transiciones hacia delante como las regresivas.

Example workflow state diagram, Agile user story

Cambie el flujo de trabajo para lograr los objetivos siguientes:

  • Agregar o quitar un estado, un motivo o una transición
  • Especificar un valor para que el campo se aplique durante un cambio en estado, motivo o transición
  • Especifique una acción personalizada para automatizar las asignaciones de campos en función de un cambio en el estado, el motivo o la transición.

Cuando personalice el flujo de trabajo, siga estos dos pasos:

  1. Modifique el flujo de trabajo de la definición de tipo de elemento de trabajo.

  2. Modifique la configuración del proceso para asignar nuevos estados de flujo de trabajo a metastates.

    Este segundo paso es necesario cuando se cambia el flujo de trabajo de un tipo de elemento de trabajo que aparece en una página de herramientas de Agile. Estos tipos de elemento de trabajo pertenecen a las categorías Requisito o Tarea.

Reglas de campo de flujo de trabajo

Se pueden aplicar reglas de campo cuando se cambia el estado, se especifica un motivo o durante una transición del flujo de trabajo.

Por ejemplo, si agrega la regla EMPTY cuando el estado está establecido en Activo, puede anular automáticamente los campos Fecha cerrada y Cerrado por y convertirlos en de solo lectura. Esto resulta útil cuando se reactiva un elemento de trabajo en estado cerrado.

<STATE value="Active">
   <FIELDS>
. . .
      <FIELD refname="Microsoft.VSTS.Common.ClosedDate"><EMPTY/></FIELD>
      <FIELD refname="Microsoft.VSTS.Common.ClosedBy"><EMPTY/></FIELD>
   </FIELDS>
</STATE>  

Aplique reglas de campo de flujo de trabajo para realizar las acciones siguientes:

  • Califica el valor que un campo puede tener especificando CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY y REQUIRED
  • Copia de un valor en un campo mediante COPY, DEFAULT y SERVERDEFAULT
  • Restringir quién puede modificar un campo
  • Exigir la coincidencia de patrones en un campo de cadena mediante MATCH
  • Aplicar condicionalmente reglas basadas en valores de otros campos mediante WHEN, WHENNOT, WHENCHANGED y WHENNOTCHANGED
  • Limitar las reglas que se van a aplicar a grupos o usuarios concretos. La mayoría de las reglas admiten ono atributos para centrarse en quién hace la regla y no se aplica.

Para obtener más información sobre cómo aplicar reglas de campo de flujo de trabajo, vea Referencia de elementos FIELD (Flujo de trabajo) y Evaluación de reglas y reglas.

Personalizar el formulario del elemento de trabajo

En las ilustraciones siguientes se resaltan los elementos más comunes en los formularios de elementos de trabajo. Puede personalizarlos todos excepto el área de título y los controles de formulario. Los elementos que use para personalizar el formulario dependen de si el administrador ha habilitado o no el nuevo formulario.

Formulario web con el nuevo formulario habilitado (VSTS, TFS 2017)

Header element within web form

Formulario web antiguo en uso (TFS 2015, TFS 2013)

Work item type form controls

Puede personalizar el formulario para lograr los siguientes objetivos:

Agregar o quitar un tipo de elemento de trabajo del trabajo pendiente o del panel de tareas

Las herramientas de planeación de Agile (trabajo pendiente del producto, trabajo pendiente de sprint y páginas del panel de tareas) muestran tipos de elementos de trabajo específicos en función de la plantilla de proceso que se usa para crear el proyecto. Puede agregar o quitar tipos de elementos de trabajo para que aparezcan en estas páginas. Por ejemplo, si el proyecto usa tipos de elementos de trabajo de Scrum, los elementos de trabajo pendiente de producto y los errores aparecen en las páginas de trabajos pendientes. Sin embargo, si el proyecto se creó con agile, CMMI u otra plantilla de proceso, los errores no aparecen en el trabajo pendiente ni en el panel de tareas.

Por ejemplo, puede agregar errores desde la página de trabajo pendiente del producto.

Nota:

Las imágenes que ve desde el portal web pueden diferir de las imágenes que se ven en este artículo. Estas diferencias se derivan de las actualizaciones realizadas en Azure DevOps Services o en la implementación local. Sin embargo, la funcionalidad básica disponible para usted sigue siendo la misma a menos que se mencione explícitamente.

This screen shows how to add bugs from the product backlog page.

Para obtener información sobre cómo agregar o quitar tipos de elementos de trabajo del trabajo pendiente o del panel de tareas, consulte Agregar un tipo de elemento de trabajo a un trabajo pendiente y un panel. Para agregar un nuevo tipo de elemento de trabajo para admitir un trabajo pendiente de cartera, consulte Agregar un nivel de trabajo pendiente de cartera.

Cambiar el color, el icono o el color de estado del flujo de trabajo de un tipo de elemento de trabajo

En el portal web, los elementos de trabajo aparecen en los resultados de la consulta y en las páginas de trabajo pendiente y panel de las herramientas de Agile. Para cambiar el color o el icono asociado a un tipo de elemento de trabajo existente o agregar el color que se usará para un nuevo tipo de elemento de trabajo, edite la configuración del proceso. Para cambiar el color de un estado de flujo de trabajo, también edita la configuración del proceso.

Nota:

Disponibilidad de características: Para XML local, puede personalizar el color de estado del flujo de trabajo para TFS 2015.2 o versiones posteriores, y puede personalizar el icono de tipo de elemento de trabajo para TFS 2017.2 y versiones posteriores.

Query results showing work item type color, icon, and state color

Cambiar el tipo de un elemento de trabajo existente

Consulte Mover, cambiar o eliminar elementos de trabajo para las características disponibles en función de la plataforma.

Cuando se conecta a TFS, no puede cambiar el tipo de elemento de trabajo de un elemento de trabajo existente, pero puede copiar el elemento de trabajo y especificar un nuevo tipo. Por ejemplo, puede copiar un elemento de trabajo pendiente del producto existente y cambiar el tipo a error, como se muestra en la ilustración siguiente.

Clone a work item type

Además, si tiene varios elementos de trabajo con cambios de tipo que desea realizar, es posible que quiera exportarlos mediante Excel y, a continuación, volver a agregarlos como un nuevo tipo.

Desactivar o deshabilitar un tipo de elemento de trabajo

Si desea restringir la creación de un tipo de elemento de trabajo específico a un grupo de usuarios, agregue el tipo de elemento de trabajo al grupo Categorías ocultas para evitar que la mayoría de los colaboradores los creen. Si desea permitir el acceso a un grupo de usuarios, puede crear un hipervínculo a una plantilla que abra el formulario de elemento de trabajo y comparta ese vínculo con los miembros del equipo a los que desea crearlos.

Nota:

No se pueden agregar reglas de campo para restringir el flujo de trabajo, ya que no se pueden aplicar reglas a los campos del sistema.

Eliminar un tipo de elemento de trabajo

Para evitar que los miembros del equipo usen un tipo de elemento de trabajo específico para crear un elemento de trabajo, puede quitarlo del proyecto. Cuando se usa witadmin destroywitd*, se quitan permanentemente todos los elementos de trabajo creados con ese tipo de elemento de trabajo, así como el propio tipo de elemento de trabajo. Por ejemplo, si el equipo no usa "Impedimento", puede eliminar el tipo de elemento de trabajo etiquetado como "Impedimento" del proyecto de sitio web de Fabrikam.

witadmin destroywitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"Impediment" 

Al eliminar un tipo de elemento de trabajo que pertenece a una categoría, debe actualizar la definición de categorías para que el proyecto refleje el nuevo nombre. Para obtener más información, vea Importar, exportar y administrar tipos de elementos de trabajoy categorías de importación y exportación.

Cambiar el nombre de un tipo de elemento de trabajo

Para cambiar el nombre de un tipo de elemento de trabajo existente, use witadmin renamewitd. Por ejemplo, puede cambiar el nombre de un tipo de elemento de trabajo con la etiqueta "QoS Item" a "Service Agreement".

witadmin renamewitd /collection:"http://FabrikamPrime:8080/tfs/DefaultCollection" /p:"Fabrikam Web Site" /n:"QoS Item" /new:"Service Agreement"

Al cambiar el nombre de un tipo de elemento de trabajo que pertenece a una categoría, debe actualizar la definición de categorías para que el proyecto refleje el nuevo nombre. En concreto, los trabajos pendientes y los paneles no funcionarán hasta que actualice la definición de categorías.

Para obtener más información, vea Importar, exportar y administrar tipos de elementos de trabajoy categorías de importación y exportación.

Habilitación de características después de la actualización

¿Qué personalizaciones puede realizar y seguir usando el Asistente para configurar características para actualizar mi proyecto después de una actualización de TFS?

Puede agregar tipos de elementos de trabajo personalizados y cambiar el diseño del formulario. El Asistente para configurar características actualizará los proyectos y obtendrá acceso a las características más recientes.

Cambiar el flujo de trabajo o cambiar el nombre de un tipo de elemento de trabajo puede requerir que realice algunas operaciones manuales al actualizar el proyecto. Para obtener información sobre otras personalizaciones que puede realizar de forma segura y que debe evitar, consulte Personalización de la experiencia de seguimiento del trabajo: Antes de personalizar, comprenda las implicaciones de mantenimiento y actualización.

Cambios de flujo de trabajo y versiones anteriores del cliente de Test Manager

Al cambiar el flujo de trabajo para el plan de prueba o el conjunto de pruebas, y trabaja desde un cliente de Test Manager proporcionado con Visual Studio 2013.2 o versiones anteriores, estos tipos de elementos de trabajo estuvieron disponibles cuando actualizó el servidor de nivel de aplicación a TFS 2013.3. que aparece en una página de herramienta de planeación de Agile.

Si se detecta un error inesperado en la aplicación al conectarse al proyecto después de cambiar el flujo de trabajo, puede resolverlo asignando los nuevos estados de flujo de trabajo a los metastates. Para resolver este error, consulte Configuración del proceso de importación y exportación.

En este artículo se ha tratado cómo agregar y personalizar tipos de elementos de trabajo para modelos de procesos XML hospedados y XML locales. Para obtener información sobre cómo agregar y personalizar tipos de elementos de trabajo para el modelo de proceso heredado, vea Personalizar un proceso.

Otros temas o recursos relacionados: