Agregar o modificar un tipo de elemento de trabajo

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

El proyecto contiene varios tipos de elementos de trabajo, en función del proceso (Agile, Scrumo 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 los distintos 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. Los motivos 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 Adición o modificación de 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, otra personalización se realiza a través de la definición de configuración de proceso o a través de la herramienta de línea de comandos witadmin.

Definición de tipo de elemento de trabajo

• Agregar o modificar un campo a un tipo de elemento de trabajo existente
• Agregar un tipo de elemento de trabajo personalizado y modificar un tipo de elemento de trabajo
• Cambiar el flujo de trabajo (estados, motivos, transiciones)
• Modificación del formulario de elemento de trabajo

Definición de ProcessConfiguration

• Especificar el color del tipo de elemento de trabajo
• Especificar el icono de tipo de elemento de trabajo (TFS 2017.2 y versiones posteriores)
• Especificar el color del estado del flujo de trabajo
• Agregar o quitar un tipo de elemento de trabajo del trabajo pendiente o del panel de tareas
• Agregar un tipo de elemento de trabajo personalizado a un trabajo pendiente o una placa
• Adición de un trabajo pendiente de cartera

Cambio de línea de comandos

• Enumeración de tipos de elementos de trabajo
• Desactivación o deshabilitación de un tipo de elemento de trabajo
• Cambiar el nombre de un tipo de elemento de trabajo
• Eliminación de un tipo de elemento de trabajo

Requisitos previos

Para agregarse como administrador, consulte Adición de administradores.

¿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.

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

Importación y exportación de archivos de definición de tipo de elemento de trabajo

1. Si no tiene permisos de administración para el proyecto, obtenga .

   1. Abra una ventana del símbolo del sistema según las instrucciones proporcionadas en witAdmin: Personalizar yadministrar objetos para realizar el seguimiento del trabajo . Por ejemplo:
   %programfiles(x86)%\Microsoft Visual Studio\2017\Community\Common7\IDE\CommonExtensions\Microsoft\TeamFoundation\Team Explorer

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 .

3. Edite el archivo. Para obtener más información, vea Indexación a definiciones de elementos XML.

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 witadmin de , vea witadmin.

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ór lo importe al 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,WORKFLOWy FORM.

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 desee usar para realizar el seguimiento de los datos debe agregarse al archivo de definición. Esto es así para todos los campos del sistema, menos para los 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 si los incluye o no en la definición de tipo de elemento de trabajo. Para obtener más información sobre cada campo, vea Índice de campos 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 FORM de la definición.

Por ejemplo, para agregar el identificador de 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, vea Agregar o modificar un campo.

Modificación del flujo de trabajo

Las secciones STATES y REASONS de WORKFLOW especifican los valores de la lista de selección en los campos Estadoy 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.

Cambie el flujo de trabajo para lograr los objetivos siguientes:

• Adición o eliminación de un estado, motivo o transición
• Especificar un valor para el campo que se va a aplicar durante un cambio de estado, motivo o transición
• Especifique una acción personalizada para automatizar las asignaciones de campos en función de un cambio de estado, motivo o transición.

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

1. Modifique el FLUJO DE TRABAJO de la definición del 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 de Agile. Estos tipos de elementos 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 se establece en Activo, puede anular automáticamente los campos Closed Date y Closed By 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:

• Calificar el valor que puede tener un campo especificando CANNOTLOSEVALUE, EMPTY, FROZEN,NOTSAMEAS,READONLYy REQUIRED
• Copiar un valor en un campo mediante COPY, DEFAULTy SERVERDEFAULT
• Restringir quién puede modificar un campo
• Aplicación de la coincidencia de patrones en un campo de cadena mediante MATCH
• Aplicar condicionalmente reglas basadas en valores de otros campos mediante WHEN, WHENNOT, WHENCHANGEDy WHENNOTCHANGED
• Limitar las reglas que se van a aplicar a grupos o usuarios concretos. La mayoría de las reglas admiten losatributos para o no para centrarse en quién hace y no se aplica la regla.

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 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)

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

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 planeamiento 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 basados en la plantilla de proceso utilizada 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 Scrum, los elementos de trabajo pendiente del 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 aparecerán en el trabajo pendiente o 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, vea 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 Adición de 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 debe editar 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.

Cambiar el tipo de un elemento de trabajo existente

Consulte Movimiento, cambio o eliminación de elementos de trabajo para las características disponibles en función de la plataforma.

Al conectarse 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.

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

Desactivación o deshabilitación de 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 que quiera crearlos.

Eliminación de un tipo de elemento de trabajo

Para evitar que los miembros del equipo utilicen un tipo de elemento de trabajo específico para crear un elemento de trabajo, puede quitarlo del proyecto. Cuando se usa , se quitan permanentemente todos los elementos de trabajo creados con ese tipo de elemento de trabajo, así como el propio witadmin destroywitd* tipo de elemento de trabajo. Por ejemplo, si el equipo no usa "Impediment", puede eliminar el tipo de elemento de trabajo etiquetado como "Impediment" del proyecto de sitio web 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 del proyecto para reflejar el nuevo nombre. Para obtener más información, vea Importar, exportar y administrar tipos de elementos de trabajo e Importar y exportar categorías.

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 "Elemento de QoS" a "Contrato de servicio".

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, tendrá que actualizar la definición de categorías del proyecto para reflejar 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 trabajo e Importar y exportar categorías.

Artículos relacionados

En este artículo se ha abordado cómo agregar y personalizar tipos de elementos de trabajo para los modelos de proceso XML hospedado y XML local. 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:

• Reglas y evaluación de reglas
• Guía de tareas administrativas
• Elementos XML processConfiguration
• herramientas de línea de comandos witadmin
• Personalizar la experiencia de seguimiento del trabajo
• Personalización de tarjetas en paneles