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 ColaboradoresProject 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 ColaboradoresProject 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.
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.
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 eliminar la asignación de una etiqueta, elija la x de la etiqueta, Eliminar una
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.
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 .
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.
Aparecen todas las etiquetas que se han agregado a los elementos de trabajo enumerados.
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.
Se muestran todas las etiquetas asignadas a los elementos de trabajo enumerados.
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.
Active el filtrado y elija una etiqueta.
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.
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.
Para mostrar todos los elementos, elija Todos o elija el icono de filtro Etiquetar imagen de filtro en el trabajo pendiente y las 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 asignación después de tres días de desuso.
Si se malinterpreta 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 Trabajo 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.
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 etiquetaspara 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 que se proporcionan en Seguimiento del progreso con 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.
Artículos relacionados
- Mejor herramienta para agregar, actualizar y vincular elementos de trabajo
- Use the query editor to list and manage queries (Uso del editor de consultas para enumerar y administrar consultas)
- Mostrar etiquetas en las tarjetas
- Modificación masiva de elementos de trabajo desde el portal web
- Modificación masiva de elementos de trabajo desde Excel
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, empiece 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 desalome.
Agregar etiquetas a la vista de columna predeterminada en el trabajo pendiente del producto
Para agregar el campo Etiquetas como 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.