Tarjeta de KPI

Referencia del componente de panel de control Tarjeta de KPI, su minigráfica y su distribución, las estadísticas de la ventana, la retención y todas sus propiedades del editor.

Ver como Markdown

La Tarjeta de KPI escribe grande un punto numérico, con una minigráfica opcional debajo y estadísticas opcionales de la ventana mostrada al lado. La tarjeta recolecta sus propias muestras por el recolector de series en vivo de la estación, así que abre sobre una ventana llena en lugar de sobre un dibujo vacío. Cuando el punto no tiene lectura, la tarjeta muestra la marca de hueco (—) y ninguna unidad; las bandas declaradas tiñen la lectura según dónde caiga, y una lectura que ninguna banda reclama no toma color alguno. NaN es una lectura, no un hueco: la tarjeta escribe esa palabra junto a su unidad y, como NaN no tiene lugar en una escala, ninguna banda la tiñe y la diferencia muestra la marca de hueco.

Datos

Propiedad	Qué hace	Valores	Predeterminado
Dirección	La dirección de Logic con raíz del punto numérico que se muestra. El campo sugiere desde la lista viva de puntos, filtrada a puntos numéricos, y muestra la lectura actual del punto en cuanto se nombra.	dirección	vacía

Formato

Propiedad	Qué hace	Valores	Predeterminado
Unidad	Sufijo de unidad opcional escrito junto al valor.	texto	vacía
Decimales	Decimales fijos para los visores (el titular, las estadísticas y la diferencia por igual). En blanco, el titular de un punto cuyo tipo es un número entero se escribe sin fracción, y cualquier otro con los decimales de la estación; el mínimo y el máximo de la ventana, lecturas de ese mismo punto, siguen al titular, mientras que el promedio toma los decimales de la estación, porque un promedio de números enteros casi nunca es entero. En blanco, la referencia y la diferencia también siguen los decimales del punto, como el titular: ninguno en un número entero, los de la estación en cualquier otro.	De 0 a 15	en blanco usa la preferencia de la estación
Dígitos	Cuántas posiciones reserva el titular antes del separador decimal; una lectura que las rebasa se marca (`####`) con la lectura completa en la información emergente. Un punto que contesta con palabras (una orden, un lote, una bandera) nunca lleva esa marca: lo que el campo no puede sostener termina en puntos suspensivos (…), con la lectura completa en la información emergente.	De 1 a 20	en blanco reserva 5
Tamaño de letra	Si la celda decide el tamaño de letra o si el operador lo indica.	Tan grande como permita la celda · Un tamaño que yo indico	Tan grande como permita la celda
Puntos	El tamaño indicado, dibujado literalmente en cualquier celda. Sale solo en el modo indicado.	De 9 a 144	12
Se lee como	Cómo se escriben los visores.	Número · Porcentaje · Duración	Número
El valor cuenta	Qué significa una unidad del valor mientras el formato es una duración.	Segundos · Milisegundos · Minutos	Segundos
Mostrar el mín	Escribe el mínimo de la ventana mostrada en la fila de estadísticas.	encendido / apagado	encendido
Mostrar el máx	Escribe el máximo de la ventana mostrada.	encendido / apagado	encendido
Mostrar el promedio	Escribe el promedio de la ventana mostrada.	encendido / apagado	apagado
Mostrar la diferencia respecto a la referencia	Escribe qué tan lejos está la lectura de la referencia declarada, como `Δ` bajo el valor, con la referencia misma en la información emergente. No dice nada mientras no hay ninguna referencia declarada: una diferencia contra nada no es una lectura.	encendido / apagado	apagado

Las estadísticas y la diferencia son segundas lecturas de ese mismo valor, escritas con la declaración propia de la tarjeta; se quedan en el tamaño chico de la tarjeta sea cual sea el tamaño de letra del titular.

Las estadísticas se escriben en la letra más chica que dibuja un panel de control, así que una tarjeta demasiado angosta para toda su línea en ese tamaño nunca corta una estadística a la mitad de su número: la línea queda detrás de la marca ####, con todas las estadísticas en su información emergente. El espacio que pide la línea sale de la declaración (Dígitos y Decimales), no de las lecturas en pantalla.

Minigráfica

Propiedad	Qué hace	Valores	Predeterminado
Dibuja	Qué dibuja la tarjeta bajo la lectura. El valor, su calidad y la banda en la que cae son los mismos se dibuje lo que se dibuje.	Una línea sobre la ventana · La distribución de las muestras · Nada	Una línea sobre la ventana
Clases	En cuántas clases iguales corta la distribución el rango observado. Sale solo en la distribución.	De 2 a 40	10
Sobre (muestras)	Cuántas de las muestras recolectadas más nuevas cuenta la distribución. Enmarca la distribución igual que la ventana enmarca la minigráfica; más de las que sostiene el búfer cuenta lo que hay, porque las clases son de lecturas observadas y de nada más.	De 2 a 20 000	120
Acento	De dónde viene el color de la minigráfica. Es identidad, no significado: las bandas se quedan con la última palabra sobre las clases de una distribución.	La tinta de siempre · Un color · Un punto de color	La tinta de siempre
Claro / Oscuro	El acento como un par claro y oscuro, los dos indicados porque el tema en marcha decide cuál mitad está en pantalla. Sale solo mientras el acento es un color.	`#RRGGBB` cada uno	`#5470C6` los dos
Punto de color	La dirección de Logic con raíz de un punto de Color al que sigue el acento. Sale solo mientras el acento es un punto de color.	dirección	vacía

Una distribución cuenta solo las muestras buenas y finitas, así que la mala calidad se lee como menos muestras contadas, exactamente igual que se lee como un hueco en una línea. Cuando todas las muestras contadas leyeron ese mismo valor, hay una sola clase que las contiene a todas. La tarjeta rotula la distribución con lo que contó.

Histórico

Dos perillas distintas, iguales a las del Gráfico de líneas: la ventana es lo que enmarca la tarjeta, y la retención es lo que guarda la estación detrás. Las muestras viven en memoria; reiniciar la aplicación empieza la recolección de nuevo.

Propiedad	Qué hace	Valores	Predeterminado
Conservar	Qué significan los números de retención.	solo la ventana · un tramo de tiempo · un número de muestras	solo la ventana
Conservar durante (s)	El tramo que se guarda mientras la retención es un tramo de tiempo.	De 5 a 604 800 (7 días)	600
Conservar (muestras)	El conteo que se guarda mientras la retención es un número de muestras.	De 2 a 20 000	2000

La estación concede la retención dentro de tres topes: 20 000 muestras por punto, 60 000 por componente y 200 000 para la estación entera. Una retención que un tope no pudo conceder entera se dice en la propia tarjeta, no solo en el editor, para que un operador en un cliente de solo lectura nunca lea un historial más corto sin nada que lo explique. Cuando el tope de la propia estación ya está gastado, la tarjeta no recolecta nada y lo dice: "La estación ya guarda todo el historial que permite, así que esta serie no recolecta nada. Acorte la retención de otro gráfico para hacer espacio.".

Avanzado

Una sección plegada para los dos campos que casi ninguna tarjeta toca.

Propiedad	Qué hace	Valores	Predeterminado
Ventana (s)	La ventana deslizante que cubren la minigráfica y las estadísticas.	De 5 a 86 400 (1 día)	60
Muestrear cada (ms)	La cadencia de muestreo propia de la tarjeta.	De 100 (el ciclo) a 3 600 000 (1 h)	500

Escala

La sección Escala compartida declara las bandas y la referencia.

Cada banda cubre todo hasta su límite, desde donde terminó la banda que está encima de ella; el tono (Neutro, Información, Correcto, Precaución, Crítico) tiñe el titular, y una banda redactada escribe su nombre en la fila de estadísticas, lo único que el color no puede decir.
La referencia es contra lo que se mide la diferencia: nada, un valor fijo, o un punto que se mueve con la receta.