Agregar etiquetas de elemento de trabajo para clasificar y filtrar listas y paneles

Azure Boards | Azure DevOps Server 2020 | Azure DevOps Server 2019 | TFS 2018 - TFS 2013

El etiquetado de elementos de trabajo le ayuda a filtrar rápidamente el trabajo pendiente del producto o una consulta de elementos de trabajo por categorías que defina. Una etiqueta corresponde a una o dos frases de palabra clave que defina y que admita sus necesidades para filtrar un trabajo pendiente o una consulta, o definir una consulta.

Las etiquetas son una mejor opción para filtrar elementos de trabajo que usar cadenas de texto como se describe en Guía para crear consultas de alto rendimiento.

Puede agregar y modificar etiquetas desde el portal web, desde Team Explorer complemento para Visual Studio. Además, puede abrir una consulta en Excel modificar etiquetas de forma masiva.

Nota

Las etiquetas son un recurso compartido, están asociadas a un proyecto y no a un equipo. Si el proyecto contiene varios equipos, todos los equipos agregarán y trabajarán desde el mismo conjunto de etiquetas.

Requisitos previos

  • Debe conectarse a un proyecto. Si aún no tiene un proyecto, cree uno.
  • Debe agregarse a un proyecto como miembro del grupo de seguridad Colaboradoreso Project administradores. Para agregarlo, agregue usuarios a un proyecto o equipo.
  • Para ver o modificar elementos de trabajo, debe tener los permisos Ver elementos de trabajo en este nodo y Editar elementos de trabajo en este nodo establecidos en Permitir. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Para más información, consulte Establecer permisos y acceso para el seguimiento del trabajo.
  • Para agregar nuevas etiquetas para agregar a elementos de trabajo, debe tener acceso básico o superior y tener los permisos Crear nueva definición de etiqueta en Permitiren el nivel de proyecto. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Incluso si el permiso se establece explícitamente para una parte interesada,no tendrá permiso para agregar nuevas etiquetas, ya que están prohibidas a través de su nivel de acceso. Para más información, consulte Referencia rápida de acceso de las partes interesadas.
  • Debe conectarse a un proyecto. Si aún no tiene un proyecto, cree uno.
  • Debe agregarse a un proyecto como miembro del grupo de seguridad Colaboradoreso Project administradores. Para agregarlo, agregue usuarios a un proyecto o equipo.
  • Para ver o modificar elementos de trabajo, debe tener los permisos Ver elementos de trabajo en este nodo y Editar elementos de trabajo en este nodo establecidos en Permitir. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Para más información, consulte Establecer permisos y acceso para el seguimiento del trabajo.
  • Para agregar nuevas etiquetas para agregar a elementos de trabajo, debe tener acceso básico o superior y tener los permisos Crear nueva definición de etiqueta en Permitiren el nivel de proyecto. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Incluso si el permiso se establece explícitamente para una parte interesada,no tendrá permiso para agregar nuevas etiquetas, ya que están prohibidas a través de su nivel de acceso. Para más información, consulte Referencia rápida de acceso de las partes interesadas.

Nota

Los usuarios con acceso de las partes interesadas para los proyectos públicos pueden agregar nuevas etiquetas.

Agregar etiquetas a un elemento de trabajo

Las etiquetas deben tener 400 caracteres o menos y no contener separadores como , (coma), (punto y coma) u ; otro carácter de formato.

En el portal web, abra un elemento de trabajo y agregue una etiqueta. Elija Agregar etiqueta y escriba la palabra clave. O bien, selecciónela en la lista de etiquetas asignadas anteriormente.

Add one or more tags to a work item

En el portal web, abra un elemento de trabajo y agregue una etiqueta. Elija Agregar y escriba la palabra clave. O bien, selecciónela en la lista de etiquetas asignadas anteriormente.

Add one or more tags to a work item

Para agregar varias etiquetas al mismo tiempo, escriba una coma entre ellas. Las etiquetas distinguen mayúsculas de minúsculas.

Las etiquetas que aparecen en la barra de etiquetas ya están asignadas al elemento de trabajo. Para desasignación de una etiqueta, elija la x de la etiqueta, Delete a tag assigned to a work item .

Nota

De forma predeterminada, a todos los colaboradores y partes interesadas de los proyectos públicos se les conceden permisos para agregar etiquetas nuevas y existentes. Las partes interesadas de los proyectos privados pueden agregar etiquetas que ya están definidas, pero no agregar etiquetas nuevas. Para conceder o restringir permisos para crear nuevas etiquetas, establezca el permiso Crear definición de etiqueta en el nivel de proyecto. Para más información, consulte Agregar administradores, establecer permisos enel nivel de proyecto o en el nivel de colección de proyectos.

Agregar o quitar etiquetas de forma masiva

Puede actualizar de forma masiva elementos de trabajo para agregar o quitar etiquetas del portal web. Las etiquetas se modifican de forma masiva de la misma manera que se modificande forma masiva otros campos mediante el portal web . O bien, puede usar Excel agregar o quitar etiquetas de forma masiva.

Edit work items dialog, Bulk add to several work items.

Nota

No se admite la modificación masiva de etiquetas Visual Studio cliente.

Consulta de elementos de trabajo basados en etiquetas

Para consultar elementos de trabajo basados en etiquetas, agregue una cláusula para cada etiqueta que quiera usar para admitir la consulta.

Nota

Tfs 2013.2 y versiones posteriores admiten la adición de etiquetas a una consulta.

Sugerencia

Puede usar los operadores Contains o Does Not Contain. Para más información sobre las consultas, consulte Creación de consultas administradas.

Por ejemplo, aquí se consultan todos los elementos de trabajo etiquetados Web como o Service .

Screenshot of Query Editor to query on tags.

Sugerencia

Para comprender cómo se agrupan las cláusulas AND/OR, consulte Creación y guardado de consultas administradas, Cláusulas group. Para ver la sintaxis de WIQL de una consulta, instale la extensión del editor de consultas WIQL, que le permitirá ver la versión de WIQL de cualquier entrada de la interfaz de usuario de consulta.

Nota

La capacidad de consultar elementos de trabajo que no tienen etiquetas asociadas no es una característica admitida. Si desea votar la solicitud para admitir esta característica, puede hacerlo en nuestra página developer Community,Be able to search for empty tags (Buscar etiquetas vacías).

Mostrar etiquetas en el trabajo pendiente o los resultados de la consulta

Elija Opciones de columna para agregar el campo Etiquetas al trabajo pendiente del producto o a una consulta de elemento de trabajo. Si la opción no aparece, elija Más comandos para seleccionarla en el menú de opciones.

Column options dialog, Add Tags to the selected columns to display.

Aparecen todas las etiquetas que se han agregado a los elementos de trabajo enumerados.

Screenshot of product backlog, View with Tags column added.

  1. Elija Opciones de columna para agregar el campo Etiquetas al trabajo pendiente del producto o a una consulta de elemento de trabajo. Si la opción no aparece, elija Más comandos para seleccionarla en el menú de opciones.

    Column options dialog, Add Tags to the selected columns to display, TFS-2015 and earlier versions.

  2. Se muestran todas las etiquetas asignadas a los elementos de trabajo enumerados.

    Product backlog view with Tags column added, TFS-2015 and earlier versions.

Filtrar listas mediante etiquetas

Desde el portal web, puede filtrar los trabajo pendientes, los paneles y los resultados de la consulta mediante etiquetas.

Para empezar, elija Filtrar .

Active las casillas de las etiquetas por las que desea filtrar. Mantenga la selección OR para ejecutar un OPERADOR lógico para todas las etiquetas seleccionadas. O bien, elija la opción AND para ejecutar un AND lógico en todas las etiquetas seleccionadas.

View with Tags column added

  1. Active el filtrado y elija una etiqueta.

    Choose a tag to filter the list by that tag

    La lista se actualiza. Solo se muestran los elementos de trabajo con la etiqueta seleccionada. El filtrado de la lista deshabilita el panel de adición de elemento de trabajo pendiente, la clasificación de rangos en la pila y la previsión.

    Filtered list disables other features

  2. Para aplicar un subfiltro, elija otra etiqueta. Para filtrar sucesivamente, elija entre el conjunto de etiquetas que aparecen en la barra de etiquetas de filtro. Para iniciar el proceso de filtrado, elija Todas para mostrar todas las etiquetas.

  3. Para mostrar todos los elementos, elija Todos o elija el icono de filtro Filtro de etiquetas en el trabajo pendiente y el icono de filtro de páginas de consultas para desactivar el filtrado.

Eliminación, eliminación o administración de etiquetas

No se puede eliminar una etiqueta propiamente dicha. Sin embargo, si elimina una etiqueta de todos los elementos de trabajo a los que está asignada actualmente, el sistema eliminará la etiqueta. El sistema elimina automáticamente las etiquetas sin signo después de tres días de desuso.

Si se ortográfica incorrectamente una etiqueta, no asigne la etiqueta mal escrita a ningún elemento de trabajo y el sistema la eliminará automáticamente en un plazo de tres días.

Otra opción es instalar el Administrador de etiquetas de Marketplace,que agrega una página Etiquetas en Boards o Trabajar para administrar etiquetas.

Etiquetas de código de color en paneles

Puede resaltar etiquetas en tarjetas de panel Kanban mediante la codificación de colores. Estos colores solo aparecen en el panel Kanban que configure. No aparecen en los trabajo pendientes ni en los panel de tareas. Para más información, consulte Personalización de tarjetas, etiquetas de código de color.

Requiere TFS 2015.1 o una versión posterior.

Boards>Settings>Tag colors dialog

Gráfico de elementos de trabajo y agrupación por etiquetas

Nota

No se puede agrupar un gráfico basado en consultas por etiquetas; sin embargo, puede agrupar un widget Gráfico para elementos de trabajo por etiquetas que agregue a un panel. Esta característica está en versión preliminar pública. Para habilitarlo, consulte Administrar o habilitar características y activar Habilitar grupo por etiquetas para el widget de gráfico de elementos de trabajo en el panel.

Para agrupar un widget Gráfico para elementos de trabajo por etiquetas, complete los mismos pasos proporcionados en Seguimiento del progreso con los gráficos basados en consultas de estado y tendencias, Agregar un widget de gráfico a un panel. Asegúrese de que la consulta de lista plana contiene etiquetas en la cláusula de consulta o como una opción de columna. A continuación, elija Etiquetas para la selección Agrupar por. Para filtrar el gráfico para mostrar solo algunas etiquetas, elija el botón de radio Etiquetas seleccionadas y, a continuación, elija las etiquetas que desea que se muestren en el gráfico.

Screenshot of Chart by Work Items, Configure, Group by Tags.

Límites en el número de etiquetas

Aunque no existe ningún límite máximo, la creación de más de 100 000 etiquetas para una colección de proyectos puede afectar negativamente al rendimiento. Además, el menú desplegable autocompletar del control de etiquetas muestra un máximo de 200 etiquetas. Cuando se definen más de 200 etiquetas, comience a escribir para que el control de etiquetas muestre las etiquetas pertinentes.

No puede asignar más de 100 etiquetas a un elemento de trabajo o recibirá el mensaje siguiente:

TF401243: Failed to save work item because too many new tags were added to the work item.

Guarde el elemento de trabajo con las etiquetas (100 o menos) que ha agregado y, a continuación, puede agregar más etiquetas.

Limite las consultas a menos de 25 etiquetas. Más de esa cantidad y es probable que la consulta se queme el tiempo de espera.

Agregar etiquetas a la vista de columna predeterminada en el trabajo pendiente del producto

Para agregar el campo Etiquetas como un campo de columna para el trabajo pendiente del producto, modifique el archivo ProcessConfiguration para incluir System.Tags . Para obtener información sobre cómo hacerlo, consulte la referencia del elemento XML de configuración de proceso.