Compartir a través de


Uso de plantillas de elementos de trabajo

Azure DevOps Services | Azure DevOps Server | Azure DevOps Server 2022

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

Las plantillas de elemento de trabajo le ayudan a crear rápidamente elementos de trabajo con valores rellenados previamente para los campos usados habitualmente. Puede usar plantillas de elementos de trabajo para crear elementos de trabajo o realizar actualizaciones masivas en varios elementos de trabajo. En este artículo se describe cómo agregar y administrar plantillas de elementos de trabajo desde el portal web o desde Visual Studio 2015 o versiones anteriores. Para obtener ejemplos que muestran cómo usar las plantillas de elemento de trabajo, vea Plantillas de elemento de trabajo de ejemplo.

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

Requisitos previos

Requisito previo Description
Permisos - Para administrar plantillas de elementos de trabajo en el portal web, sea miembro del equipo propietario de las plantillas. Después, puede agregar, editar o eliminar plantillas según sea necesario.
- Para usar plantillas de elemento de trabajo en el portal web, sea colaborador del proyecto. A continuación, puede aplicar plantillas a elementos de trabajo existentes.
Herramientas - Para agregar, capturar o editar plantillas de elementos de trabajo mediante Visual Studio Team Explorer, instale Microsoft Visual Studio Team Foundation Server 2015 Power Tools. Estas plantillas solo aparecen en la vista de Team Explorer.

Tareas de plantilla admitidas

La disponibilidad de las opciones de tarea de plantilla depende de la configuración del cliente y de la plataforma. Agregue y administre plantillas de elementos de trabajo desde el portal web o desde Visual Studio 2015 o versiones anteriores.

En la tabla siguiente se muestra la compatibilidad con tareas en el portal web y Visual Studio 2015 o versiones anteriores. Si usa los vínculos de descripción de la tarea para ir a las secciones correspondientes, asegúrese de seleccionar la versión de contenido (pestaña) en la sección de la configuración de la plataforma, según corresponda.

Tarea Plantilla Portal web 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 ✔️

Restricciones para usar plantillas

Las plantillas definidas en el portal web son distintas de las plantillas definidas a través de Visual Studio.

  • Las plantillas del portal web solo se pueden administrar y aplicar a elementos de trabajo a través del portal web.
  • Las plantillas de Visual Studio solo se pueden administrar, ver y aplicar a elementos de trabajo en Visual Studio.

Sin embargo, puede usar las direcciones URL de ambos tipos de plantilla para agregar elementos de trabajo a través del portal web.

Captura de un elemento de trabajo como plantilla

En función de la plataforma, la versión y el cliente que use, es posible que tenga que seguir diferentes pasos para capturar un elemento de trabajo. En las secciones siguientes se proporcionan procedimientos para el portal web y Visual Studio 2015 y versiones anteriores.

Azure DevOps asigna un identificador GUID único a cada plantilla capturada a través del portal web. Use el procedimiento siguiente para capturar un elemento de trabajo como plantilla a través del portal web y acceder a un vínculo para la plantilla guardada:

  1. En el portal web, abra un elemento de trabajo que usará como base para una 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 el cuadro de diálogo Capturar plantilla , configure los campos obligatorios y los campos opcionales:

    • Equipo: (Obligatorio) Use la lista desplegable para seleccionar un equipo existente para asociarlo a la plantilla capturada.

    • Nombre: (Obligatorio) Escriba un nombre para la plantilla.

    • Campos: use la acción Agregar para agregar campos, la acción Eliminar para quitar campos y ajuste cualquier campo específico Valor según sea necesario.

    • Notas: seleccione dentro del cuadro para agregar más información sobre la plantilla. Al seleccionar dentro del cuadro, se muestran las herramientas de edición. Al crear un nuevo elemento de trabajo a partir de la plantilla capturada, la información se agrega 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 capturar la dirección URL de la plantilla.

    Use la dirección URL siempre que desee añadir un elemento de trabajo del mismo tipo con los valores predeterminados. Estos son algunos ejemplos:

    • Cree un elemento de trabajo basado en la plantilla capturada pegando el vínculo url en una ventana del explorador.
    • Comparta la dirección URL con otros usuarios para su propio uso al agregar elementos de trabajo.
    • Agregue la dirección URL como hipervínculo a una wiki del proyecto.
    • Agregue la dirección URL a un widget de Markdown en un panel de equipo.

Administre plantillas de elementos de trabajo.

Para cada tipo de elemento de trabajo, puede ver y administrar las plantillas definidas por el equipo. Realice varias acciones en las plantillas, como agregar, editar, copiar, eliminar o cambiar el nombre, y obtener un vínculo a la plantilla.

Use el procedimiento siguiente para acceder a las plantillas de elementos de trabajo a través del portal web:

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

  2. En la sección Paneles , seleccione Configuración del equipo. Si necesita cambiar a otro equipo, use el selector equipo en la ruta de navegación de la página.

  3. En la página Paneles , seleccione la sección Plantillas :

    Captura de pantalla que muestra cómo acceder a la lista de plantillas guardadas en Azure DevOps desde la configuración de Project, Boards, Team configuration, Templates.

  4. 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 elemento de trabajo Error.

Crear una plantilla de elemento de trabajo

Use el procedimiento siguiente para crear una plantilla de elemento de trabajo a través del portal web:

  1. En la página de tipo de elemento de trabajo, seleccione Nueva plantilla para crear una plantilla desde cero:

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

    Nota:

    Si tiene previsto usar Markdown en un campo de texto grande, puede agregar <br> etiquetas para administrar saltos de línea y asegurarse de que markdown se representa correctamente.

  2. En el cuadro de diálogo Nueva plantilla , escriba un nombre para la plantilla (obligatorio) y, opcionalmente, agregue campos con los valores necesarios.

  3. Haga clic en Guardar. La opción Copiar vínculo está disponible. Puede usar esta dirección URL para crear elementos de trabajo basados en la plantilla.

Después de guardar una plantilla, puede editar o eliminar la plantilla, crear un vínculo que se pueda compartir con la plantilla o crear una copia de la plantilla.

En la página tipo de elemento de trabajo, seleccione Más acciones para una plantilla existente y, a continuación, seleccione una opción de menú:

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

  • Editar: para actualizar la plantilla, seleccione Editar, realice los cambios y seleccione Guardar.

  • Eliminar: para quitar la plantilla, seleccione Eliminar. En el cuadro de diálogo de confirmación, seleccione Eliminar. Después de eliminar una plantilla, no se puede recuperar.

  • Copiar vínculo: para obtener una copia de la dirección URL de la plantilla, seleccione Copiar vínculo. Use la dirección URL siempre que desee añadir un elemento de trabajo del mismo tipo con los valores predeterminados. Puede guardar la dirección URL como un archivo de texto, agregarla a una página web como hipervínculo, copiar el vínculo a una red compartida o enviarlo a su equipo por correo electrónico. Además, considere la posibilidad de agregar un vínculo al panel del equipo.

  • Crear copia: para realizar una copia de la plantilla, seleccione Crear copia. Escriba un nombre para la copia de plantilla y, opcionalmente, agregue, quite y actualice campos. Seleccione Guardar cuando haya terminado.

Agregar un elemento de trabajo mediante una plantilla

El enfoque más común para agregar un elemento de trabajo mediante una plantilla es abrir el vínculo de plantilla dentro de una ventana del explorador.

  1. Para obtener el vínculo de plantilla, consulte la sección Editar, eliminar, copiar, crear copia.

  2. Para crear el nuevo elemento de trabajo, pegue el vínculo de plantilla en una ventana del explorador, configure los campos necesarios y guarde los cambios.

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

Puede aplicar una plantilla a un elemento de trabajo nuevo o existente o realizar una actualización masiva de varios elementos de trabajo existentes.

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

Aplicar una plantilla dentro de un elemento de trabajo

Use el procedimiento siguiente para aplicar una plantilla a un elemento de trabajo nuevo o existente:

  1. Abra un nuevo elemento de trabajo o un elemento de trabajo existente que desee actualizar mediante los campos definidos dentro de una 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 seleccionada. Los cambios de campo se indican en el campo Historial de elementos de trabajo.

Aplicar una plantilla a varios elementos de trabajo

Use el procedimiento siguiente para aplicar una plantilla a los elementos de trabajo seleccionados para una actualización masiva:

  1. Seleccione los elementos de trabajo de la lista Trabajos pendientes o Consultas . Todos los elementos de trabajo que seleccione deben ser del 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 automáticamente y los elementos de trabajo se guardan. Los cambios de campo se indican 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.

Agregar o quitar etiquetas de plantillas

En Visual Studio 2015 o versiones anteriores, puede agregar etiquetas a una plantilla y se aplican al elemento de trabajo cuando se usa la plantilla. Para agregar dos o más etiquetas, separe con una coma (,). Esta tarea no está disponible 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 que se van a quitar, todas las etiquetas presentes en un elemento de trabajo permanecerán definidas. Las etiquetas permanecen definidas incluso cuando se aplica una plantilla de elemento de trabajo a un elemento de trabajo existente.

En Visual Studio 2015 o versiones anteriores, puede especificar una plantilla de elemento de trabajo que defina varios valores de campo mediante la sintaxis siguiente. Puede usar la dirección URL siempre que quiera agregar un elemento de trabajo del mismo tipo con valores predefinidos. Esta tarea no está disponible en el portal web.

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}&
. . .

Por ejemplo, el código siguiente especifica una tarea de elemento de trabajo con titleTaskTitle. La sintaxis especifica valores para los campos Assigned To, Description, Tags, Activity y Iteraation Path .

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 a un panel de información o a una página web como hipervínculo.

Puede agregar vínculos a un widget de Markdown en el panel del equipo en el portal web. Estos vínculos abren un elemento de trabajo con los campos definidos por la plantilla predefinidos.

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

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

Para obtener más información, consulte Adición de Markdown a un panel, widgets de Markdown.