Uso del campo Semáforo 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.

Capturar un valor en el campo

Cuando el campo Semáforo forma parte de la pantalla de Creación, Edición o Transición, aparece como un campo numérico.

1. Abra el formulario de creación, edición o transición del issue.
2. Localice el campo (el nombre exacto lo define el administrador, por ejemplo "Nivel de cumplimiento").
3. Introduzca el valor numérico.
4. Guarde los cambios.

Si el valor introducido no es un número válido, Jira mostrará el mensaje "Please enter a valid number." y no permitirá guardar hasta que el valor sea numérico.

Puede dejarlo en blanco

Si el campo no está marcado como obligatorio en su proyecto, puede dejarlo vacío. El issue se guardará y, en la vista, aparecerá un indicador gris para representar la ausencia de valor.

Interpretar el indicador en la vista del issue

Una vez guardado, el campo se muestra como un indicador de color junto al valor numérico. El color (rojo, amarillo o verde) lo determina el administrador mediante los umbrales configurados en el contexto del campo.

Leyenda

Debajo del indicador encontrará una leyenda descriptiva con los rangos definidos por su administrador, por ejemplo:

🔴 Red: ≤ 30 — 🟡 Yellow: 30 < value ≤ 70 — 🟢 Green: > 70

Esto le permite saber, sin consultar a su administrador, qué rango representa cada color y cuál es la situación deseable.

Tooltip

Al pasar el cursor sobre el indicador de color, aparece un tooltip con el rango exacto al que pertenece el valor actual del issue (por ejemplo, "Red: ≤ 30" o "Green: > 70").

Modo oscuro

El indicador, la leyenda, el tooltip y el valor numérico están diseñados para mantener un contraste accesible tanto en el tema claro como en el tema oscuro de Jira Cloud. Si cambia de tema, no perderá legibilidad.

¿Por qué a veces el indicador es gris?

El indicador se renderiza en gris cuando:

• El campo está vacío en el issue, o
• El administrador aún no ha configurado los umbrales para el contexto del campo (proyecto / tipo de issue).

En ambos casos, consulte con su administrador si esperaba ver un color.

"Menor es mejor": qué significa

Algunos KPIs miden situaciones donde un valor bajo es deseable (por ejemplo, tiempo de resolución o número de incidentes abiertos). En esos casos, su administrador puede haber activado el modo "Lower value is better" en el contexto del campo.

Cuando este modo está activo:

• 🟢 Verde indica valores bajos (mejor desempeño).
• 🔴 Rojo indica valores altos (peor desempeño).
• 🟡 Amarillo se mantiene en el rango intermedio.

La leyenda y el tooltip reflejan automáticamente esta inversión, por lo que siempre podrá interpretar el indicador sin ambigüedad.

Buscar issues por valor del Semáforo

Puede usar JQL para localizar issues filtrando por el valor numérico del campo:

"Nivel de cumplimiento" < 30

"Nivel de cumplimiento" >= 70 AND project = "ACME"

"Nivel de cumplimiento" is not EMPTY

Reemplace Nivel de cumplimiento por el nombre exacto que su administrador haya asignado al campo.

JQL trabaja sobre el valor numérico, no sobre el color

Para listar, por ejemplo, "todos los issues en rojo", combine los operadores JQL con los umbrales del contexto: "Nivel de cumplimiento" <= 30 (en el modo por defecto). El motor de Jira no conoce el color; opera siempre sobre el número almacenado.