Una etiqueta es un rótulo de texto libre — smoke, regression, flaky, payments — que asocias a un caso de prueba, un defecto o una ejecución para agrupar trabajo que ninguna carpeta ni suite agrupa por ti. El vocabulario es de toda la organización: hay un solo catálogo por organización y los tres tipos de entidad beben de él. Una etiqueta creada al registrar un defecto es la misma etiqueta que un caso de prueba puede llevar al día siguiente.
Etiquetas en la barra lateral de Workspace, dentro de Configuración y justo después de Campos personalizados, abre /workspace/tags. Cualquier rol puede abrirla; el registro oculta los controles que quien lee no puede usar.
El registro
La tabla lista todas las etiquetas de la organización, ordenadas alfabéticamente por nombre. El orden es fijo: no hay controles de ordenación, porque un vocabulario se lee en orden alfabético.
| Columna | Significado |
|---|---|
| TÍTULO | El nombre de la etiqueta, tal cual está asociado a las entidades |
| AUTOR | Quién creó la etiqueta (avatar y nombre visible), o Sin autor |
| CASOS | Cuántos casos de prueba llevan la etiqueta |
| EJECUCIONES | Cuántas ejecuciones llevan la etiqueta |
| DEFECTOS | Cuántos defectos llevan la etiqueta |
| ACCIONES | Renombrar (permiso de escritura) y eliminar (permiso de eliminación); ocultas si no tienes ninguno |
En pantallas angostas (ancho de teléfono) la tabla se reorganiza como una lista de tarjetas, con el mismo nombre, autor, los tres contadores y las acciones de fila en cada tarjeta.
Búsqueda y filtro de autor
Encima de la tabla, Buscar etiquetas… filtra las filas por nombre con una coincidencia de subcadena, sin distinguir mayúsculas y evaluada en el servidor. Junto a él, el filtro Autor limita la lista a las etiquetas creadas por los miembros que elijas. Un contador indica cuántas etiquetas coinciden con la consulta activa del total, por ejemplo 3 de 41 etiquetas.
Cuando no hay coincidencias, el estado vacío ofrece Limpiar filtros, que quita el texto de búsqueda y la selección de autor a la vez.
Qué significan los contadores
Hay dos cosas que conviene saber sobre las tres columnas de contadores, porque ambas pueden sorprender.
- Cubren solo los proyectos a los que tienes acceso. Una etiqueta asociada a un caso de un proyecto al que nunca te dieron acceso no se cuenta para ti. Por eso dos personas pueden mirar la misma etiqueta y leer números distintos con toda legitimidad: ninguna se equivoca, y ninguno de los dos números es el total de la organización.
- Incluyen los casos de prueba archivados (en la papelera). Es deliberado. Si el único caso que lleva una etiqueta está archivado y el contador marcara
0, la etiqueta parecería sin uso e invitaría a eliminarla, y esa eliminación le quitaría la etiqueta al caso en cuanto alguien lo restaurara. Contar los casos archivados mantiene honesta esa decisión.
Un contador en 0 significa entonces «nada que puedas ver lleva esta etiqueta», no «nada lleva esta etiqueta».
La fila «Sin autor»
La columna Autor muestra Sin autor cuando la etiqueta no tiene creador registrado. No es un error ni un dato faltante: una etiqueta creada por un token de API o por un agente MCP no tiene autor humano por diseño, y tampoco lo tiene una etiqueta cuyo autor fue borrado después. Una etiqueta creada por un compañero que simplemente dejó la organización sigue mostrando su nombre.
Crear una etiqueta
Crear etiqueta abre un diálogo con un único campo Nombre y la nota «Las etiquetas se comparten en toda la organización.»
- El nombre se recorta y debe tener entre 1 y 80 caracteres.
- Los nombres son únicos por organización, y la unicidad distingue mayúsculas:
Smokeysmokeson dos etiquetas distintas y pueden convivir. Si quieres un solo vocabulario en lugar de dos, acuerda una convención de mayúsculas. - Guardar un nombre que ya existe se rechaza con «Ya existe una etiqueta con ese nombre.»
Renombrar una etiqueta
Renombrar en una fila abre el mismo diálogo de un solo campo, con la nota «Renombrar una etiqueta la cambia en todos los lugares donde está asociada.» El cambio alcanza a todos los casos de prueba, defectos y ejecuciones que la llevan; nada se desasocia y ningún elemento se modifica por lo demás. Rigen el mismo límite de 80 caracteres y la misma regla de unicidad, así que no puedes renombrar una etiqueta hacia un nombre que ya tenga otra.
Eliminar etiquetas
Eliminar en una fila pide confirmación y dice sin rodeos qué hace: quita la etiqueta de todos los casos de prueba, defectos y ejecuciones a los que esté asociada. Esos elementos no se eliminan: solo desaparecen la etiqueta y sus asociaciones. La acción no se puede deshacer.
Para quitar varias a la vez, marca las casillas de la primera columna y usa Eliminar seleccionadas (n). El diálogo del lote lleva la misma advertencia y admite hasta 100 etiquetas por vez. Si el registro informa menos eliminaciones de las que seleccionaste, la diferencia son etiquetas que ya no existían; por ejemplo, porque un compañero eliminó una mientras tu página estaba abierta.
Quién puede hacer qué
El registro se rige por dos permisos, no por roles directamente:
| Acción | Permiso | Hoy lo tienen |
|---|---|---|
| Leer el registro, buscar y filtrar | ninguno | cualquier miembro de la organización |
| Crear una etiqueta, renombrar una etiqueta | tags.write | owner, admin, member |
| Eliminar una etiqueta o un lote de ellas | tags.manage | owner, admin |
La separación existe porque eliminar una etiqueta la desasocia de todos los elementos que la llevan, y esa consecuencia llega más lejos que ampliar el vocabulario. Un viewer no tiene ninguno de los dos permisos: el registro se abre, y el botón de crear, las acciones de fila y las casillas de selección sencillamente no están.
Etiquetar sin abrir el registro
No hace falta crear antes la etiqueta aquí. Escribe un nombre nuevo en el campo de etiquetas de un caso de prueba, un defecto o una ejecución y el servidor crea la entrada del catálogo y la asocia en el mismo guardado, de modo que aparece en este registro de inmediato, con quien la escribió como autor.
Esos mismos campos también sugieren desde el catálogo mientras escribes, que es la defensa práctica contra un vocabulario con tres grafías de la misma idea. De que las etiquetas se asocien por nombre se desprenden dos detalles:
- Quitar todas las etiquetas de un elemento y guardar lo deja sin etiquetas, en lugar de con una lista vacía.
- Las etiquetas vuelven en orden alfabético, nunca en el orden en que las escribiste.
Eliminar una etiqueta desde este registro es la única forma de retirarla del vocabulario; quitarla del último elemento que la llevaba deja la entrada del catálogo en su sitio, ahora con 0.