Agregar o modificar un tipo de elemento de trabajo

  • Artículo

Azure DevOps Server 2022: Azure DevOps Server 2019

El proyecto contiene varios tipos de elementos de trabajo, en función del proceso usado para crear el proyecto, como Agile, Basic, Scrum o CMMI. Un tipo de elemento de trabajo es el objeto que se usa para realizar un seguimiento de diferentes tipos de trabajo.

Nota:

Para Azure DevOps Services o para colecciones de proyectos que usan el modelo de proceso heredado, consulte Incorporación y administración de tipos de elementos 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 o atributos de campo 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 Azure DevOps Services o para colecciones que usan el modelo de proceso heredado, consulte Incorporació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 colección de proyectos Administración istrators o tener el permiso Editar proceso establecido en Permitir.

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

¿Cómo afectan las modificaciones a los tipos de elementos 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.

Action Efecto en los elementos de trabajo existentes
Quitar campos de un tipo de elemento de trabajo Los datos de los campos eliminados 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 cuyo nombre ha cambiado permanecen en el almacén de datos bajo 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 bajo 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 witadmin deletefield la 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 Importación, exportación y administración de 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.

Resumen de elementos de tipo de elemento de trabajo

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 un campo, regla de campo, etiqueta 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 cierto para todos los campos del sistema (campos cuyo nombre de referencia empieza por System.). Todos los campos del sistema se definen para todos los tipos de elementos de trabajo, tanto si se incluyen en la definición de tipo de elemento de trabajo como si no. 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 STATES y REASONS del flujo de trabajo especifican los valores de la lista de selección en los campos Estado y Motivo . Realizan un 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 las transiciones hacia delante y regresiva.

Diagrama de estado de flujo de trabajo de ejemplo, caso de usuario ágil

Cambie el flujo de trabajo para lograr los siguientes objetivos:

  • Agregar o quitar un estado, un motivo o una transición
  • Especificar un valor para el campo que se va a aplicar 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.

Al personalizar 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 metaestados.

    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 agile. Estos tipos de elemento de trabajo pertenecen a las categorías Requisito o Tarea.

Reglas de campo de flujo de trabajo

Puede aplicar reglas de campo al cambiar el estado, especificar un motivo o durante una transición de 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 Cerrada por y hacer que sean de solo lectura. Esto resulta útil al reactivar un elemento de trabajo desde un 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 siguientes acciones:

  • Calificar el valor que un campo puede tener especificando CANNOTLOSEVALUE, EMPTY, FROZEN, NOTSAMEAS, READONLY y REQUIRED
  • Copiar 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
  • Limite las reglas que se aplicarán a usuarios o grupos específicos. La mayoría de las reglas admiten o no 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 Reglas y evaluación de 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 personalizar todos ellos 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.

Captura de pantalla del elemento de encabezado dentro del formulario web de elemento de trabajo.

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 ágiles (trabajo pendiente de 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.

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.

Captura de pantalla de Los resultados de la consulta que muestran el color, el icono y el color del estado del elemento de trabajo.

Cambiar el tipo de un elemento de trabajo existente

Consulte Movimiento masivo de elementos de trabajo y cambio del tipo de elemento de trabajo para las características disponibles en función de la plataforma.

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 compartir 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 pertenezca 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, consulte Importación, exportación y administración de tipos de elementos de trabajo y 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, consulte Importación, exportación y administración de tipos de elementos de trabajo y Categorías de importación y exportación.

En este artículo se ha tratado cómo agregar y personalizar tipos de elementos de trabajo para los 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, consulte Personalización de un proceso.

Otros temas o recursos relacionados: