Uso del campo Traffic Light KPI

Esta guía describe cómo trabajar con un campo personalizado de tipo Traffic Light KPI ya configurado por su administrador. Si todavía no ve el campo en sus pantallas de issue, consulte con su administrador de Jira: probablemente sólo falte añadirlo a la pantalla correspondiente o definir los umbrales del contexto.

Capturar un valor en un issue

Cuando el campo Traffic Light KPI forma parte de la pantalla de Creación o Edición de un issue, aparecerá como un campo numérico simple, listo para introducir un valor.

1. Abra el formulario de creación o edición del issue.
2. Localice el campo Traffic Light KPI (el nombre exacto lo define el administrador, por ejemplo "Nivel de cumplimiento" o "Riesgo del proyecto").
3. Introduzca el valor numérico que corresponda al issue (por ejemplo 45, 92.5).
4. Guarde los cambios.

Si introduce un texto que no es un número válido, Jira mostrará un mensaje de error y no permitirá guardar hasta que corrija la entrada.

Visualizar el indicador en el issue

Una vez guardado, el campo se muestra en la vista del issue como un indicador de tres focos (verde, amarillo y rojo) acompañado del valor numérico capturado. El foco encendido refleja el estado:

• 🟢 Verde: el valor está por encima del umbral amarillo definido por su administrador (situación favorable).
• 🟡 Amarillo: el valor se encuentra entre los umbrales rojo y amarillo (situación intermedia / en riesgo).
• 🔴 Rojo: el valor está dentro del umbral crítico (situación adversa).
• ⚪ Gris: el campo está vacío o el administrador todavía no ha configurado los umbrales para ese contexto.

El indicador también aparece en los listados de issues (vista del navegador, gadgets de dashboard, tableros) en una versión compacta, lo que permite leer el estado de varios issues de un vistazo.

¿Qué umbrales se aplican?

Los umbrales pueden variar entre proyectos o entre tipos de issue: su administrador puede definir reglas distintas en cada contexto. Si tiene dudas sobre por qué un valor concreto se ve de un color específico, consulte con su administrador qué umbrales rigen en el contexto de ese issue.

Buscar issues por valor

Puede localizar issues por el valor del campo Traffic Light KPI de dos maneras:

1. Desde el buscador básico

En la vista de Issues, despliegue los filtros avanzados y localice el campo Traffic Light KPI entre los filtros disponibles. Podrá filtrar por rango numérico (igual a, mayor que, menor que, entre dos valores).

2. Desde JQL

También puede usar JQL para consultas más complejas. Por ejemplo:

"Nivel de cumplimiento" < 30
"Nivel de cumplimiento" >= 70 AND project = "ACME"
"Riesgo del proyecto" >= 1 AND "Riesgo del proyecto" <= 3

Reemplace el nombre del campo por el que su administrador haya asignado.

Las consultas operan sobre el valor numérico

Las consultas JQL no filtran por color sino por el valor numérico almacenado. Para listar, por ejemplo, "todos los issues en rojo", combine el operador con el mismo umbral rojo que rige en el contexto: "Nivel de cumplimiento" <= 30.

Cuando dejarlo en blanco

Si el campo no está marcado como obligatorio en su proyecto, puede dejarlo en blanco sin que se produzca ningún error. El indicador se renderizará en gris para señalar que no hay valor asociado al issue.