Neu: Die KI-Firewall überwacht die gesamte Plattform und erklärt jeden Vorfall in einfachen Worten. So funktioniert es

Blöcke für Routing und Timing

Referenz zu Switch, Gate, All of, Any of, Not, Split, Join, Sort, Batch, Delay, Debounce, Deduplicate, Rate limit, Only changes, Trigger, Detach und Link call.

Diese Blöcke entscheiden, wohin eine Nachricht geht und wann. Blöcke, die Nachrichten warten lassen oder zurückhalten, speichern sie dauerhaft: Ein Neustart der Plattform verwirft sie nicht. Solange kein Schlüssel gesetzt ist, führen Blöcke, die sich pro Schlüssel etwas merken, einen Speicher pro Gerät (den Urheber der Nachricht). Jeder Block hält höchstens 10.000 Schlüssel und höchstens 16 MiB an Nachrichten.

Switch

Leitet eine Nachricht anhand des Werts einer Eigenschaft weiter. Jede Regel hat ihren eigenen Ausgang.

EinstellungBedeutungStandardWerte
propertyDer Wert, den die Regeln prüfenmsg.payloadein Pfad
rulesJe eine Zeile und ein Ausgang: op, value (und value2 für between), optional Namekeinebis zu 16 Regeln
stop_firstNur an die erste passende Regel sendenanan, aus

Ausgänge: o0 … o15 (einer pro Regel, mit dem Namen der Regel beschriftet, falls gesetzt), else (angezeigt als „otherwise“), error. Die Operatoren sind die von Compare, dazu between (von value bis value2, beide eingeschlossen) und expr (der eigene Ausdruck der Regel ist wahr). Bei ausgeschaltetem stop_first erhält jede passende Regel die Nachricht.

Gate

Lässt Nachrichten durch, solange es offen ist, und hält sie zurück oder verwirft sie, solange es geschlossen ist.

EinstellungBedeutungStandardWerte
initialZustand beim Start des Flowsopenopen, closed
control_topicTopic der Steuernachrichten; leer = keinesgatebis zu 64 Zeichen
conditionOptionaler Ausdruck: nur offen, solange er wahr istleerein Ausdruck
closedEine Nachricht bei geschlossenem Gatedropdrop, queue
max_queueGehaltene Nachrichten bei Warteschlange32bis zu 1.000

Steuernachrichten haben msg.topic gleich dem Control-Topic und msg.payload open (oder true, 1, on), close (oder false, 0, off), toggle oder status; sie werden nicht weitergegeben. Ausgänge: out, dropped (bei geschlossenem Gate verworfen oder aus einer vollen Warteschlange verdrängt), error. Beispielbedingung für Arbeitszeiten: number(fmt_time(now(), "%H")) >= 8 && number(fmt_time(now(), "%H")) < 18.

All of

Wartet, bis Nachrichten mit verschiedenen Schlüsseln (standardmäßig verschiedenen Topics) innerhalb eines Zeitfensters alle eingetroffen sind, und sendet dann eine Nachricht mit allen ihren Payloads.

EinstellungBedeutungStandardWerte
window_msAlle Nachrichten müssen jünger sein als dieser Wert; 0 = keine Begrenzung10 s0 bis 24 h
keyWoher der Schlüssel gelesen wirdmsg.topicein Pfad
min_inputsWie viele verschiedene Schlüssel nötig sind22 bis 16

Ausgang out: die vervollständigende Nachricht mit msg.payload = { key: payload, … }. Nur die vervollständigende Nachricht geht hinaus. Was gesammelt wird, wird standardmäßig pro Gerät gehalten (group_by: originator oder flow).

Any of

Lässt jede Nachricht durch; verwirft optional Wiederholungen eines Schlüssels.

EinstellungBedeutungStandardWerte
dedup_msEine Nachricht verwerfen, deren Schlüssel vor weniger als dieser Zeit durchgelaufen ist; 0 = alle durchlassen00 bis 24 h
keyDer Schlüssel für die Wiederholungsprüfungmsg.topicein Pfad

Not

Ersetzt msg.payload durch das logische Gegenteil, true oder false. false, null, 0, "" und Not-a-Number werden zu true; alles andere (auch "0", "false", [], {}) wird zu false. Keine Einstellungen.

Split

Eine Nachricht pro Teil von msg.payload: pro Array-Element, pro Objektschlüssel, pro Textzeile oder pro Block fester Größe.

EinstellungBedeutungStandardWerte
modeauto (Element, Schlüssel oder Trennzeichen) oder length (Blöcke)autoauto, length
delimiterWo Text getrennt wird; \n Zeilenumbruch, \t Tabulator\nbis zu 16 Zeichen
lengthBlockgröße in Elementen oder Zeichen11 bis 65.536

Jeder Teil trägt msg.parts (id, index, count, type, key …) für Join. Fehler queue_full ab mehr als 10.000 Teilen.

Join

Sammelt Nachrichten zu einer.

EinstellungBedeutungStandardWerte
modeauto baut wieder zusammen, was Split getrennt hat; manual baut aus beliebigen Nachrichtenautoauto, manual
buildWas gebaut werden soll (manual)arrayarray, object, string
joinerZwischen Textstücken\nbis zu 16 Zeichen
keyObjektschlüssel jeder Nachrichtmsg.topicein Pfad
countNach dieser Anzahl Nachrichten senden; 0 = keine Anzahl00 bis 10.000
timeout_msSendet, was so lange nach der ersten Nachricht eingetroffen ist; 0 = warten00 bis 24 h

msg.complete (beliebiger Wert) sendet eine manuelle Gruppe sofort. Setzen Sie im manuellen Modus count, timeout_ms oder msg.complete, sonst geht die Gruppe erst bei der Obergrenze von 10.000 Nachrichten hinaus.

Sort

Sortiert eine Liste (Modus array: property, optional Feld) oder die Nachrichten einer von Split oder Batch erzeugten Gruppe (Modus messages: key, timeout_ms). Einstellungen: order asc/desc, numeric an/aus (ohne sortiert "10" vor "9"). Fehler queue_full bei mehr als 10.000 Elementen.

Batch

Sendet Nachrichten gruppenweise weiter.

EinstellungBedeutungStandardWerte
modeNach Anzahl oder nach Zeitcountcount, interval
countNachrichten in einer Gruppe101 bis 10.000
overlapNachrichten der zuletzt gesendeten Gruppe, die mit der nächsten erneut gesendet werden00 bis count − 1
interval_msZeit von der ersten wartenden Nachricht, bis die Gruppe hinausgeht1 s1 ms bis 24 h

Jede Nachricht einer Gruppe erhält msg.parts; ein Join im Modus auto macht daraus dann eine Liste.

Delay

Hält jede Nachricht zurück und sendet sie dann unverändert weiter.

EinstellungBedeutungStandardWerte
msWartezeit1 s0 bis 7 Tage
ms2Obere Grenze einer zufälligen Wartezeitleer0 bis 7 Tage
from_msgWartezeit aus msg.delay übernehmenausan, aus
max_pendingGleichzeitig wartende Nachrichten1,0001 bis 100.000
on_newqueue: jede wartet ihre eigene Zeit; restart: eine neue Nachricht verwirft die wartenden ihres Schlüsselsqueuequeue, restart
keySchlüssel für restartmsg.originatorein Pfad

msg.reset = true verwirft jede wartende Nachricht. Fehler queue_full, wenn max_pending erreicht ist.

Debounce

Eine Nachricht pro Burst.

EinstellungBedeutungStandardWerte
msRuhezeit, die einen Burst beendet500 ms0 bis 24 h
edgetrailing: die letzte Nachricht nach der Ruhezeit; leading: die erste soforttrailingtrailing, leading
keyJeder Schlüssel wird für sich entprelltmsg.originatorein Pfad

Deduplicate

Eine Nachricht pro Zeitraum und Schlüssel, egal wie viele eintreffen.

EinstellungBedeutungStandardWerte
strategyfirst, last oder all (eine Nachricht, deren Payload jedes { payload, metadata } auflistet)firstfirst, last, all
window_ms (Zeitraum)Beginnt mit der ersten Nachricht eines Schlüssels60 s1 s bis 24 h
keyEin Paket pro Wertmsg.originatorein Pfad
timemessage (die eigene Zeit des Messwerts, aus ts_path oder der Aufzeichnungszeit) oder arrivalmessagemessage, arrival
ts_pathWo die Zeit des Messwerts steht (time = message)die Aufzeichnungszeitein Pfad
max_pendingPro Schlüssel gehaltene Nachrichten für all1001 bis 1.000
msg_typeNachrichtentyp des all-Ergebnissesder Typ der ersten Nachrichtbis zu 64 Zeichen

Das Ergebnis trägt msg.metadata.dedup mit count, start und end. Mit Time message liefert ein nachgeliefertes Backlog ein Ergebnis pro Zeitraum der Gerätezeit.

Rate limit

Höchstens n Nachrichten pro Zeitraum und Schlüssel.

EinstellungBedeutungStandardWerte
nNachrichten pro Zeitraum11 bis 10.000
per_msDer gleitende Zeitraum1 s1 ms bis 24 h
modeÜber dem Limit: drop, latest (nur die neueste behalten), queuedropdrop, latest, queue
max_queueWartende Nachrichten pro Schlüssel321 bis 1.000
keyJeder Schlüssel hat sein eigenes Limitmsg.originatorein Pfad

Ausgänge: out, dropped. Setzen Sie ihn vor eine SMS, eine E-Mail oder einen externen Aufruf.

Only changes

Lässt eine Nachricht nur durch, wenn sich ihr Wert gegenüber der zuletzt durchgelassenen geändert hat.

EinstellungBedeutungStandardWerte
propertyDer Wertmsg.payloadein Pfad
modechange, deadband (um mindestens den Wert), deadband_pct (um mindestens den Wert in % des letzten Werts)change
WertDas Totband00 oder mehr
SchlüsselJeder Schlüssel hat seinen eigenen letzten Wertmsg.originatorein Pfad
firstDen ersten Wert eines Schlüssels durchlassenonon, off

Der neue Wert wird mit dem letzten Wert verglichen, der durchgelassen wurde. So wird langsames Driften gemeldet, sobald es sich aufsummiert.

Trigger

Sendet eine erste Nachricht, wartet und sendet dann eine zweite.

EinstellungBedeutungStandardWerte
firstSofort gesendet: die Nachricht selbst, nichts oder ein Wert für msg.payloaddie Nachricht
thenNach der Wartezeit gesendet: nichts, die Nachricht oder ein Wertnichts
msWartezeit1 s0 bis 7 Tage
extendEine neue Nachricht während der Wartezeit startet die Wartezeit neuoffon, off
SchlüsselJeder Schlüssel hat seine eigene Wartezeitmsg.originatorein Pfad

msg.reset = true bricht die Wartezeit dieses Schlüssels ab.

Detach

Der Rest des Zweigs läuft getrennt, sodass die nächste Nachricht des Geräts nicht darauf wartet. Verwenden Sie ihn vor einem langsamen Zweig. Danach ist die Reihenfolge der Nachrichten nicht garantiert. Keine Einstellungen.

Sendet die Nachricht an einen Link in (oder mit flow:<slug> an den Flow input eines anderen Flows) und wartet auf die Antwort eines Link out im Modus return.

EinstellungBedeutungStandardWerte
targetDer Name des Link inerforderlich
timeout_msAuf die Antwort warten30 s1 ms bis 1 h
returnsBenannte Returns des Ziels; jeder wird zu einem Ausgangkeine

Ausgänge: out (die Antwort), einer je benanntem Return, timeout (keine Antwort rechtzeitig; die ursprüngliche Nachricht), error (invalid_value kein solcher Link, queue_full, unknown_return, loop). Aufrufe verschachteln sich höchstens 16 Ebenen tief; ein Aufruf in den eigenen Aufrufstapel schlägt mit loop fehl.