Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Servicios de Azure DevOps | Azure DevOps Server | Azure DevOps Server 2022
Etiquetar 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 una o dos palabras clave que definas. Una etiqueta facilita tus necesidades para filtrar una lista de pendientes o una consulta, o definir una consulta.
Puede agregar y modificar etiquetas desde el portal web o desde el complemento team Explorer para Visual Studio. Además, puede abrir una consulta en Excel para modificar etiquetas de forma masiva.
Las etiquetas son una mejor opción para filtrar elementos de trabajo que usar cadenas de texto, como se describe en Definición de una consulta de elemento de trabajo. Las etiquetas son un recurso compartido asociado a un proyecto y no a un equipo. Si el proyecto contiene varios equipos, todos los equipos se agregan al mismo conjunto de etiquetas y trabajarán desde él.
Note
Los nombres de las etiquetas de los elementos de trabajo y de las solicitudes de extracción (PR), también llamados etiquetas, comparten el mismo conjunto dentro de una organización o colección de proyectos. El límite combinado es de 150 000 nombres de etiqueta únicos. Para obtener más información, consulte Seguimiento del trabajo, procesos y límites del proyecto yEtiquetas de solicitud de incorporación de cambios.
Tip
Puede usar la inteligencia artificial para ayudar con esta tarea más adelante en este artículo, o consulte Enable AI assistance with Azure DevOps MCP Server para empezar.
Prerequisites
| Category | Requirements |
|---|---|
| Permisos |
Para ver, seguir y editar elementos de trabajo: - Ver elementos de trabajo en este nodo (Permitir) - Editar elementos de trabajo en este nodo (Permitir) De forma predeterminada, el grupo Colaboradores dispone de estos permisos. Para obtener más información, consulte Establecimiento de permisos para el seguimiento del trabajo. Para agregar nuevas etiquetas: - Permiso de proyecto para Crear definición de etiqueta (Permitir) De forma predeterminada, el grupo Colaboradores tiene este permiso. |
| Niveles de acceso |
-
Miembro del proyecto Para añadir nuevas etiquetas o seguir solicitudes de incorporación de cambios: al menos Básico Para ver o seguir elementos de trabajo: al menos parte interesada Para enviar correos electrónicos con elementos de trabajo: debe ser miembro del grupo Colaboradores . |
Note
- Asigne acceso de partes interesadas a los miembros que quieran revisar el progreso y analizar los elementos de trabajo, pero que no contribuyan al código. Pueden ver elementos de trabajo, listas de pendientes, tableros y paneles.
- De forma predeterminada, los colaboradores y las partes interesadas en proyectos públicos pueden agregar etiquetas nuevas y existentes. En proyectos privados, solo los colaboradores pueden agregar nuevas etiquetas. Para cambiar los permisos de creación de etiquetas, establezca el permiso Crear definición de etiqueta en el nivel de proyecto. Para obtener más información, consulte Cambio de permisos de nivel de proyecto.
Note
- Asigne acceso de partes interesadas a los miembros que quieran revisar el progreso y analizar los elementos de trabajo, pero que no contribuyan al código. Pueden ver elementos de trabajo, listas de pendientes, tableros y paneles.
Incorporación de etiquetas a un elemento de trabajo
Las etiquetas deben tener 400 caracteres o menos y no contener separadores como una , (coma), un ; (punto y coma) u otro carácter con formato.
Recomendación: no use 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 lo 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 , 
.
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 lo hacen otros campos mediante el portal web. O bien, puede usar Excel para agregar o quitar etiquetas de forma masiva.
Note
Los paneles no admiten la modificación de etiquetas de forma masiva desde Visual Studio u otros clientes.
Consulta de elementos de trabajo basados en etiquetas
Para consultar los elementos de trabajo en función de las etiquetas, agregue una cláusula para cada etiqueta que desee utilizar en la consulta.
Tip
Para comprender cómo AND/ORse agrupan las cláusulas, consulte Agrupación de cláusulas. 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.
Puede usar los operadores Contiene o No contiene. Las etiquetas que comienzan con el @ carácter no se pueden usar en una consulta de elemento de trabajo porque el editor de consultas interpreta el @ carácter como una macro. Para obtener más información, consulte Definición de una consulta de elementos de trabajo.
Por ejemplo, esta es una consulta para todos los elementos de trabajo etiquetados como Web o Service.
Note
No se pueden consultar elementos de trabajo que no tengan ninguna etiqueta asociada. Si desea votar a favor de la solicitud para admitir esta característica, puede hacerlo en nuestra página de la Comunidad de Desarrolladores, Poder buscar etiquetas vacías.
Mostrar etiquetas en el trabajo pendiente o los resultados de la consulta
Seleccione 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 agregadas a los elementos de trabajo enumerados.
Filtro de listas mediante etiquetas
En el portal web, puede filtrar trabajos pendientes, paneles y resultados de consultas mediante etiquetas.
Para empezar, elija Filtrar
.
Seleccione las etiquetas en las que desea filtrar. Mantenga la selección de OR para ejecutar una operación OR lógica para todas las etiquetas seleccionadas. O bien, elija la opción AND para ejecutar una operación AND lógica en todas las etiquetas seleccionadas.
Supresión, eliminación o administración de etiquetas
No se pueden eliminar etiquetas mediante la interfaz de usuario web de Azure DevOps.
Si necesita quitar una etiqueta, cree un script o una aplicación capaz de eliminar mediante la API REST Azure DevOps o las bibliotecas cliente .NET. Para obtener más ejemplos, consulte Azure-DevOps-Admin-CLI.
Otra opción es instalar el Administrador de etiquetas de Marketplace, que agrega una página Etiquetas en Paneles o Trabajo para administrar etiquetas, incluyendo las eliminaciones.
Etiquetas con código de colores en paneles
Resalte las etiquetas de las tarjetas del panel mediante la codificación con colores. Estos colores solo aparecerán en el panel que configure. No aparecerán en los trabajos pendientes ni en los paneles de tareas. Para obtener más información, vea Asignar colores de etiqueta.
Gráfico de elementos de trabajo y agrupación por etiquetas
No puede agrupar un gráfico basado en consultas por etiquetas, pero puede agrupar un widget Gráfico para elementos de trabajo por etiquetas que puede agregar a un panel. Esta característica está en versión preliminar pública. Para habilitarlo, consulte Administrar o habilitar características y active Habilitar la agrupación por etiquetas para el widget de gráfico del elemento de trabajo en el panel.
Para agrupar un widget Gráfico para elementos de trabajo por etiquetas, complete los mismos pasos proporcionados en Agregar un 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 que muestre 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.
Límites en el número de etiquetas
No existe un límite estricto, pero crear 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 etiqueta muestra un máximo de 200 etiquetas. Si se definen más de 200 etiquetas, comience a escribir para que el control de etiqueta 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. Si supera esa cantidad, es probable que se agote el tiempo de espera de la consulta.
Incorporación de etiquetas a la vista de la columna predeterminada de la página de trabajo pendiente del producto
Para agregar el campo
Usar IA para consultar y gestionar etiquetas de elementos de trabajo
Si tiene el Azure Boards MCP Server conectado a su agente de IA en el modo de agente, puede usar indicaciones de lenguaje natural para buscar y actualizar elementos de trabajo según las etiquetas.
| Tarea | Ejemplo de sugerencia |
|---|---|
| Buscar elementos etiquetados | Find all active work items tagged with "security" in my project |
| Añadir etiquetas en masa | Add the tag "tech-debt" to all active bugs in the current sprint |
| Buscar elementos sin etiqueta | List work items with no tags assigned in the <Contoso> area path |
| Consulta por varias etiquetas | Find user stories tagged with both "performance" and "P1" |
| Enumerar todas las etiquetas en uso | Show all distinct tags used on work items in project <Contoso> sorted by usage count |
| Limpieza de etiquetas obsoletas | List tags in <Contoso> that are used on fewer than 2 work items |
| Reemplazar una etiqueta | Find all work items in <Contoso> tagged "wontfix" and replace that tag with "by-design" |
| Etiquetar por criterios | Add tag "needs-review" to all user stories in <Contoso> that were resolved in the last week but have no linked pull request |
| Análisis de patrones de etiquetas | Show the count of active work items per tag in area path <Contoso\\Frontend> |
| Buscar desajustes de etiquetas | List work items in <Contoso> tagged "sprint-goal" that aren't assigned to the current sprint |
Note
El modo de agente y el servidor MCP usan lenguaje natural, por lo que puede ajustar estas indicaciones o formular preguntas de seguimiento para refinar los resultados.
Contenido relacionado
- Definir una consulta de elemento de trabajo
- Personalizar tarjetas en un panel
- Modificar de forma masiva elementos de trabajo en el portal web
- Modificación de forma masiva de elementos de trabajo en Excel