Novedad: el cortafuegos de IA supervisa toda la plataforma y explica cada incidente con palabras sencillas. Vea cómo funciona

Tarjeta de reglas: acciones («Then»)

Todas las acciones de la tarjeta de reglas: comandos, ajustes, avisar a personas, alarmas, esperas, wait until, opciones y otras reglas, además de las opciones de ejecución.

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.

TipoHace
Enviar un comandoEnvía un comando del catálogo del perfil del dispositivo.
Cambiar un ajusteEscribe un ajuste en el dispositivo.
Avisar a las personasEnvía una notificación.
Activar o borrar una alarmaAbre o borra una alarma con el ciclo de vida habitual.
EsperarHace una pausa antes del siguiente paso.
Esperar hasta que se cumpla una condiciónHace una pausa hasta que se cumpla una condición, con un límite de tiempo.
Elegir según una condiciónEjecuta distintos pasos según las condiciones.
Cambiar o iniciar otra reglaActiva 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

CampoSignificado
QuiénMarca Owners, Admins y/o Members (los roles de tu organización).
MensajeEl 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

CampoSignificado
Activar / BorrarAbre o actualiza una alarma, o la borra.
DispositivoUn dispositivo, todos los dispositivos de un perfil o (en la tarjeta de un dispositivo) on this place.
Tipo de alarmaEl tipo, por ejemplo pump_dry_run.
SeveridadPara 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ónHace
Activar / DesactivarActiva 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ónOpciones
Si se dispara mientras todavía se está ejecutandoIgnore 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áximoPara «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" }