Uso de plantillas para agregar y actualizar elementos de trabajo en Azure Boards y Visual Studio

Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018

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

Con las plantillas de elemento de trabajo, puede crear rápidamente elementos de trabajo que tengan valores rellenados previamente para los campos que se usan habitualmente en el equipo. Por ejemplo, cree una plantilla que defina la ruta de acceso del área, la ruta de acceso de iteración y la actividad que se van a usar al crear una tarea.

Puede usar plantillas de elementos de trabajo para crear elementos de trabajo o actualizar de forma masiva varios elementos de trabajo. Para obtener ejemplos que muestran el uso de plantillas de elementos de trabajo, consulte Plantillas de elementos de trabajo de ejemplo.

Nota

Las plantillas de elemento de trabajo son distintas de las plantillas de proceso. Para obtener información sobre las plantillas de proceso, vea Elegir una plantilla de proceso o estos temas específicos para las plantillas de proceso predeterminadas: Basic, Agile, Scrum o CMMI.

Tareas de plantilla admitidas

La disponibilidad de las opciones de tarea de plantilla depende de la versión de cliente y plataforma disponible. Agregue y administre plantillas de elementos de trabajo desde el portal web o desde Visual Studio 2015 o versiones anteriores. Visual Studio 2015 y versiones anteriores admiten el trabajo con plantillas mediante la instalación de Microsoft Visual Studio Team Foundation Server 2015 Power Tools. Estas plantillas solo aparecen en la vista de Team Explorer.

Como se muestra en la tabla siguiente, indica ✔️ que la tarea está disponible desde el portal web o desde Visual Studio 2015 o versiones anteriores. (Asegúrese de que ha seleccionado la versión de contenido en función de la versión de la plataforma).

---

Task

Portal web

Visual Studio 2015

---

Captura de un elemento de trabajo como plantilla

✔️

✔️

---

Administrar plantillas de elementos de trabajo
(Definir, editar, eliminar, copiar vínculo, crear copia y cambiar el nombre)

✔️

✔️

---

Copiar vínculo (DIRECCIÓN URL) de una plantilla

✔️

✔️

---

Agregar un elemento de trabajo mediante una plantilla

✔️

✔️

---

Definición de 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 mediante un hipervínculo

✔️

---

Sugerencia

Las plantillas que defina a través del portal web son distintas de las que define 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. De forma similar, las plantillas de Visual Studio solo se pueden administrar, visualizar 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.

Requisitos previos

• Para agregar, capturar, editar o eliminar plantillas de elementos de trabajo a través del portal web, debe ser miembro del equipo en el que los agregue.

• Para aplicar una plantilla de elemento de trabajo, debe ser colaborador del proyecto y miembro del equipo en el que se define la plantilla de elemento de trabajo.

• Para agregar, capturar, editar o eliminar plantillas de elementos de trabajo a través del portal web, debe ser administrador del equipo.

• Para aplicar una plantilla de equipo, debe ser colaborador del proyecto y miembro del equipo en el que se define la plantilla de elemento de trabajo.

• Para agregar, capturar o editar plantillas de elementos de trabajo a través de Visual Studio Team Explorer, instale Microsoft Visual Studio Team Foundation Server 2015 Power Tools. Estas plantillas solo aparecen en la vista de Team Explorer.

Captura de un elemento de trabajo como plantilla

Los pasos para capturar un elemento de trabajo difieren en función de la plataforma, la versión y el cliente que use.

Portal web

A las plantillas capturadas a través del portal web se les asigna un GUID.

1. En el portal web, abra un elemento de trabajo que usará como base para una plantilla.

2. Elija el icono de acciones para abrir el menú. Elija Plantillas y, a continuación, Capturar.

   

   Asigne un nombre a la plantilla, seleccione el equipo en el que desea guardarla y, opcionalmente, defina o desactive campos. Guarde la plantilla cuando termine.

   

3. Una vez que haya guardado la plantilla, elija Copiar vínculo para capturar la dirección URL de la plantilla.

4. Puede pegar el vínculo URL en un explorador para crear un elemento de trabajo o proporcionarlo a otros usuarios para su uso para agregar elementos de trabajo. Por ejemplo, puede agregarlo como un hipervínculo a una wiki del proyecto, un panel a través de un widget de Markdown u otro recurso de red compartido.

   Use la dirección URL siempre que quiera agregar un elemento de trabajo del tipo que haya definido con sus valores predefinidos.

A las plantillas capturadas a través del portal web se les asigna un GUID.

1. En el portal web, abra un elemento de trabajo que usará como base para una plantilla.

   Dentro del portal web, las plantillas de elementos de trabajo están asociadas a un equipo. Solo se puede acceder a las plantillas definidas para un equipo cuando vaya a aplicar una plantilla a los elementos de trabajo mediante el portal web.

2. Elija el icono de acciones para abrir el menú. Elija Plantillas y, a continuación, Capturar.

   

   Asigne un nombre a la plantilla y, opcionalmente, defina o desactive campos. Guarde la plantilla cuando termine. La plantilla se guarda en el equipo seleccionado en el primer paso.

   

3. Una vez que haya guardado la plantilla, elija Copiar vínculo para capturar la dirección URL de la plantilla que puede usar para agregar elementos de trabajo mediante la plantilla.

4. Use la dirección URL siempre que quiera agregar un elemento de trabajo del tipo que haya definido con sus valores predefinidos.

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

Visual Studio 2015

Si trabaja principalmente en Visual Studio o Team Explorer y desea crear elementos de trabajo a partir de plantillas a las que accede desde la página Elementos de trabajo, puede crear archivos de plantilla de elemento de trabajo (extensión .wt).

1. Si aún no ha instalado Microsoft Visual Studio Team Foundation Server 2015 Power Tools, hálo ahora. Necesita que este software esté instalado para acceder a la herramienta de energía Plantillas de elemento de trabajo para Visual Studio.

2. Abra o ejecute una consulta que muestre el elemento de trabajo cuyos campos desea capturar.

3. Haga clic con el botón derecho en el elemento de trabajo del tipo y cuyos campos desea capturar y seleccione Capturar plantilla en el menú contextual.

   

4. En el cuadro de diálogo, use las casillas para seleccionar todos los campos que desea guardar en la plantilla. A continuación, agregue un nombre y (opcionalmente) descripción a la plantilla.

   

5. Guarde la plantilla y aparecerá en la raíz del panel Team Explorer en la sección Plantillas.

Administrar plantillas de elementos de trabajo

Puede ver la lista de plantillas definidas para cada tipo de elemento de trabajo y también agregar, editar, copiar, eliminar, cambiar el nombre y copiar el vínculo de una plantilla. Todas las plantillas se definen y administran para un equipo.

Portal web

Debe ser miembro del equipo para agregar o editar plantillas de equipo.

1. En el portal web, abra la configuración de un equipo.

   Elija Configuración del proyecto.

   

   Expanda Paneles y elija Configuración de equipo. Si necesita cambiar a otro equipo, use el selector de equipo.

2. Elija Plantillas.

   Desde aquí, puede elegir cualquier tipo de elemento de trabajo para ver o agregar plantillas para ese tipo.

Las plantillas se administran desde la configuración del equipo. Todas las plantillas se definen para un equipo. Si no es administrador del equipo, se agrega como uno. Solo los administradores de equipo o proyecto pueden cambiar las plantillas de elemento de trabajo.

1. En el portal web, abra la configuración de un equipo.

   Elija el icono de engranaje para abrir la configuración de un equipo.

   Aquí se abre la página de administración para el equipo web.

   

2. Elija Plantillas de trabajo>.

   

   Desde aquí, puede seleccionar cualquier tipo de elemento de trabajo para ver o agregar plantillas para ese tipo.

Administrar plantillas para un tipo de elemento de trabajo

• Elija el tipo de elemento de trabajo para ver las plantillas definidas para cada tipo.

  Por ejemplo, elija Caso de usuario para ver las plantillas definidas para capturar casos de usuario.

  

• Elija el tipo de elemento de trabajo para ver las plantillas definidas para cada tipo. Por ejemplo, elija Caso de usuario para ver las plantillas definidas para capturar casos de usuario.

  

Creación de una plantilla de elemento de trabajo

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

   

2. Asigne un nombre a la plantilla y, opcionalmente, agregue y quite campos. Guarde la plantilla cuando termine.

   Una vez que haya guardado la plantilla, seleccione Copiar vínculo para capturar la dirección URL de la plantilla que puede usar para agregar elementos de trabajo mediante la plantilla.

Editar, cambiar el nombre o copiar un vínculo a una plantilla

1. En la página de tipo de elemento de trabajo, elija el icono de acciones de una plantilla existente para acceder a las opciones de menú para editar, eliminar o copiar vínculo.

   

2. Para cambiar el nombre de una plantilla, elija editar la plantilla, cambie el nombre y guarde los cambios.

Creación de una copia de una plantilla

1. Para duplicar una plantilla existente, elija el icono de acciones de una plantilla existente y seleccione la opción Crear copia .

   

2. Asigne un nombre a la plantilla y, opcionalmente, agregue y quite campos. Guarde la plantilla cuando termine.

Eliminar una plantilla

1. En el portal web, abra Plantillas de configuración>del equipo de configuración>del proyecto.

2. Elija el icono de acciones para abrir el menú y elija Eliminar.

   

3. Elija Eliminar en el cuadro de diálogo de confirmación Eliminar plantilla que se muestra.

   

   Como se indica en el cuadro de diálogo de confirmación, no se puede recuperar una plantilla una vez eliminada.

Visual Studio 2015

Con Visual Studio con las herramientas de energía instaladas, puede ver la lista de plantillas definidas para cada tipo de elemento de trabajo y agregar, editar, copiar, eliminar y copiar el vínculo de una plantilla. Estas plantillas solo están disponibles para usted. Para compartirlos con otros usuarios, puede copiar la dirección URL de la plantilla y compartirla, o guardarla como un archivo .wt.

• Las plantillas se administran desde el panel Team Explorer.

  

  El nodo Plantillas raíz representa el elemento primario de todas las plantillas. Puede crear una estructura de directorios debajo de ella agregando carpetas. Haga clic con el botón derecho en el nodo Plantillas o en una carpeta y seleccione Nueva carpeta en el menú contextual.

• Puede cortar, copiar, pegar, cambiar el nombre y eliminar plantillas y carpetas mediante el menú contextual. También puede arrastrar y colocar plantillas en carpetas. Para editar varias plantillas, use mayús-click para seleccionar un intervalo o ctrl-clic para agregar plantillas individuales a la selección y, a continuación, haga clic con el botón derecho.

Definición de una plantilla

1. En la sección Plantillas , haga clic con el botón derecho en Plantillas y elija crear una plantilla desde cero.

   

2. Guarde la plantilla y proporcione un nombre en el cuadro de diálogo proporcionado.

   

   Una vez que haya guardado la plantilla, seleccione Copiar vínculo para capturar la dirección URL de la plantilla que puede usar para agregar elementos de trabajo mediante la plantilla.

Editar, usar, copiar o eliminar una plantilla

• Para editar, eliminar o completar otra acción en una plantilla, abra su menú contextual (haga clic con el botón derecho) y elija la opción que desee.

  

• Para que las plantillas usadas con frecuencia sean más accesibles, puede establecer una plantilla predeterminada para cada tipo de elemento de trabajo. Para ello, haga clic con el botón derecho en una plantilla en Team Explorer y seleccione Establecer como predeterminado. Aparecerá una marca de verificación en el icono para indicar que ahora es el valor predeterminado.

Establecimiento del directorio de plantillas

• Para cambiar el directorio donde se almacenan las plantillas, seleccione el vínculo Configurar o vaya a él a través de Opciones> de herramientas>Microsoft Team Foundation Server> Plantillas de elementos de trabajo. Use este cuadro de diálogo para establecer la ruta de acceso del almacén de plantillas. Coloque las plantillas en una ubicación de red para compartirlas con su equipo.

Agregar un elemento de trabajo mediante una plantilla

El método principal para agregar un elemento de trabajo mediante una plantilla es abrir el vínculo de plantilla dentro de una ventana del explorador. Para obtener el vínculo de plantilla, consulte la sección siguiente Copia del vínculo a una plantilla.

Puede compartir estos vínculos por correo electrónico, un recurso compartido de red o un panel de equipo.

Copia del vínculo a una plantilla

Use la dirección URL siempre que quiera agregar un elemento de trabajo del tipo que haya definido con sus valores predefinidos. Copie el vínculo a una red compartida o envíelo a su equipo por correo electrónico. Además, considere la posibilidad de agregar un vínculo al panel del equipo.

Portal web

1. Vaya a Configuración del proyecto.

   

   Expanda Paneles y elija Configuración de equipo. A continuación, elija Plantillas.

2. Elija el tipo de elemento de trabajo cuya plantilla desea copiar.

3. Elija el icono de acciones para abrir el menú y elija Copiar vínculo.

   

   Puede guardar la dirección URL como un archivo de texto o agregar la dirección URL a una página web como hipervínculo.

1. Elija el icono de engranaje para abrir la configuración de un equipo.

   

2. Elija la pestaña Plantillas de trabajo>. A continuación, elija el icono de acciones de la plantilla que desea copiar y seleccione Copiar vínculo.

   

   Puede guardar la dirección URL como un archivo de texto o agregar la dirección URL a una página web como hipervínculo.

Visual Studio 2015

1. Puede copiar el vínculo a una plantilla, que se abrirá en el portal web; para ello, abra el menú contextual de la plantilla.

   

2. Pegue el vínculo copiado en un explorador web para comprobar que funciona según lo previsto.

Aplicar una plantilla a elementos de trabajo nuevos o existentes

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

Portal web

Aplicar una plantilla dentro de un elemento de trabajo

1. Abra un nuevo elemento de trabajo o un elemento de trabajo existente que quiera actualizar con los campos definidos en una plantilla, elija el icono de acciones para abrir el menú, seleccione Plantillas y, a continuación, seleccione el nombre de una plantilla predefinida.

   

   Solo aparecen las plantillas definidas para los equipos a los que pertenece.

   Sugerencia

   Actualice el explorador para detectar las plantillas más recientes que se han agregado. Si no ve ninguna plantilla, puede ser que no haya ninguna definida para el tipo de elemento de trabajo.

2. Guarde el elemento de trabajo para aplicar los cambios. Los campos cambiados se indican en el campo Historial.

Aplicar una plantilla dentro de un elemento de trabajo

1. Abra el elemento de trabajo que desea actualizar con los campos definidos en una plantilla, elija el icono de acciones para abrir el menú, seleccione Plantillas y, a continuación, seleccione el nombre de una plantilla predefinida.

   

   Sugerencia

   Actualice el explorador para detectar las plantillas más recientes que se han agregado. Si no ve ninguna plantilla, puede ser que no haya ninguna definida para el tipo de elemento de trabajo.

2. Guarde el elemento de trabajo para aplicar los cambios. Los campos cambiados se indican en el campo Historial.

Aplicar una plantilla a varios elementos de trabajo

1. Para actualizar de forma masiva varios elementos de trabajo, selecciónelos primero en el trabajo pendiente o en una lista de resultados de la consulta y, a continuación, abra el menú de acciones para uno de ellos. Todos los elementos de trabajo que seleccione deben ser del mismo tipo de elemento de trabajo. Por ejemplo, todos los casos de usuario o todos los errores.

2. Elija la plantilla que se va a aplicar.

   

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

1. Para actualizar de forma masiva varios elementos de trabajo, selecciónelos primero en el trabajo pendiente o en una lista de resultados de la consulta y, a continuación, abra el menú de acciones para uno de ellos. Todos los elementos de trabajo que seleccione deben ser del mismo tipo de elemento de trabajo. Por ejemplo, todos los casos de usuario o todos los errores.

2. Elija la plantilla que se va a aplicar.

   

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

Visual Studio 2015

1. Abra o ejecute una consulta que muestre los elementos de trabajo cuyos campos desea capturar.

2. Haga clic con el botón derecho en los elementos de trabajo (que deben ser del mismo tipo) y elija Aplicar plantilla en el menú contextual.

   

3. Seleccione la plantilla que se va a usar y seleccione Aceptar.

   

4. Guarde el elemento de trabajo.

   

Agregar o quitar etiquetas de plantillas

Puede agregar etiquetas a una plantilla y se aplicarán al elemento de trabajo cuando use la plantilla. Para agregar dos o más etiquetas, delimitelas con una coma (,).

Si no especifica etiquetas que se van a quitar, todas las etiquetas presentes en un elemento de trabajo permanecerán definidas. Permanecerán definidos incluso cuando aplique una plantilla de elemento de trabajo a un elemento de trabajo existente.

Definición de una plantilla de elemento de trabajo no planeada mediante un hipervínculo

Puede especificar una plantilla de elemento de trabajo que especifique varios valores de campo mediante la sintaxis siguiente. Use la dirección URL siempre que quiera agregar un elemento de trabajo del tipo que haya definido con sus valores predefinidos.

https://dev.azure.com/{OrganizationName}/{ProjectName}/_workItems/create/{WorkItemType}?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

http://{ServerName}:8080/tfs/DefaultCollection/{ProjectName}/_workItems/create/{WorkItemType}?
[FieldReferenceName 1]={FieldValue 1}&
[FieldReferenceName 2]={FieldValue 2}&
[FieldReferenceName 3]={FieldValue 3}&
. . .

Por ejemplo, la siguiente sintaxis especifica una tarea de elemento de trabajo con el título TaskTitle. Especifica valores para los campos Assigned To, Description, Tags, Activity y Iteraation Path.

https://dev.azure.com/{OrganizationName}/{ProjectName}/_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://{ServerName}:8080/tfs/DefaultCollection/{ProjectName}/_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

Sugerencia

Hay un límite de 2000 caracteres impuesto por algunos clientes del explorador.

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

Adición de un vínculo de plantilla a un panel de equipo

Puede agregar vínculos a un widget de Markdown que aparezca 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.

Por ejemplo, el widget siguiente contiene vínculos a tres plantillas.

Para obtener más información sobre el widget de Markdown, consulte Agregar Markdown a un panel, widgets de Markdown.

Artículos relacionados

• Preguntas frecuentes sobre Azure Boards
• Plantillas de elementos de trabajo de ejemplo