El bloque Then enumera lo que hace una regla, «In this order». Una regla tiene de 1 a 20 acciones, contando las acciones dentro de las opciones. Haz clic en Add an action, elige el tipo y usa Move up / Move down para ordenarlas.
| Tipo | Hace |
|---|---|
| Enviar un comando | Envía un comando del catálogo del perfil del dispositivo. |
| Cambiar un ajuste | Escribe un ajuste en el dispositivo. |
| Avisar a las personas | Envía una notificación. |
| Activar o borrar una alarma | Abre o borra una alarma con el ciclo de vida habitual. |
| Esperar | Hace una pausa antes del siguiente paso. |
| Esperar hasta que se cumpla una condición | Hace una pausa hasta que se cumpla una condición, con un límite de tiempo. |
| Elegir según una condición | Ejecuta distintos pasos según las condiciones. |
| Cambiar o iniciar otra regla | Activa o desactiva otra regla del lugar, o la inicia. |
Enviar un comando
Elige el Device (un dispositivo o todos los dispositivos de un perfil) y un Command del catálogo del perfil, y después sus parámetros. Al guardar se comprueba que el comando existe para cada dispositivo al que llega y que sus valores encajan («This device type has no such command.», «The command’s values do not fit it.»). El guardado se rechaza si no puedes enviar ese comando tú mismo (los comandos tienen niveles con sus propios permisos).
El comando se envía como cualquier otro comando, con su tiempo de espera e historial en los comandos del dispositivo. Un dispositivo en Manual se omite: «skipped: device is in Manual». Consulta Sending commands to devices.
Cambiar un ajuste
Elige el Device, escribe el Setting (una clave, de hasta 128 caracteres) y el valor después de to. Un valor que parece un número se envía como número; cualquier otro, como texto.
El ajuste se escribe como un shared attribute de cada dispositivo, de modo que el dispositivo lo recibe como cualquier shared attribute al que esté suscrito. Un dispositivo en Manual se omite. Consulta Attributes.
Avisar a las personas
| Campo | Significado |
|---|---|
| Quién | Marca Owners, Admins y/o Members (los roles de tu organización). |
| Mensaje | El texto, de hasta 1,000 caracteres. |
El título de la notificación es el nombre de la regla. Llega a cada persona por los canales que haya permitido. La tarjeta ofrece roles; la API de reglas también acepta usuarios individuales y equipos, de hasta 20 destinatarios. Un rol con más de 20 miembros activos se rechaza en lugar de avisar a medias. Los avisos repetidos del mismo aviso a la misma persona se retienen durante un enfriamiento de 10 minutos, salvo que tu plan indique otro. Detalles: Notifications from rules and flows.
Activar o borrar una alarma
| Campo | Significado |
|---|---|
| Activar / Borrar | Abre o actualiza una alarma, o la borra. |
| Dispositivo | Un dispositivo, todos los dispositivos de un perfil o (en la tarjeta de un dispositivo) on this place. |
| Tipo de alarma | El tipo, por ejemplo pump_dry_run. |
| Severidad | Para Raise: Critical, Major, Minor, Warning o Info (por defecto Warning). |
Estas alarmas se comportan como las alarmas de reglas: una alarma activa por dispositivo y tipo, las mismas notificaciones, limitación y protección frente a tormentas. Una alarma abierta permanece abierta hasta que una acción Clear, un flujo o una persona la borre; no tiene condición propia.
Esperar
Wait for un número de seconds o minutes, de 1 segundo a 24 horas. Tras la espera, la regla comprueba que el lugar sigue en Auto («Still in Auto?»); si el lugar pasó a Manual entretanto, la ejecución se detiene ahí.
Esperar hasta que se cumpla una condición
Una condición (de cualquier tipo de Conditions), for at most un tiempo (de 1 segundo a 24 horas, por defecto 10 minutos) y qué hacer al agotarse el tiempo: then go on o then stop.
La condición se vuelve a comprobar cada 5 segundos frente a los valores almacenados. Cuando se cumple, la ejecución continúa de inmediato. A diferencia de «se mantiene así durante», una ejecución en espera no sobrevive a un reinicio de la plataforma.
Elegir según una condición
Hasta 5 ramas, cada una con If una condición then algunas acciones, y un Otherwise opcional. Se ejecuta la primera rama cuya condición se cumple; si ninguna se cumple, se ejecuta Otherwise. Las opciones pueden contener opciones, hasta 2 niveles de profundidad. Las acciones dentro cuentan para el límite de 20.
Activar o desactivar otra regla, o iniciarla
Elige una Rule del mismo lugar y:
| Opción | Hace |
|---|---|
| Activar / Desactivar | Activa o desactiva esa regla, como lo haría su interruptor. |
| Iniciarla (debe ser el último paso) | Pasa la ejecución a esa regla. Debe ser el último paso de la regla, o de las ramas de su última opción: «Starting another rule hands the run over to it, so it has to be the last step.» |
Una regla no puede activarse, desactivarse ni iniciarse a sí misma. Se aplican las opciones Manual y de solapamiento de la regla iniciada.
Varios dispositivos
Una acción sobre Every profile se ejecuta una vez por cada dispositivo de ese perfil en el lugar, hasta 200 dispositivos; los dispositivos que excedan ese número no se ejecutan, y el registro de ejecución lo indica. Los dispositivos en Manual se excluyen de comandos y ajustes.
Opciones
| Opción | Opciones |
|---|---|
| Si se dispara mientras todavía se está ejecutando | Ignore the new one (por defecto), Wait for the one running, then run, Run them side by side, Start over: stop the one running at its next wait |
| Como máximo | Para «wait» y «side by side»: de 1 a 10 ejecuciones en espera o al mismo tiempo. |
| También se ejecuta en modo Manual | «Solo para una regla que solo avisa a personas o levanta alarmas.» |
Notas:
- Wait for the one running mantiene en memoria las ejecuciones en espera; un reinicio de la plataforma las descarta.
- Start over no puede cancelar un paso en curso: las ejecuciones anteriores se detienen en su siguiente espera, con «stopped: a newer run of this rule started». Lo que ya enviaron permanece enviado.
- Also runs in Manual se rechaza para una regla que envía comandos, cambia ajustes o activa reglas: «Only a rule that just notifies or raises alarms may run in Manual».
Fallos
Si un comando, ajuste o alarma falla para un dispositivo (un comando rechazado, un límite de dispositivo alcanzado), la ejecución registra el paso fallido de ese dispositivo en History y continúa: los demás dispositivos siguen recibiendo la acción y las siguientes acciones se ejecutan. Un fallo de cualquier otro paso (una notificación, una condición que no se puede leer) termina la ejecución ahí, y History indica el paso que no se completó.
En JSON
"then": [
{ "id": "a1", "kind": "command", "target": { "deviceType": "<profileId>" }, "command": "fan.set", "params": { "on": true } },
{ "id": "a2", "kind": "setting", "target": { "device": "<id>" }, "key": "setpoint", "value": 21 },
{ "id": "a3", "kind": "notify", "recipients": [ { "kind": "role", "role": "ADMIN" } ], "text": "Fans switched on" },
{ "id": "a4", "kind": "alarm", "op": "raise", "target": { "device": "<id>" }, "alarmType": "fan_forced", "severity": "warning" },
{ "id": "a5", "kind": "wait", "sec": 600 },
{ "id": "a6", "kind": "wait_until", "condition": { "kind": "value", "target": { "device": "<id>" }, "key": "door_open", "op": "==", "value": false }, "timeoutSec": 900, "onTimeout": "stop" },
{ "id": "a7", "kind": "choose", "branches": [ { "if": { "kind": "sun", "is": "night" }, "then": [ { "id": "a8", "kind": "rule", "op": "enable", "rule": "<ruleId>" } ] } ] }
],
"options": { "overlap": "ignore" }

