Los paneles de control permiten a un operador actuar desde un tablero: arrancar una bomba, encender una luz, cambiar un punto de consigna, guardar un grupo de umbrales. Un control envía un comando del catálogo de comandos del perfil del dispositivo. Esta página explica cómo configurar uno, qué comandos puede enviar un tablero y qué ve el operador.
Qué puede enviar un tablero
Un tablero envía comandos mediante Enviar un comando a un dispositivo. Las reglas son estrictas a propósito:
| Regla | Detalle |
|---|---|
| Solo comandos del catálogo | El comando debe estar en el catálogo Commands del perfil del dispositivo. Un método sin procesar se rechaza: «Este comando no está en el catálogo del perfil del dispositivo, por lo que no se puede enviar desde un tablero.» |
| Solo nivel básico | Un comando Privileged o Critical, y cualquier comando de alto impacto, se rechaza: «Este comando no se puede enviar desde un tablero: envíelo desde la consola del dispositivo.» |
| Permisos | El operador necesita Run widget commands y el permiso para enviar comandos básicos, y debe poder leer la telemetría del dispositivo. En caso contrario: «No tiene permiso para usar este control.» |
| Límite de frecuencia | Como máximo 30 comandos por minuto por persona. Después: «Demasiados comandos; inténtelo de nuevo en un minuto.» |
| Pantallas de visualización | Los controles están inactivos en un enlace de visualización. |
Para añadir un comando a un perfil y elegir su nivel, consulte Envío de comandos a dispositivos.
Configurar un control
- Personalice el tablero y añada un Button, Switch, Slider, Set point o Form.
- En el cajón de ajustes, abra las acciones (When this control is used, o When Apply is pressed para un punto de consigna y un formulario) y añada Run a command.
- Elija el Device (o tómelo de un parámetro del tablero), el Command del catálogo de ese dispositivo, y el Control y el Value que recibe el comando.
- Elija de dónde procede cada parámetro del comando: A fixed value, A dashboard parameter, The control’s value, The control’s value, scaled, A value map, A form field, o The clicked row’s column.
- En un interruptor, deslizador o punto de consigna, vincule la ranura Current value (o Current state) al valor del dispositivo que cambia el comando, para que la tarjeta muestre lo que el dispositivo tiene ahora.
- Seleccione Save.
Hasta que se elija un comando, la tarjeta muestra «Elija un comando en los ajustes de este widget (When this card is clicked → Run a command).»
Los controles
| Control | Función | Ajustes principales |
|---|---|---|
| Button | Ejecuta sus acciones al pulsarlo: un comando, o cualquier otra acción como abrir una página. | Diseño Button, Tile with icon, Round icon, Floating pill; Button text; Icon; Description (una línea que explica lo que hace); estilo Filled, Outlined, Plain, Underlined; tamaño S, M, L |
| Switch | Lee un valor de encendido/apagado y envía un comando al cambiar. | Diseño; Show the state as Large text, Status pill o Nothing; On text, Off text, Unknown text; un icono por estado |
| Slider | Lee un número y envía el nuevo una sola vez, al soltar. | Minimum 0, Maximum 100, Step 1; horizontal o vertical; marcas de graduación; posición del valor |
| Set point | Un campo numérico con Apply, un selector incremental o un dial. Las entradas fuera de rango son un error de campo y no envían nada. | Type and apply, Minus and plus buttons, Dial with minus and plus; rango y paso; Show the current value; Apply button text |
| Form | Varios campos guardados juntos con un solo comando. | Fields (hasta 40): Key, Label, Kind (Number, On / off, Text, One of a list), rango, unidad, Only when on, Required, Show only, Section; Take the fields from the source; Save button text; Show a reset button |
El comando de un formulario lee los valores guardados por clave: {"$field": "lowThreshold"} en los parámetros del comando. Take the fields from the source edita todos los campos que describe el registro vinculado cuando no enumera ningún campo.
Botones de alternancia
Un Button puede mostrarse como pulsado mientras se cumple una condición (Pressed when parameter, Pressed when column…), por ejemplo un botón «Manual mode» que permanece pulsado mientras el parámetro de modo del tablero sea manual. Not a toggle es el valor por defecto. Un botón también puede estar Enabled only when un parámetro coincide.
Desactivar con datos antiguos
Disable the control when (switch, slider, set point, form) es The reading is old por defecto, y también puede ser The state is unknown. El motivo se muestra en una sugerencia. El servidor sigue comprobando todo al ejecutar el comando.
Confirmación
Un comando de dispositivo desde un tablero pide confirmación primero, por defecto. Cada entrada Run a command tiene Ask before running, activada por defecto. El operador ve entonces un diálogo «Run Set speed» con «Are you sure?» y lo que cambiará, por ejemplo «Pump 2: Speed → 60», y un botón Confirm. Desactive Ask before running solo en controles de bajo riesgo, como un interruptor de luz. El servidor aplica la misma regla, así que otro cliente no puede saltarse la pregunta.
Un comando también puede exigir una confirmación escrita: el diálogo añade «Type «START PUMP» to confirm», donde la frase es el texto de confirmación del comando o, si no lo tiene, su etiqueta.
Texto: Confirmation question y Confirm button en los ajustes del control cambian las palabras del diálogo, no el texto que hay que escribir.
Respuesta y lectura de vuelta
| La tarjeta muestra | Significado |
|---|---|
| «Sending…» | El comando está en camino. |
| «Done.» o «Done: 60» | El dispositivo respondió; su respuesta se muestra como texto. |
| «Sent; waiting for the device.» | El comando está en cola, por ejemplo para un dispositivo sin conexión con un comando persistente. |
| «No answer after 30 seconds. The command may still run; check its target before you try again.» | No hay respuesta en 30 segundos. |
| «The command failed.» / «The command was refused.» | El dispositivo o el servidor lo rechazaron; el motivo aparece a continuación cuando existe. |
| «Current: 60», «Reported: 60» | Lo que el dispositivo informa ahora, a partir del valor actual vinculado. |
Lea el valor actual desde el dispositivo en lugar de fiarse del control: un interruptor que muestra On tras un cambio muestra el estado notificado por el dispositivo cuando llega. Cada ejecución se registra en el registro de auditoría; el comando también aparece en el History de comandos del dispositivo como enviado por A dashboard control.
Comandos desde tablas y diagramas
- Los Row buttons de una tabla pueden ejecutar un comando que usa una columna de la fila pulsada. Consulte Tablas y listas.
- Los símbolos de un diagrama de proceso pueden ejecutar comandos. Consulte Comandos en símbolos.
- Pulsar una tarjeta nunca ejecuta un comando. Los comandos solo se ejecutan desde controles, botones de fila y símbolos, tras su confirmación.
Resolución de problemas
| Lo que ve | Solución |
|---|---|
| El comando no está en la lista | No está en el catálogo del perfil del dispositivo, o no es de nivel Basic. |
| «This control is not connected to the device yet.» | La ranura del valor actual está vacía. Vincúlela. |
| El control aparece atenuado | La lectura es antigua o el estado es desconocido (Desactiva el control cuando), o no tienes permiso. |
| El dispositivo nunca reacciona | Consulta Los comandos no llegan al dispositivo. |

