Uso de plantillas de elementos de trabajo

Servicios de Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022

Visual Studio 2022 | Visual Studio 2019 | Visual Studio 2017 | Visual Studio 2015

Use plantillas de elemento de trabajo para crear rápidamente elementos de trabajo con valores de campo predefinidos y aplicar actualizaciones coherentes en varios elementos. En este artículo se explica cómo agregar y administrar plantillas en el portal web y, para entornos heredados, en Visual Studio 2015 o versiones anteriores. Para obtener ejemplos, consulte Plantillas de elementos de trabajo de ejemplo.

Use el portal web para la experiencia de Azure DevOps actual. Use Visual Studio 2015 con Power Tools solo cuando el entorno todavía dependa de la administración de plantillas basada en Team Explorer.

Las plantillas de elemento de trabajo son diferentes de las plantillas de proceso. Para obtener más información, vea Acerca de los procesos y las plantillas de proceso y los artículos de plantillas de proceso predeterminados para Basic, Agile, Scrum y Capability Maturity Model Integration (CMMI).

Elección del flujo de trabajo

Use esta tabla para elegir el flujo de trabajo adecuado.

Si quieres... Use... Por qué
Capturar, administrar y aplicar plantillas en la experiencia actual Portal web (principal) Las plantillas con ámbito de equipo se administran en Azure DevOps.
Reutilización de los valores predeterminados administrados centralmente para un tipo de equipo y elemento de trabajo Plantillas guardadas Los miembros del equipo pueden detectar y reutilizar las plantillas.
Uso compartido de un vínculo rápido que abre un nuevo elemento de trabajo con valores predefinidos Direcciones URL de plantilla Ideal para compartir fácilmente en cuadros de mando, wikis o mensajes.
Continuar un flujo de trabajo heredado basado en Team Explorer Visual Studio 2015 con Power Tools (heredado) Solo se aplica cuando el entorno todavía depende de las herramientas heredadas.

Requisitos previos

Requisito previo Description
Flujo de trabajo del portal web (principal) - Acceso a una organización y un proyecto de Azure DevOps.
- Para administrar plantillas, sea miembro del equipo que posee las plantillas.
- Para usar plantillas, tenga acceso de colaborador al proyecto.
- Use un explorador compatible y abra Azure DevOps en el portal web.
flujo de trabajo de Visual Studio 2015 (heredado) - Use este flujo de trabajo solo cuando el entorno siga dependiendo de la administración de plantillas de Team Explorer.
- Instale Microsoft Visual Studio Team Foundation Server 2015 Power Tools.
- Las plantillas capturadas en este flujo de trabajo tienen ámbito de usuario y solo aparecen en Team Explorer.

Restricciones para usar plantillas

Las plantillas definidas en el portal web son independientes de las plantillas definidas en Visual Studio.

Tipo de plantilla Scope Dónde puedes gestionarlo y aplicarlo
Plantilla de portal web Ámbito de equipo Solo en el portal web
plantilla de Visual Studio Ámbito de usuario Solo Visual Studio

Puede usar la dirección URL de cualquier tipo de plantilla para agregar elementos de trabajo a través del portal web.

Tareas de plantilla admitidas

La disponibilidad de las tareas de plantilla depende de la configuración del cliente y de la plataforma. Use el portal web para el flujo de trabajo de Azure DevOps principal. Use Visual Studio 2015 solo con Power Tools para escenarios heredados.

En la tabla siguiente se resume la disponibilidad de tareas en el portal web y en el flujo de trabajo de Visual Studio heredado.

Tarea de plantilla Portal de internet Visual Studio
Captura de un elemento de trabajo como plantilla ✔️ ✔️
Administre plantillas de elementos de trabajo
(Definir, editar, eliminar, copiar vínculo, crear copia y cambiar el nombre)
✔️ ✔️
Copia del vínculo (DIRECCIÓN URL) de una plantilla ✔️ ✔️
Agregar un elemento de trabajo mediante una plantilla ✔️ ✔️
Definir una plantilla de elemento de trabajo ✔️ ✔️
Aplicar una plantilla a uno o varios elementos de trabajo ✔️ ✔️
Agregar o quitar etiquetas de plantillas ✔️
Definición de una plantilla con un hipervínculo ✔️

Captura de un elemento de trabajo como plantilla

Use el procedimiento que coincida con el cliente: portal web (principal) o Visual Studio 2015 y versiones anteriores (heredado).

Cada plantilla que capture en el portal web obtiene un GUID único. Siga estos pasos para capturar un elemento de trabajo como plantilla y copiar su vínculo.

  1. En el portal web, abra el elemento de trabajo que desea usar como origen de plantilla.

  2. A la derecha, seleccione Más acciones>Plantillas>Capturar:

    Captura de pantalla que muestra cómo seleccionar las definiciones de campo de elemento de trabajo de captura como una opción de plantilla en el menú Más acciones.

  3. En Plantilla de captura, configure los campos obligatorios y opcionales:

    • Equipo (obligatorio): seleccione el equipo que se va a asociar a la plantilla.

    • Nombre (obligatorio): escriba un nombre de plantilla.

    • Campos: use Agregar para incluir campos, Eliminar para quitar campos y establecer el valor del campo según sea necesario.

    • Notas: Agregar contexto de plantilla. Al crear un elemento de trabajo a partir de la plantilla, este texto aparece como la primera entrada del subproceso discusión .

    Captura de pantalla que muestra cómo configurar campos en el cuadro de diálogo Capturar plantilla en el portal web.

  4. Seleccione Guardar y, a continuación, seleccione Copiar vínculo para copiar la dirección URL de la plantilla.

    Use la dirección URL para crear elementos de trabajo del mismo tipo con valores predefinidos. Para ver escenarios comunes de uso compartido, consulte Creación de un elemento de trabajo a partir de una dirección URL de plantilla y Adición de un vínculo de plantilla a un panel de equipo.

  5. Compruebe que la plantilla aparece en la lista de plantillas del equipo seleccionado para ese tipo de elemento de trabajo y el vínculo copiado abre un nuevo formulario de elemento de trabajo con valores predefinidos.

Administre plantillas de elementos de trabajo.

Para cada tipo de elemento de trabajo, puede ver y administrar plantillas definidas por el equipo. Puede agregar, editar, copiar, eliminar, cambiar el nombre y copiar un vínculo de plantilla.

Siga estos pasos para abrir plantillas de elementos de trabajo en el portal web:

  1. En el portal web, abra Configuración del proyecto.

  2. En Paneles, seleccione Configuración del equipo.

  3. Si necesita un equipo diferente, use el selector Equipo en la ruta de navegación.

  4. En la página Paneles, seleccione Plantillas:

    Screenshot que muestra cómo obtener acceso a la lista de plantillas guardadas en Azure DevOps desde la configuración del proyecto, Paneles, Configuración del equipo, Templates.

  5. Seleccione un tipo de elemento de trabajo, como Error, Característica o Caso de prueba, para ver o agregar plantillas para ese tipo:

    Captura de pantalla de las plantillas definidas para el tipo de ítem de trabajo Bug.

Crear una plantilla de elemento de trabajo

Siga estos pasos para crear una plantilla de elemento de trabajo en el portal web:

  1. En la página tipo de elemento de trabajo, seleccione Nueva plantilla:

    Captura de pantalla que muestra cómo agregar una nueva plantilla para el tipo de elemento de trabajo Bug.

    Nota:

    Si planeas usar Markdown en un campo de texto amplio, añade las etiquetas <br> para controlar los saltos de línea y asegurarte de que Markdown se procese correctamente.

  2. En el cuadro de diálogo Nueva plantilla , escriba un nombre (obligatorio) y agregue los campos y valores opcionales.

  3. Haga clic en Guardar. La opción Copiar vínculo está disponible.

  4. Seleccione Copiar vínculo para copiar la dirección URL de la plantilla.

  5. Compruebe que la plantilla aparece para el tipo de elemento de trabajo seleccionado y que el vínculo copiado abre un nuevo formulario de elemento de trabajo con valores de plantilla.

Después de guardar una plantilla, puede actualizarla, quitarla, copiar su vínculo o crear una copia.

En la página tipo de elemento de trabajo, seleccione Más acciones para una plantilla y, a continuación, elija una de estas opciones:

Captura de pantalla de las opciones de menú Más acciones para una plantilla seleccionada.

  1. Compruebe que la lista de plantillas refleja la acción (valores actualizados, elemento cambiado de nombre, plantilla copiada o plantilla eliminada).

  2. Compruebe que el vínculo Copiar abre un nuevo formulario de elemento de trabajo con los valores de plantilla esperados.

Agregar un elemento de trabajo mediante una plantilla

Use el vínculo de plantilla en un explorador para crear un elemento de trabajo con valores predefinidos.

  1. Obtener el enlace de la plantilla. Para obtener más información, vea Editar, eliminar, copiar vínculo, crear copia.

  2. Pegue el vínculo de plantilla en un explorador, complete los campos obligatorios y guarde los cambios.

  3. Compruebe que se abre el nuevo elemento de trabajo con valores definidos por la plantilla rellenados antes de guardarlo.

Aplicación de una plantilla a elementos de trabajo nuevos o existentes

Aplique una plantilla a un elemento de trabajo nuevo o existente o use una plantilla para actualizaciones masivas.

En el portal web, puede aplicar una plantilla en un elemento de trabajo abierto o en los elementos de trabajo seleccionados.

Aplicar una plantilla dentro de un elemento de trabajo

Siga estos pasos para aplicar una plantilla a un elemento de trabajo nuevo o existente:

  1. Abra un elemento de trabajo nuevo o existente que quiera actualizar con valores definidos por la plantilla.

  2. Seleccione Más plantillas de acciones> y, a continuación, seleccione el nombre de una plantilla predefinida:

    Captura de pantalla que muestra cómo aplicar una plantilla a un elemento de trabajo existente dentro del formulario.

    Nota:

    En la lista Plantillas se muestran las plantillas definidas para los equipos de los que es miembro. Si la lista está vacía, es posible que no haya ninguna plantilla para el tipo de elemento de trabajo. Actualice el explorador para detectar las plantillas disponibles más recientes.

  3. Seleccione Guardar para aplicar la plantilla. Los cambios de campo se registran en el campo Historial de elementos de trabajo.

  4. Compruebe que los campos se actualizan en el formulario y el historial del elemento de trabajo registra los cambios guardados.

Aplicar una plantilla a varios elementos de trabajo

Siga estos pasos para aplicar una plantilla a los elementos de trabajo seleccionados para una actualización masiva:

  1. Seleccione elementos de trabajo del Backlog o de una lista de resultados de Consultas. Todos los elementos seleccionados deben ser el mismo tipo de elemento de trabajo, como Error o Característica.

  2. Seleccione Más plantillas de acciones> para uno de los elementos de trabajo seleccionados y seleccione la plantilla que desea aplicar.

    Captura de pantalla que muestra cómo aplicar una plantilla a varios elementos de trabajo para una actualización masiva.

    Los cambios de campo se aplican y se guardan automáticamente. Los cambios de campo se registran en el campo Historial de elementos de trabajo. Para obtener más información sobre las actualizaciones masivas, consulte Modificación masiva de elementos de trabajo.

  3. Compruebe que cada elemento de trabajo seleccionado muestra los valores de campo actualizados y las entradas del historial correspondientes.

Agregar o quitar etiquetas de plantillas

En Visual Studio 2015 o versiones anteriores, puede agregar etiquetas a una plantilla. Cuando se usa la plantilla, las etiquetas se aplican automáticamente al elemento de trabajo. Para agregar dos o más etiquetas, separe con una coma (,). No se pueden agregar etiquetas en el portal web.

Captura de pantalla del cuadro de diálogo Editar plantilla que muestra cómo agregar o quitar etiquetas.

Si no especifica etiquetas para quitar, todas las etiquetas de un elemento de trabajo permanecen definidas. Las etiquetas permanecen definidas incluso cuando se aplica una plantilla de elemento de trabajo a un elemento de trabajo existente.

Compruebe en Visual Studio que la plantilla conserva las etiquetas configuradas y los elementos de trabajo aplicados incluyen esas etiquetas después de guardar.

Creación de un elemento de trabajo a partir de una dirección URL de plantilla

Cree una dirección URL que abra un nuevo elemento de trabajo con valores de campo predefinidos. Use este enfoque cuando desee un acceso directo compartido a una configuración de elemento de trabajo común.

Use plantillas guardadas para los valores predeterminados reutilizables administrados por el equipo. Usa URL de plantilla cuando compartir enlaces directos sea la experiencia principal.

  • Use plantillas guardadas cuando el equipo necesite valores predeterminados administrados centralmente.
  • Utilice URL de plantilla cuando necesite compartir fácilmente en paneles de control, wikis o mensajes.
https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/<Work_Item_Type>?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

En el ejemplo siguiente se crea un elemento de trabajo Task con Title, Assigned To, Description, Tags, Activity y Iteration Path predefinidos.

https://dev.azure.com/<Organization_Name>/<Project_Name>/_workItems/create/Task?
[System.Title]=TaskTitle&
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1
http://<Server_Name>:8080/tfs/DefaultCollection/<Project_Name>/_workItems/create/Task?
[System.AssignedTo]=Jamal+Hartnett&
[System.Description]=<p>Always+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.</p>&
[System.Tags]=Web;+Phone;+Service&
[Microsoft.VSTS.Common.Activity]=Development&
[System.IterationPath]=Fabrikam+Fiber%5CIteration+1

Nota:

Algunos clientes del explorador imponen un límite de 2000 caracteres para los valores de campo.

Puede guardar la dirección URL como un archivo de texto o agregarla como hipervínculo en un panel o página web.

Compruebe que al abrir la dirección URL se carga el tipo de elemento de trabajo correcto y se muestran los valores de campo predefinidos en el nuevo formulario de elemento de trabajo.

Agregue vínculos de plantilla a un widget de Markdown en el panel del equipo en el portal web. Cada vínculo abre un nuevo elemento de trabajo con valores de plantilla predefinidos.

En el ejemplo siguiente se muestra un widget de Markdown con vínculos a tres plantillas:

Captura de pantalla de un widget de Markdown con vínculos a plantillas.

Para conocer los pasos de configuración, consulte Adición de Markdown a un panel, widgets de Markdown.

Solución de problemas de plantilla

  • El menú Plantillas no aparece: compruebe que tiene acceso al proyecto y que usa el flujo de trabajo admitido por el cliente.
  • La lista de plantillas está vacía en el portal web: confirme que existen plantillas para el tipo de elemento de trabajo seleccionado y que es miembro del equipo que posee las plantillas. Actualice el explorador para cargar las plantillas más recientes.
  • No se puede administrar una plantilla de equipo: compruebe que es miembro del equipo que posee la plantilla.
  • No se puede aplicar una plantilla a varios elementos de trabajo: confirme que todos los elementos de trabajo seleccionados son el mismo tipo de elemento de trabajo.
  • Las opciones de plantilla de Visual Studio no están disponibles: compruebe que usa el flujo de trabajo heredado de Visual Studio 2015 y que Microsoft Visual Studio Team Foundation Server 2015 Power Tools está instalado.
  • Se abre la dirección URL de plantilla sin valores esperados: confirme que cada nombre de referencia de campo es válido para el tipo de elemento de trabajo de destino y que los valores están codificados con dirección URL (por ejemplo, espacios como + o %20).
  • Dirección URL de plantilla no se puede cargar: confirme que la dirección URL usa el tipo de organización, proyecto y elemento de trabajo correctos y que ha iniciado sesión en una cuenta con acceso al proyecto.
  • Algunos campos de una plantilla no se rellenan: confirme que los campos siguen existiendo en el tipo de elemento de trabajo y no están restringidos por reglas de personalización de procesos.