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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| property | Der Wert, den die Regeln prüfen | msg.payload | ein Pfad |
| rules | Je eine Zeile und ein Ausgang: op, value (und value2 für between), optional Name | keine | bis zu 16 Regeln |
| stop_first | Nur an die erste passende Regel senden | an | an, 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| initial | Zustand beim Start des Flows | open | open, closed |
| control_topic | Topic der Steuernachrichten; leer = keines | gate | bis zu 64 Zeichen |
| condition | Optionaler Ausdruck: nur offen, solange er wahr ist | leer | ein Ausdruck |
| closed | Eine Nachricht bei geschlossenem Gate | drop | drop, queue |
| max_queue | Gehaltene Nachrichten bei Warteschlange | 32 | bis 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| window_ms | Alle Nachrichten müssen jünger sein als dieser Wert; 0 = keine Begrenzung | 10 s | 0 bis 24 h |
| key | Woher der Schlüssel gelesen wird | msg.topic | ein Pfad |
| min_inputs | Wie viele verschiedene Schlüssel nötig sind | 2 | 2 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| dedup_ms | Eine Nachricht verwerfen, deren Schlüssel vor weniger als dieser Zeit durchgelaufen ist; 0 = alle durchlassen | 0 | 0 bis 24 h |
| key | Der Schlüssel für die Wiederholungsprüfung | msg.topic | ein 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| mode | auto (Element, Schlüssel oder Trennzeichen) oder length (Blöcke) | auto | auto, length |
| delimiter | Wo Text getrennt wird; \n Zeilenumbruch, \t Tabulator | \n | bis zu 16 Zeichen |
| length | Blockgröße in Elementen oder Zeichen | 1 | 1 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| mode | auto baut wieder zusammen, was Split getrennt hat; manual baut aus beliebigen Nachrichten | auto | auto, manual |
| build | Was gebaut werden soll (manual) | array | array, object, string |
| joiner | Zwischen Textstücken | \n | bis zu 16 Zeichen |
| key | Objektschlüssel jeder Nachricht | msg.topic | ein Pfad |
| count | Nach dieser Anzahl Nachrichten senden; 0 = keine Anzahl | 0 | 0 bis 10.000 |
| timeout_ms | Sendet, was so lange nach der ersten Nachricht eingetroffen ist; 0 = warten | 0 | 0 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| mode | Nach Anzahl oder nach Zeit | count | count, interval |
| count | Nachrichten in einer Gruppe | 10 | 1 bis 10.000 |
| overlap | Nachrichten der zuletzt gesendeten Gruppe, die mit der nächsten erneut gesendet werden | 0 | 0 bis count − 1 |
| interval_ms | Zeit von der ersten wartenden Nachricht, bis die Gruppe hinausgeht | 1 s | 1 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| ms | Wartezeit | 1 s | 0 bis 7 Tage |
| ms2 | Obere Grenze einer zufälligen Wartezeit | leer | 0 bis 7 Tage |
| from_msg | Wartezeit aus msg.delay übernehmen | aus | an, aus |
| max_pending | Gleichzeitig wartende Nachrichten | 1,000 | 1 bis 100.000 |
| on_new | queue: jede wartet ihre eigene Zeit; restart: eine neue Nachricht verwirft die wartenden ihres Schlüssels | queue | queue, restart |
| key | Schlüssel für restart | msg.originator | ein Pfad |
msg.reset = true verwirft jede wartende Nachricht. Fehler queue_full, wenn max_pending erreicht ist.
Debounce
Eine Nachricht pro Burst.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| ms | Ruhezeit, die einen Burst beendet | 500 ms | 0 bis 24 h |
| edge | trailing: die letzte Nachricht nach der Ruhezeit; leading: die erste sofort | trailing | trailing, leading |
| key | Jeder Schlüssel wird für sich entprellt | msg.originator | ein Pfad |
Deduplicate
Eine Nachricht pro Zeitraum und Schlüssel, egal wie viele eintreffen.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| strategy | first, last oder all (eine Nachricht, deren Payload jedes { payload, metadata } auflistet) | first | first, last, all |
| window_ms (Zeitraum) | Beginnt mit der ersten Nachricht eines Schlüssels | 60 s | 1 s bis 24 h |
| key | Ein Paket pro Wert | msg.originator | ein Pfad |
| time | message (die eigene Zeit des Messwerts, aus ts_path oder der Aufzeichnungszeit) oder arrival | message | message, arrival |
| ts_path | Wo die Zeit des Messwerts steht (time = message) | die Aufzeichnungszeit | ein Pfad |
| max_pending | Pro Schlüssel gehaltene Nachrichten für all | 100 | 1 bis 1.000 |
| msg_type | Nachrichtentyp des all-Ergebnisses | der Typ der ersten Nachricht | bis 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| n | Nachrichten pro Zeitraum | 1 | 1 bis 10.000 |
| per_ms | Der gleitende Zeitraum | 1 s | 1 ms bis 24 h |
| mode | Über dem Limit: drop, latest (nur die neueste behalten), queue | drop | drop, latest, queue |
| max_queue | Wartende Nachrichten pro Schlüssel | 32 | 1 bis 1.000 |
| key | Jeder Schlüssel hat sein eigenes Limit | msg.originator | ein 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| property | Der Wert | msg.payload | ein Pfad |
| mode | change, deadband (um mindestens den Wert), deadband_pct (um mindestens den Wert in % des letzten Werts) | change | |
| Wert | Das Totband | 0 | 0 oder mehr |
| Schlüssel | Jeder Schlüssel hat seinen eigenen letzten Wert | msg.originator | ein Pfad |
| first | Den ersten Wert eines Schlüssels durchlassen | on | on, 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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| first | Sofort gesendet: die Nachricht selbst, nichts oder ein Wert für msg.payload | die Nachricht | |
| then | Nach der Wartezeit gesendet: nichts, die Nachricht oder ein Wert | nichts | |
| ms | Wartezeit | 1 s | 0 bis 7 Tage |
| extend | Eine neue Nachricht während der Wartezeit startet die Wartezeit neu | off | on, off |
| Schlüssel | Jeder Schlüssel hat seine eigene Wartezeit | msg.originator | ein 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.
Link call
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.
| Einstellung | Bedeutung | Standard | Werte |
|---|---|---|---|
| target | Der Name des Link in | erforderlich | |
| timeout_ms | Auf die Antwort warten | 30 s | 1 ms bis 1 h |
| returns | Benannte Returns des Ziels; jeder wird zu einem Ausgang | keine |
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.

