Agregar etiquetas de elemento de trabajo para clasificar y filtrar listas y paneles
Azure DevOps Services | Azure DevOps Server 2022: Azure DevOps Server 2019 | TFS 2018
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 frase de palabra clave uno o dos que defina y que admita sus necesidades de filtrar un trabajo pendiente o 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 Instrucciones para crear consultas de alto rendimiento.
Puede agregar y modificar etiquetas desde el portal web, desde el complemento Team Explorer para Visual Studio. Además, puede abrir una consulta en Excel para modificar etiquetas de forma masiva.
Nota
Las etiquetas son un recurso compartido, están asociados a un proyecto y no a un equipo. Si el proyecto contiene varios equipos, todos los equipos se 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. Para agregarlo, agregue usuarios a un proyecto o equipo.
- Para ver o modificar elementos de trabajo, debe tener los elementos de trabajo Ver en este nodo y Editar elementos de trabajo de este nodo establecidos enPermitir. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Para más información, consulte Establecimiento de permisos y acceso para el seguimiento del trabajo.
- Para agregar nuevas etiquetas para agregar elementos de trabajo, debe tener acceso básico o superior y tener los permisos de definición de etiqueta create new tag de nivel de proyecto establecidos en Permitir. 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 sobre el acceso de las partes interesadas.
- Todos los miembros del proyecto, incluso aquellos que pertenecen al grupo Lectores , pueden enviar por correo electrónico elementos de trabajo.
- Debe conectarse a un proyecto. Si aún no tiene un proyecto, cree uno.
- Debe agregarse a un proyecto. Para agregarlo, agregue usuarios a un proyecto o equipo.
- Para ver o modificar elementos de trabajo, debe tener los elementos de trabajo Ver en este nodo y Editar elementos de trabajo de este nodo establecidos enPermitir. De forma predeterminada, el grupo Colaboradores tiene este conjunto de permisos. Para más información, consulte Establecimiento de permisos y acceso para el seguimiento del trabajo.
- Para agregar nuevas etiquetas para agregar elementos de trabajo, debe tener acceso básico o superior y tener los permisos de definición de etiqueta create new tag de nivel de proyecto establecidos en Permitir. 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 sobre el acceso de las partes interesadas.
- Todos los miembros del proyecto, incluso aquellos que pertenecen al grupo Lectores , pueden enviar por correo electrónico elementos de trabajo.
Nota
Los usuarios con acceso de partes interesadas para 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 una , (coma), ; (punto y coma) u otro carácter de formato.
Sugerencia
Se recomienda no usar el @ carácter en una etiqueta. Las etiquetas que comienzan con el @ carácter no se pueden usar en una consulta de elemento de trabajo. El @ carácter significa una macro dentro de una consulta y, por tanto, la etiqueta no se reconoce como una etiqueta.
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.
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 anular la asignación de una etiqueta, elija la x en la etiqueta , 
.
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 proyectos privados pueden agregar etiquetas que ya están definidas, pero no agregar nuevas etiquetas. 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 Cambio de permisos de nivel de proyecto.
Agregar o quitar etiquetas de forma masiva
Puede actualizar elementos de trabajo de forma masiva para agregar o quitar etiquetas del portal web. Las etiquetas se modifican de forma masiva de la misma manera que se modifican de forma masiva otros campos mediante el portal web. O bien, puede usar Excel para agregar o quitar etiquetas de forma masiva.
Nota
No se admite la modificación masiva de etiquetas de Visual Studio u otros clientes compatibles.
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.
Sugerencia
Puede usar los operadores Contains o Does Not Contains . Las etiquetas que comienzan con el @ carácter no se pueden usar en una consulta de elemento de trabajo, ya que el editor de consultas interpreta el @ carácter como una macro. 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 o WebService.
Sugerencia
Para comprender cómo AND/OR se agrupan las cláusulas, consulte Creación y guardado de consultas administradas, Cláusulas de grupo. Para ver la sintaxis WIQL de una consulta, instale la extensión del editor de consultas WIQL que le permite ver la versión WIQL de cualquier entrada del editor de consultas.
Nota
La capacidad de consultar elementos de trabajo que no tienen etiquetas asociadas a ellos no es una característica compatible. Si desea votar la solicitud para admitir esta característica, puede hacerlo en nuestra página de Developer Community, Puede 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 seleccionarlo en el menú de opciones.
Aparecen todas las etiquetas que se han agregado a los elementos de trabajo enumerados.
Filtrar listas mediante etiquetas
Desde el portal web, puede filtrar trabajos pendientes, paneles y resultados de consultas mediante etiquetas.
Para empezar, elija Filtrar
.
Active las casillas de esas etiquetas en las que desea filtrar. Mantenga la selección OR para ejecutar un OR 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.
Eliminar, quitar o administrar etiquetas
No se puede eliminar una etiqueta propiamente dicha. Pero, si elimina una etiqueta de todos los elementos de trabajo a los que está asignada actualmente, el sistema la eliminará. El sistema elimina automáticamente las etiquetas sin asignar después de 3 días de falta de uso.
Si escribe una etiqueta mal escrita, 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 Paneles o Trabajo para administrar etiquetas.
Etiquetas de código de color en paneles
Puede resaltar etiquetas en tarjetas de placa Kanban mediante la codificación de colores. Estos colores solo aparecen en el panel Kanban que configure. No aparecen en trabajos pendientes ni en paneles de tareas. Para más información, consulte Personalizar tarjetas, etiquetas de código de color.
Elementos de trabajo de gráficos y agrupar por etiquetas
Nota
Sin embargo, no 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 que se proporcionan en Seguimiento del progreso con gráficos basados en consultas de estado y tendencia, Agregue 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 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 muestre 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 tarjetas
- Modificación masiva de elementos de trabajo desde el portal web
- Modificación masiva de elementos de trabajo desde Excel
Extensión de Marketplace
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 siguiente mensaje:
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 se agote el tiempo de espera de la consulta.
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 del proceso.