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


Task

Portal web

Visual Studio 2015


✔️

✔️


Administración de plantillas de elementos de trabajo
(Definir, editar, eliminar, copiar vínculo, crear copia y cambiar nombre)

✔️

✔️


✔️

✔️


✔️

✔️


✔️

✔️


✔️

✔️


✔️


Sugerencia

Las plantillas que se definen a través del portal web son distintas de las que se definen mediante Visual Studio. Las plantillas del portal web solo se pueden administrar y aplicar a los elementos de trabajo a través del portal web. De forma similar, Visual Studio plantillas de trabajo solo se pueden administrar, ver y aplicar a los elementos de trabajo de 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 las 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 elemento de trabajo Visual Studio Team Explorer, instale el Microsoft Visual Studio Team Foundation Server Power Tools de 2015. 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.

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, Capture.

    Captura de definiciones de campo de elemento de trabajo como plantilla, versión más reciente

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

    Cuadro de diálogo Capturar plantilla

  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 de dirección URL en un explorador para crear un elemento de trabajo o proporcionarlo a otros usuarios para su uso con el objeto de agregar elementos de trabajo. Por ejemplo, puede agregarlo como un hipervínculo a una wiki de proyecto,un panel a través de un widget de Markdownu otro recurso de red compartido.

    Use la dirección URL siempre que desee agregar un elemento de trabajo del tipo que ha 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.

    En el portal web, las plantillas de elementos de trabajo están asociadas a un equipo. Solo las plantillas definidas para un equipo son accesibles cuando se va a aplicar una plantilla a elementos de trabajo mediante el portal web.

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

    Captura de definiciones de campo de elemento de trabajo como plantilla

    Asigne un nombre a la plantilla y, opcionalmente, defina o desactive los campos. Guarde la plantilla cuando haya terminado. La plantilla se guarda en el equipo que seleccionó en el primer paso.

    Cuadro de diálogo Capturar plantilla

  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 desee agregar un elemento de trabajo del tipo que ha 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 un hipervínculo.

Si se conecta a un TFS local y crea principalmente elementos de trabajo que funcionan en el portal web, puede crear un hipervínculo que capture los valores predeterminados que especifique para una plantilla. Elija el hipervínculo y se abrirá la plantilla en el portal web.

  1. En la página Consultas del portal web, abra un nuevo elemento de trabajo.

    Abrir un nuevo elemento de trabajo desde la página Trabajo del portal web

  2. Rellene los valores predeterminados que desea que especifique la plantilla. Puede dejar vacíos los campos obligatorios o colocar texto en ellos.

    En este caso, se rellenan varios valores, incluidas las etiquetas, pero se deja el título en blanco. Cuando haya terminado, copie la dirección URL de la plantilla.

    Definir campos y elegir Copiar la dirección URL

  3. La dirección URL define cada campo predefinido, por ejemplo (saltos de línea agregados para mayor claridad):

    http://fabrikamprime:8080/tfs/DefaultCollection/Fabrikam%20Fiber/_workItems/create/Task?%5B
    System.AssignedTo%5D=Jamal+Hartnett&%5B
    System.Description%5D=%3Cp%3EAlways+include+Remaining+Work+and+links+to+any+related+bugs+or+user+stories.%3C%2Fp%3E&%5B
    System.Tags%5D=Web%3B+Phone%3B+Service&%5B
    Microsoft.VSTS.Common.Activity%5D=Development&%5B
    System.IterationPath%5D=Fabrikam+Fiber%5CIteration+1
    

    Sugerencia

    La dirección URL no contendrá los valores predeterminados definidos para el tipo de elemento de trabajo. Para especificar un valor de campo predeterminado, vea Agregar o modificar un campo. Además, hay un límite de 2000 caracteres impuesto por algunos clientes de explorador sin ningún tipo de problema.

  4. Use la dirección URL siempre que desee agregar un elemento de trabajo del tipo que ha 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 un hipervínculo.

Administración de plantillas de elementos de trabajo

Puede ver la lista de plantillas definidas para cada tipo de elemento de trabajo y 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.

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 Project Configuración.

    Abrir la configuración del proyecto

    Expanda Boards y elija Configuración del 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 un administrador de equipo, agregó como uno. Solo los administradores de equipos o proyectos 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 del equipo web.

    Abra la página de administración del equipo web.
  2. Elija Plantillas de trabajo.

    Abrir la página Trabajo: plantillas para el equipo

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

Administración de 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.

    Captura de pantalla, elija Plantillas de caso 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.

    Administración de plantillas de caso de usuario

Creación de una plantilla de elemento de trabajo

  1. En la página de tipo de elemento de trabajo, elija el icono de signo más verdeNuevaplantilla para crear una plantilla desde cero.

    Adición de una plantilla de caso de usuario
  2. Asigne un nombre a la plantilla y, opcionalmente, agregue y quite campos. Guarde la plantilla cuando haya terminado.

    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.

  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ú Editar, Eliminar o Copiar vínculo.

    Menú Abrir acción de plantilla
  2. Para cambiar el nombre de una plantilla, elija editarla, cambiar el nombre y, a continuación, guardar 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.

    Copia de una plantilla existente
  2. Asigne un nombre a la plantilla y, opcionalmente, agregue y quite campos. Guarde la plantilla cuando haya terminado.

Eliminar una plantilla

  1. En el portal web, abra Project Configuración team configuration Templates (Plantillas de configuración > de equipo).

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

    Captura de pantalla de la opción de menú Eliminar una plantilla.

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

    Cuadro de diálogo de confirmación de eliminación de plantilla.

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

La administración de plantillas de elementos de trabajo desde el portal web solo se admite desde TFS 2017 y versiones posteriores.

Adición de un elemento de trabajo mediante una plantilla

El método main 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 Copiar el vínculo a una plantilla.

Puede compartir estos vínculos a través del correo electrónico, un recurso compartido de red o un panel de equipo.

Use la dirección URL siempre que desee agregar un elemento de trabajo del tipo que ha 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.

  1. Vaya a Project Configuración.

    Abrir la configuración del proyecto

    Expanda Boards y elija Configuración del 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.

    Captura de pantalla de la opción de menú Copiar plantilla de 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 un hipervínculo.

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

    Abrir el contexto de administración del 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.

    Copiar vínculo de una plantilla

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

La administración de plantillas de elementos de trabajo desde el portal web solo se admite desde TFS 2017 y versiones posteriores.

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

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

Aplicación de una plantilla dentro de un elemento de trabajo

  1. Abra un nuevo elemento de trabajo o un elemento de trabajo existente que quiera actualizar mediante 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.

    Aplicación de una plantilla a un elemento de trabajo existente dentro del formulario

    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 que no haya ninguna definida para el tipo de elemento de trabajo.

  2. Guarde el elemento de trabajo para los cambios que se aplicarán. Los campos modificados se anotan en el campo Historial.

Aplicación de una plantilla dentro de un elemento de trabajo

  1. Abra el elemento de trabajo que desea actualizar mediante 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.

    Aplicación de una plantilla a un elemento de trabajo existente dentro del formulario

    Sugerencia

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

  2. Guarde el elemento de trabajo para los cambios que se aplicarán. Los campos modificados se anotan en el campo Historial.

Aplicación de 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 la lista de resultados de una consulta y, a continuación, abra el menú de acciones de 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 aplicará.

    Actualización masiva de varios elementos de trabajo

  3. Los cambios de campo se aplican automáticamente y se guardan los elementos de trabajo. Para 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 la lista de resultados de una consulta y, a continuación, abra el menú de acciones de 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 aplicará.

    Actualización masiva de varios elementos de trabajo

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

La característica para aplicar una plantilla a elementos de trabajo existentes desde el portal web no se admite para TFS 2015 y versiones anteriores.

Adición o eliminación de 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, delimite con una coma (,).

Edición de una plantilla de error, adición o eliminación de etiquetas

Si no especifica etiquetas para 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.

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 desee agregar un elemento de trabajo del tipo que ha 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 sintaxis siguiente especifica una tarea de elemento de trabajo con el título TaskTitle. Especifica valores para los campos Asignado a, Descripción, Etiquetas, Actividad y Ruta de acceso de iteración.

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

Algunos clientes del explorador imponen un límite de 2000 caracteres.

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 un hipervínculo.

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

Nota

Hay varios paneles de equipo y el widget de Markdown disponibles para Azure Boards y TFS 2015.2 y versiones posteriores.

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

Widget de Markdown con vínculos a plantillas

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

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013 | Visual Studio 2015

Con las plantillas de elementos 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 usará al crear una tarea.

Puede usar plantillas de elemento 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, vea Plantillas de elementos de trabajo de ejemplo.

Nota

Las plantillas de elementos 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: Básico,Agile,Scrumo CMMI.

Tareas de plantilla admitidas

La disponibilidad de las opciones de la tarea de plantilla depende de la versión de cliente y plataforma disponible. Agregue y administre plantillas de elemento 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 Power Tools de 2015. Estas plantillas solo aparecen en la vista de Team Explorer.

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