SOP Fan-In : MQTT
Les messages MQTT peuvent déclencher des exécutions SOP. L’écouteur MQTT s’abonne au courtier, génère un événement SOP par message et le transmet au moteur. Ce chemin est conditionné par la fonctionnalité de compilation channel-mqtt.
Le côté transport (URL du broker, identifiants, TLS, QoS) est configuré sur le canal MQTT. Cette page couvre le déclencheur.
Déclencheur
Arrivée du message MQTT. En direct : transmis par l’écouteur MQTT.
| champ | type | par défaut | sens |
|---|---|---|---|
condition | string? | null | Expression optionnelle évaluée par rapport à la charge utile du message ; l’exécution |
topic* | chaîne | — | Filtre de topic. + correspond à un niveau, # correspond aux niveaux restants. |
Charger et vérifier le SOP :
Définir
Rédigez la SOP comme décrit dans Syntax, avec un déclencheur mqtt. Les champs de déclencheur ci-dessus sont les clés prises en charge ; la page parcourt le fichier complet.
Valider
zeroclaw sop validate
Inspect
zeroclaw sop list
zeroclaw sop show <name>
Correspondance
Les motifs de topic prennent en charge les jokers + (niveau unique) et # (multi-niveaux). La charge utile MQTT est transmise dans la charge utile de l’événement SOP, disponible pour une condition de déclenchement optionnelle ; le contexte d’étape reçoit la forme plafonnée, assainie et cadrée. Une condition JSON-path telle que $.value > 85 exige que l’éditeur envoie un corps JSON.
Exécutez-le
Avec un SOP chargé et le canal MQTT abonné, publiez un message sur un topic correspondant au motif de déclenchement (par exemple avec mosquitto_pub, ou tout client de broker). L’écouteur construit un événement à partir du topic et du payload et le distribue. Une exécution démarre pour chaque SOP chargé dont le motif topic correspond et dont la condition (le cas échéant) est satisfaite par rapport au payload.
Si rien ne démarre, vérifiez que le topic correspond au motif de déclenchement, que la souscription du courtier est active et que la condition correspond à la charge utile. Consultez le tableau de dépannage de la vue d’ensemble fan-in.
Approuver et observer
Les exécutions qui atteignent un point de contrôle se mettent en pause en tant que WaitingApproval. Effacez-les ou inspectez-les avec le CLI (zeroclaw sop list, zeroclaw sop approve) ou hors bande via les endpoints d’approbation de la gateway API (GET /admin/sop/pending, POST /admin/sop/approve, POST /admin/sop/deny).
Voir aussi
- Canal MQTT : broker, TLS, QoS
- Vue d’ensemble du fan-in
- Syntaxe : le format de fichier SOP