Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
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 elementos de trabajo para crear elementos de trabajo con valores predefinidos y aplicar actualizaciones coherentes en elementos similares. En este artículo se tratan los flujos de trabajo de plantilla 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.
Para la mayoría de los equipos, use el portal web. Use Visual Studio 2015 solo con Power Tools cuando siga confiando en la administración de plantillas basada en Team Explorer.
Las plantillas de elemento de trabajo son diferentes de las plantillas de proceso. Para obtener información general, consulte Acerca de los procesos y plantillas de proceso y la guía de proceso predeterminada para Basic, Agile, Scrum y Capability Maturity Model Integration (CMMI).
Tip
Puede utilizar la inteligencia artificial para ayudar con esta tarea más adelante en este artículo, o consulte Habilitar la asistencia de IA con Azure DevOps MCP Server para comenzar.
Elección del flujo de trabajo
Use esta tabla para elegir el mejor flujo de trabajo para su escenario.
| Si quieres... | Use... | Por qué |
|---|---|---|
| Crear, administrar y aplicar plantillas en la Azure DevOps actual | Portal web (principal) | Admite plantillas con ámbito de equipo en la experiencia web estándar. |
| Reutilización de los valores predeterminados compartidos por tipo de equipo y elemento de trabajo | Plantillas guardadas | Ayuda a los equipos a aplicar valores y campos coherentes. |
| Compartir un enlace directo que abre un elemento de trabajo previamente rellenado | Direcciones URL de plantilla | Ideal para compartir contenido de forma ágil en paneles de control, wikis y chat. |
| Continuar los flujos de trabajo de plantilla basados en Team Explorer | Visual Studio 2015 con Power Tools (heredado) | Use solo cuando el entorno siga dependiendo de las herramientas heredadas. |
Requisitos previos
| Workflow | Requisitos |
|---|---|
| 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 aplicar plantillas, tenga acceso de colaborador al proyecto. - Use un explorador compatible y abra Azure DevOps en el portal web. |
| Visual Studio 2015 con Power Tools (heredado) | - Use este flujo de trabajo solo si el entorno todavía depende de la administración de plantillas de Team Explorer. - Instale Microsoft Visual Studio Team Foundation Server 2015 Power Tools. - Las plantillas creadas en este flujo de trabajo tienen ámbito de usuario y solo aparecen en Team Explorer. |
Restricciones para usar plantillas
Las plantillas del portal web y las plantillas de Visual Studio son almacenes independientes. Una plantilla creada en un cliente no aparece en el otro cliente.
| Tipo de plantilla | Scope | Dónde puedes administrarlo | Dónde puede aplicarlo |
|---|---|---|---|
| Plantilla de portal web | Ámbito de equipo | Portal de internet | Portal de internet |
| plantilla de Visual Studio | Ámbito de usuario | Visual Studio | Visual Studio |
Todavía puede usar la dirección URL de cualquier tipo de plantilla para crear elementos de trabajo en el portal web.
Tareas de plantilla admitidas
La disponibilidad de tareas depende del cliente que use. Use el portal web para flujos de trabajo de Azure DevOps principales y use Visual Studio 2015 con Power Tools solo para escenarios heredados.
En la tabla siguiente se muestra la compatibilidad con el cliente.
| Tarea de plantilla | Portal de internet | Visual Studio |
|---|---|---|
| Captura de un elemento de trabajo como plantilla | ✅ Soportado | ✅ Soportado |
|
Administre plantillas de elementos de trabajo (Definir, editar, eliminar, copiar vínculo, crear copia y cambiar el nombre) |
✅ Soportado | ✅ Soportado |
| Copia del vínculo (DIRECCIÓN URL) de una plantilla | ✅ Soportado | ✅ Soportado |
| Agregar un elemento de trabajo mediante una plantilla | ✅ Soportado | ✅ Soportado |
| Definir una plantilla de elemento de trabajo | ✅ Soportado | ✅ Soportado |
| Aplicar una plantilla a uno o varios elementos de trabajo | ✅ Soportado | ✅ Soportado |
| Agregar o quitar etiquetas de plantillas | ❌ No es compatible | ✅ Soportado |
| Definición de una plantilla con un hipervínculo | ✅ Soportado | ❌ No es compatible |
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.
En el portal web, abra el elemento de trabajo que desea usar como origen de plantilla.
A la derecha, seleccione
Más acciones>Plantillas>Capturar: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 .
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.
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:
En el portal web, abra Configuración del proyecto.
En Paneles, seleccione Configuración del equipo.
Si necesita un equipo diferente, use el selector Equipo en la ruta de navegación.
En la página Paneles, seleccione Plantillas:
Seleccione un tipo de elemento de trabajo, como Error, Característica o Caso de prueba, para ver o agregar plantillas para ese tipo:
Crear una plantilla de elemento de trabajo
Siga estos pasos para crear una plantilla de elemento de trabajo en el portal web:
En la página tipo de elemento de trabajo, seleccione
Nueva plantilla:
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.En el cuadro de diálogo Nueva plantilla , escriba un nombre (obligatorio) y agregue los campos y valores opcionales.
Haga clic en Guardar. La opción Copiar vínculo está disponible.
Seleccione Copiar vínculo para copiar la dirección URL de la plantilla.
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.
Editar, eliminar, copiar vínculo o crear copia
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:
Editar: seleccione Editar, actualice la plantilla y, a continuación, seleccione Guardar.
Eliminar: seleccione Eliminar y confirme. Las plantillas eliminadas no se pueden recuperar.
Vínculo de copia: seleccione Copiar vínculo para copiar la dirección URL de la plantilla. Para obtener opciones de uso compartido, consulte Crear un elemento de trabajo a partir de una dirección URL de plantilla y Agregar un vínculo de plantilla a un panel de equipo.
Crear copia: seleccione Crear copia, escriba un nombre, ajuste opcionalmente los campos y, a continuación, seleccione Guardar.
Compruebe que la lista de plantillas refleja la acción (valores actualizados, elemento cambiado de nombre, plantilla copiada o plantilla eliminada).
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.
Obtener el enlace de la plantilla. Para obtener más información, vea Editar, eliminar, copiar vínculo, crear copia.
Pegue el vínculo de plantilla en un explorador, complete los campos obligatorios y guarde los cambios.
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:
Abra un elemento de trabajo nuevo o existente que quiera actualizar con valores definidos por la plantilla.
Seleccione
Más plantillas de acciones> y, a continuación, seleccione el nombre de una plantilla predefinida:
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.
Seleccione Guardar para aplicar la plantilla. Los cambios de campo se registran en el campo Historial de elementos de trabajo.
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:
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.
Seleccione
Más plantillas de acciones> para uno de los elementos de trabajo seleccionados y seleccione la plantilla que desea aplicar.
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.
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.
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.
Agregar un vínculo de plantilla a un panel de equipo
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:
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.
Usar IA para crear y aplicar plantillas de elementos de trabajo
Si configura el Azure DevOps servidor MCP, puede describir las tareas relacionadas con la plantilla en lenguaje natural en lugar de realizar cada paso manualmente en el portal web o Team Explorer.
Considere las siguientes indicaciones como ejemplos de situaciones. Las operaciones disponibles pueden variar según la versión del servidor MCP, las herramientas habilitadas y los permisos.
Antes de ejecutar una instrucción, sustituya los marcadores de posición por valores de su entorno: <ProjectName>, <TeamName>, <TemplateName>, <WorkItemId> y <IterationPath>.
| tarea | Mensaje de ejemplo |
|---|---|
| Creación de una plantilla a partir de un elemento | Capture work item <WorkItemId> in project <ProjectName> as a template named "Security bug" for team <TeamName> |
| Creación de una plantilla | Create a Bug template named "Regression" for team <TeamName> in project <ProjectName> with Priority 2 and tag "regression" |
| Aplicar una plantilla a un elemento | Apply the "<TemplateName>" template to work item <WorkItemId> in project <ProjectName> |
| Aplicación masiva de una plantilla | Apply the "<TemplateName>" template to all active Bugs tagged "regression" in project <ProjectName> |
| Creación de elementos de trabajo a partir de una plantilla | Create 5 Bugs in project <ProjectName> for team <TeamName> using the "<TemplateName>" template with the titles I provide |
| Generación de una dirección URL de plantilla | Generate a template URL that creates a Task in project <ProjectName> with Activity=Development and Iteration=<IterationPath> |
| Actualizar una plantilla | Update the "<TemplateName>" template for team <TeamName> in project <ProjectName> to set Severity to 2 - High |
| Copia de una plantilla | Create a copy of the "<TemplateName>" template named "Regression - Mobile" for team <TeamName> in project <ProjectName> |
| Buscar equipos sin plantilla | List teams in project <ProjectName> that don't have a Bug template defined |
| Auditar el uso de plantillas | Show which work items in iteration <IterationPath> were created from the "<TemplateName>" template in project <ProjectName> |
Nota:
Si usa Visual Studio Code, el modo de agente es especialmente útil para las operaciones complejas de plantilla.