🖥️ Globals: Escribir Variable — Configuración
Objetivo Principal: Permite al usuario enviar un valor a una variable actuadora del catálogo, ya sea una sola variable o varias a la vez a través de una estructura tipada UDT.
Esta página describe una pantalla que aún no está fotografiada en el manual, así que el despiece no numera los elementos sobre una imagen. Lo que se cuenta aquí está contrastado con la versión 0.4.46 de la aplicación.
El nodo se añade desde la biblioteca de nodos del editor de workflows, en el grupo Globals, con el nombre Escribir variable. Ese grupo solo está disponible en los workflows de tipo orquestador: en los de tipo bloque de función o función no aparece. Una vez colocado en el lienzo, su ventana de configuración se abre con doble clic sobre el nodo, o con el botón derecho y la opción Configurar.
🧩 Despiece de Elementos Funcionales
| Nombre del Elemento | Tipo | Destino / Acción | Descripción Funcional |
|---|---|---|---|
| Campo "Nombre del nodo" | Campo de texto | Cambia el nombre del nodo dentro del workflow | Nombre identificativo del nodo: titula esta ventana y es el rótulo que el nodo muestra en el lienzo. Al añadirlo llega con el valor «Escribir variable». |
| Campo "Descripción (opcional)" | Área de texto | Almacena una descripción libre del nodo | Campo opcional de dos líneas para documentar el propósito del nodo. Llega relleno con el texto que la biblioteca de nodos muestra bajo «Escribir variable», y se puede sustituir por completo. |
| Selector "Modo" | Conmutador de dos botones | Decide si el nodo escribe una variable o varias | Alterna entre «Variable suelta» (opción por defecto) y «UDT», y cambia el resto del formulario. Debajo explica el modo activo: en «Variable suelta», «Escribe 1 variable actuadora con el valor que llega por la patilla "valor".»; en «UDT», «Escribe varias variables reales de un asset a partir de un objeto UDT que llega por la patilla "valor" (p.ej. la salida de un FC).». |
| Selector "Variable actuadora a escribir" | Desplegable con buscador · solo en modo «Variable suelta» | Elige la variable de destino | Mientras no hay selección muestra «Selecciona una variable actuadora...». Solo lista variables activas y marcadas como actuadoras: las de solo lectura no aparecen. Ofrece el campo «Buscar variable...» y agrupa los resultados por activo cuando abarcan más de uno, con los mismos estados que el resto de selectores de variable («Cargando...», «No se encontraron variables» y el botón «Cargar más»). Es obligatorio: si se guarda sin elegir ninguna, el campo se marca en rojo con el mensaje «Selecciona una variable actuadora». |
| Campo "Valor a escribir" | Campo de texto · solo en modo «Variable suelta» | Define qué valor se envía a la variable | Admite un valor fijo o una expresión que toma el dato de otro punto del workflow. Sugiere el ejemplo Ej: 1, 0, {{data.mi_valor}} y explica debajo que acepta un «Valor literal o expresión del contexto con {{data.clave}}». Es obligatorio en los dos modos: sin él, el campo se marca en rojo con «El valor a escribir es obligatorio». |
| Bloque "Mapeo global → UDT" | Formulario de mapeo · solo en modo «UDT» | Reparte cada campo de la estructura entre sus variables reales | Es el mismo formulario que usa el nodo Variable UDT, con sus cuatro bloques (contexto del binding, campos detectados, mapeo y resumen final) y sus botones Auto-map, Limpiar mapeo e Ignorar por campo; el despiece completo está en Variable UDT. Debajo recuerda que el objeto que llega por la patilla «valor» debe traer una clave por cada campo de la estructura. Exige mapear al menos un campo: en caso contrario aparece «Mapea al menos un campo UDT (o ignora los que no apliquen)». |
| Campo "TTL del comando (ms)" | Campo numérico | Limita cuánto se espera la confirmación del actuador | Valor en milisegundos, con un mínimo de 500 y saltos de 500; por defecto, 5000. Debajo, la aplicación indica que es el tiempo máximo que se espera la confirmación del actuador. Solo interviene cuando la variable de destino corresponde a un equipo físico. |
| Botón "Cancelar" | Botón secundario | Cierra el panel sin guardar cambios | Descarta cualquier modificación realizada y devuelve al estado anterior. |
| Botón "Guardar cambios" | CTA Principal | Persiste la configuración del nodo | Guarda el modo, el destino y el valor, y cierra el panel. En modo «UDT» permanece deshabilitado mientras el mapeo no sea válido. Editar y guardar automatizaciones exige rol de administrador de empresa. Con el perfil Mantenimiento el editor se abre en modo solo lectura —lo advierte la franja «Modo solo lectura — los cambios requieren rol de administrador de empresa»—, así que este panel no llega a poder modificarse; el perfil Usuario no accede al módulo. El servidor repite la comprobación y rechaza con «Acceso denegado» cualquier guardado que llegue por otra vía. |
| Aviso de campos incorrectos | Mensaje de error | Señala que la ventana tiene campos sin completar | Cuando algún campo obligatorio falla, aparece al pie el mensaje «Revisa los campos marcados en rojo». |
💡 Guía de Uso
- Abre el grupo Globals en la biblioteca de nodos y haz clic sobre Escribir variable, o arrástrala hasta el lienzo.
- Haz doble clic sobre el nodo para abrir su configuración.
- Elige el Modo: «Variable suelta» para actuar sobre un único punto, «UDT» para escribir de una vez varios campos de un mismo activo.
- En modo «Variable suelta», selecciona la variable actuadora de destino y escribe el valor.
- En modo «UDT», completa el mapeo tal y como se describe en Variable UDT, ignorando los campos que ese activo no tenga.
- Ajusta el TTL del comando si el actuador tarda en confirmar más de lo habitual.
- Pulsa Guardar cambios para confirmar, o Cancelar para descartar.
- De vuelta en el lienzo, conecta a la patilla valor la salida del nodo que produce el dato, y encadena la ejecución con las patillas EN y ENO.
En el lienzo el nodo se dibuja como una acción con la patilla de habilitación EN a la izquierda, la entrada de datos valor, y la patilla ENO como única salida: no publica ningún dato conectable hacia otro nodo. En su cuerpo muestra la etiqueta VAR con la variable de destino y el valor configurado, o la etiqueta UDT con el activo, el tipo de estructura y cuántos campos se escriben y cuántos quedan ignorados.
Si la variable elegida no está marcada como actuadora, la ejecución del nodo falla con un mensaje que lo indica: solo se pueden escribir actuadores. En variables de equipo físico, el nodo no da la escritura por buena hasta que el dispositivo la confirma; si el equipo la rechaza o pasa el tiempo configurado sin confirmarla, el paso se marca como fallido.
En modo «UDT» la escritura es todo o nada: antes de enviar la primera orden se comprueban todos los destinos, y si alguno de los campos que traen dato tiene un mapeo inválido no se escribe nada. Los campos válidos se escriben después uno detrás de otro, no a la vez. Un campo marcado como Ignorar nunca se escribe, aunque el objeto de entrada traiga un valor para él.