Saltar al contenido
Elausys

HyperVisu / Configuración del dispositivo

Transformaciones de valores y Health

Convierta unidades, invierta, escale y limite valores, y corrija lo que señala la página Health.

elausys · 20 julio 2026
En esta página

Los dispositivos reales rara vez entregan exactamente el valor que la aplicación necesita: un contador envía décimas de kilovatio, un byte de estado agrupa ocho indicadores, un relé usa lógica invertida. Las transformaciones convierten el valor del protocolo en el valor mostrado, objeto por objeto. La página Health vigila después cada enlace y cada transformación de la instalación.

Transformaciones

Cada objeto de comunicación puede llevar una cadena de transformaciones ordenada. Despliegue el dispositivo y, en la fila del objeto, haga clic en el icono redondo bajo TRANSFORMS (Transformations): el engranaje contiguo abre los ajustes del objeto, no la cadena. Después haga clic en Add Transformation y elija un tipo:

TipoQué hace
Scale & OffsetConversión lineal: (value × scale) + offset. Conversiones de unidades, escalado de contadores.
Invert BooleanIntercambia verdadero y falso, para protocolos en los que 0 significa ON.
Bit ExtractExtrae un rango de bits de un entero (bit inicial, número de bits, opcionalmente con signo).
Bit CheckComprueba un bit de un entero y devuelve un booleano (opcionalmente invertido).
Value MapSustituye valores de entrada indicados por otros valores, un par Input → Output por línea. Los valores pueden ser números o texto, y el resultado puede ser un booleano, de modo que sirve tanto para un número de modo renumerado para otro dispositivo como para un estado de texto como open / closed convertido en encendido/apagado. Un Default Value opcional se usa cuando ninguna línea coincide (de lo contrario, el valor original pasa sin cambios); Strict mode notifica un error en su lugar.
ClampLimita los valores a un rango (o al mínimo/máximo propio del objeto).
ThresholdConvierte un número en un booleano (>, >=, <, <=, ==, != frente a un umbral, con histéresis opcional).
RoundRedondea a una precisión (round, floor, ceiling, truncate).

Cada transformación tiene una dirección:

  • Incoming: protocolo → widget (lo que muestra la aplicación).
  • Outgoing: widget → protocolo (lo que envía un comando).
  • Both: se aplica en ambas direcciones cuando la operación es reversible.

Solo se pueden seleccionar las direcciones que admite una transformación: Round, por ejemplo, es solo de entrada (Incoming). En un objeto que solo recibe o solo envía valores, la dirección sigue al objeto y no se puede cambiar. En un objeto de lectura y escritura, un paso nuevo empieza en Both.

Las cadenas se ejecutan de arriba abajo; arrastre para reordenar. Cada paso tiene su propio Preview en su cuadro de diálogo: escriba un valor en Input y lea Output. La vista previa prueba ese único paso, no toda la cadena. Para comprobar la cadena, guárdela, aplique los cambios y compárela con una lectura real.

Haga clic en Save Changes para guardar la cadena, luego en Apply changes en la barra lateral y confirme (vea “Admin Panel Tour”).

📘 Nota: Compruebe primero si el enlace de protocolo ya escala el valor: un objeto Modbus tiene sus propios Scale y Offset (vea “Modbus TCP Integration”). Aplique cada conversión una sola vez.

El editor de transformaciones para un objeto de potencia Modbus.

Validación. El editor valida toda la cadena frente a los tipos del objeto y del protocolo:

  • Los problemas bloqueantes (p. ej., escala cero o una salida de la cadena incompatible con el tipo de objeto) deben corregirse primero: Save Changes permanece desactivado mientras quede alguno.
  • Las advertencias (p. ej., una conversión forzada o con posible pérdida) permiten guardar, pero dejan el objeto señalado en la página Health. Una advertencia “Duplicate order 0” en pasos recién añadidos desaparece una vez guardada la cadena.

Cuándo necesita una transformación

El espacio de trabajo Devices indica cuándo es necesaria una transformación: el cuadro de diálogo de discrepancia de DPT al enlazar KNX (vea “KNX Integration”) y la advertencia de tipo de datos en los ajustes del objeto (vea “Object Settings, Logging & Notifications”). Mientras la transformación de conversión no esté en su sitio, el objeto aparece en la página Health.

La página Health

En la página Devices, haga clic en el botón de icono redondo de la cabecera (su información emergente dice Health). La página lista cada objeto con un problema:

  • un enlace protocolo ↔ widget incompatible (un enlace cuyos tipos no encajan);
  • un problema de configuración de una transformación;
  • un error reciente en tiempo de ejecución (un valor que no se pudo convertir en ejecución).

Cada fila es un objeto. Indica el dispositivo, el objeto, su tipo y su tipo de datos, y solo da recuentos: el número de problemas de configuración y el número de errores en tiempo de ejecución. Una cruz roja marca un error y un triángulo ámbar una advertencia. Los mensajes en sí no figuran en la fila. Desde una fila puede:

  • Hacer clic en la fila para abrir el cuadro de diálogo Problems. Da el mensaje de cada problema de configuración y, bajo Runtime (recent), los errores de conversión registrados con sus valores.
  • Hacer clic en la flecha del final de la fila (Open in Devices): lleva directamente al dispositivo para corregir el enlace o la cadena.

Clear runtime errors está en dos lugares. En el cuadro de diálogo Problems borra únicamente los errores en tiempo de ejecución registrados de ese objeto. En la cabecera de la página borra los de todos los objetos; el botón solo se muestra mientras existan errores en tiempo de ejecución. Borrar no corrige una causa: ofrece una pizarra limpia para verificar una corrección con valores nuevos. Guardar una cadena de transformaciones corregida ya borra los errores en tiempo de ejecución de ese objeto.

Tras una corrección, haga clic en Apply changes en la barra lateral y confirme; después haga clic en Refresh en la página Health. Un problema de configuración corregido sale de la lista por sí solo.

Cuando todo está bien, la página indica No problems found — All widget objects are healthy.

📘 Nota: Health comprueba enlaces, transformaciones y errores de conversión registrados. No informa de un dispositivo inaccesible ni de una conexión perdida: compruébelos en la página Connections (vea “Connections”) y con una prueba física. Los errores en tiempo de ejecución se conservan en memoria, los diez últimos por objeto, por lo que un reinicio del servidor los vacía; una causa persistente vuelve a aparecer con el siguiente valor fallido.

💡 Consejo: Tras la puesta en marcha, abra la página Health una vez con la instalación en funcionamiento durante unas horas: detecta las discrepancias que solo aparecen cuando empiezan a circular valores reales.

La página Health sin ningún problema que notificar.

Preguntas frecuentes

¿Cómo escalo la lectura de un dispositivo?

Añada una transformación Scale & Offset al objeto de comunicación. Aplica (valor × escala) + offset.

¿Importa el orden de las transformaciones?

Sí. Las cadenas se ejecutan en orden. Arrastre las transformaciones para reordenarlas. El Preview de cada paso prueba solo ese paso, así que compruebe toda la cadena con una lectura real.

¿Cuál es la diferencia entre las transformaciones incoming y outgoing?

Incoming convierte los valores del protocolo para mostrarlos. Outgoing convierte los comandos del widget para el protocolo. Both se aplica en cada dirección donde la operación es reversible.

¿Por qué no puedo guardar una cadena de transformaciones?

Los problemas bloqueantes, como una escala cero o un tipo de salida incompatible, deben corregirse primero. Las advertencias permiten guardar, pero dejan el objeto señalado en Health.

¿Borrar los errores en tiempo de ejecución corrige la causa?

No. Corrija primero el enlace o la transformación y luego borre los errores registrados para comprobar si aparecen otros nuevos.

Seguir explorando

Encuentre las demás guías de este producto en la documentación.

Volver a Configuración del dispositivo