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 del work item, 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 work item.
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 espacio, puede dejarlo vacío. El work item se guardará y, en la vista, aparecerá un indicador gris para representar la ausencia de valor.

Interpretar el indicador en la vista del work item

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 work item (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 work item, o
• El administrador aún no ha configurado los umbrales para el contexto del campo (espacio / tipo de work item).

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 o por color 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.

Para buscar por color, sin conocer los umbrales, use la función trafficLightBand con "red", "yellow" o "green":

issue in trafficLightBand("red")

issue in trafficLightBand("red", "Nivel de cumplimiento") AND project = "ACME"

El segundo argumento es opcional y limita la búsqueda a un campo concreto. La función aplica los umbrales que su administrador configuró para cada espacio y tipo de work item, y también sirve en filtros guardados y dashboards.

Unos segundos de espera

Si acaba de cambiar el valor del campo, el work item puede tardar unos segundos en aparecer en la búsqueda por color: es el tiempo que tarda Jira en indexar el cambio. Un campo vacío no coincide con ningún color.