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

Datentransformationsblöcke

Referenz zu Change, Calculate, Scale, Template, JSON, CSV, XML, Hex, Base64 und Bytes – den Blöcken, die Nachrichtendaten umformen, berechnen und dekodieren.

Transformationsblöcke verändern die Nachricht und geben sie weiter. Mit ihnen benennen Sie Schlüssel um, berechnen Werte, erstellen Texte und dekodieren Rohdaten von Geräten, bevor Telemetrie speichern. Jeder hat einen out-Ausgang und einen error-Ausgang. Keiner von ihnen speichert einen Zustand.

Ändern

Setzt, bearbeitet, löscht oder verschiebt Eigenschaften der Nachricht sowie von Flow- oder globalen Variablen, in Schritten von oben nach unten.

EinstellungBedeutungWerte
opsDie Schrittebis zu 16 Zeilen

Jeder Schritt:

opWirkungFelder
setSchreibt einen Wert; fehlende übergeordnete Elemente werden angelegtpath, value (Wert beliebiger Art)
changeErsetzt jedes Vorkommen von from im Text durch to; Nicht-Text bleibt unverändertpath, from, to, regex (ein Muster mit höchstens 64 Zeichen)
deleteEntfernt die Eigenschaft oder Variablepath
moveKopiert in den Pfad in to und löscht danach das Original.path, to
copy keysKopiert jeden Schlüssel auf oberster Ebene des Objekts unter path, dessen vollständiger Name mit Keys matching übereinstimmt, in To objectpath, Keys matching, To object
delete keysLöscht jeden Schlüssel auf oberster Ebene, dessen vollständiger Name übereinstimmtpath, Keys matching

Pfade sind msg.-, flow.– oder global.-Pfade (flow.persist:x für den persistenten Speicher). Engine-Felder (_…), msg.msgType und msg.originator können nicht geschrieben werden. Fehler: invalid_value mit invalid_path, read_only, invalid_key, limit (Variablenspeicher voll) oder bad pattern; Schritte vor dem fehlerhaften sind bereits angewendet.

Beispiel: Schlüssel eines Geräts vor dem Speichern umbenennen: Schritt 1 set von msg.payload.temperature auf den Pfad msg.payload.tmp; Schritt 2 delete msg.payload.tmp.

Berechnen

Berechnet einen Ausdruck und schreibt das Ergebnis.

EinstellungBedeutungStandardWerte
exprDer Ausdruckerforderlichbis zu 512 Zeichen
targetWohin das Ergebnis geschrieben wirdmsg.payloadein Pfad msg., flow. oder global.

7 / 2 ergibt 3.5; + verbindet Text, sobald eine Seite Text ist; Arithmetik mit null oder jedem Text (auch "21.5") schlägt mit type fehl: mit number() umwandeln. Fehler: invalid_value, type, div_zero, steps, limit. Die Funktionen finden Sie unter Bedingungsblöcke.

Beispiele: round(msg.payload.temperature * 1.8 + 32, 1); 10 * log10(msg.payload.ratio); clamp(msg.payload.level, 0, 100).

Skalieren

Bildet eine Zahl linear von einem Bereich auf einen anderen ab, direkt an Ort und Stelle.

EinstellungBedeutungStandardWerte
propertyDie Zahlmsg.payloadein Pfad
in_min, in_maxDer Eingangsbereich0, 4095Zahlen, nicht gleich
out_min, out_maxDer Ausgangsbereich0, 100Zahlen
modeAußerhalb des Ausgangsbereichsclampclamp (begrenzen), wrap (umlaufen), free (unverändert lassen)
roundNachkommastellenkeine0 bis 10

Formel: out_min + (value − in_min) × (out_max − out_min) / (in_max − in_min). Numerischer Text sowie true/false (1/0) zählen als Zahlen. Fehler invalid_value („not a number“ oder leerer Eingangsbereich).

Vorlage

Erstellt Text oder einen JSON-Wert aus {{ expression }}-Platzhaltern.

EinstellungBedeutungStandardWerte
templateDer Text{{ msg.payload }}bis zu 4.096 Zeichen
targetWohin das Ergebnis geschrieben wirdmsg.payloadein Pfad msg., flow. oder global.
formattext oder json (das Ergebnis wird als JSON geparst)texttext, json

null wird zu leer, Objekte und Arrays werden als JSON geschrieben. Bei JSON-Ausgabe setzen Sie Text-Platzhalter selbst in Anführungszeichen: {"temp": {{ msg.payload }}, "unit": "{{ flow.unit }}"}. Das Ergebnis ist höchstens 64 KB Text groß.

JSON

Wandelt JSON-Text in einen Wert oder einen Wert in JSON-Text um, direkt an Ort und Stelle.

EinstellungBedeutungStandardWerte
modeauto (Text parsen, Rest unverändert lassen), parse, stringifyauto
propertyDie Eigenschaftmsg.payloadein Pfad

Fehler: invalid_value „not JSON: …“ oder „not a string“.

CSV

CSV-Text in Datensätze oder Datensätze in CSV-Text umwandeln, direkt an Ort und Stelle.

EinstellungBedeutungStandardWerte
modeauto, decode, encodeauto
propertyDie Eigenschaftmsg.payloadein Pfad
sepFeldtrennzeichenKommacomma, semicolon, tab, pipe
headerDecodieren: Die erste Zeile enthält die Namen. Encodieren: eine Kopfzeile schreibenausein, aus
columnsSpaltennamen, durch Komma getrenntleerbis zu 256 Zeichen
ZahlenDecodieren: zahlenähnliche Felder werden zu Zahlenausein, aus
outputDecodieren: eine Nachricht mit allen Datensätzen (array) oder eine pro Datensatz (rows)arrayarray, rows

Die Anführungszeichen folgen RFC 4180. Fehler queue_full bei mehr als 10.000 Zeilen oder Datensätzen.

XML

XML-Text in ein Objekt oder ein Objekt in XML-Text umwandeln.

EinstellungBedeutungStandard
Modusparse, build oder auto
EigenschaftWo die Umwandlung stattfindetmsg.payload
AttributpräfixPräfix der Attributschlüssel@
TextschlüsselSchlüssel für Text neben untergeordneten Elementen#text
Arrays / Array-ElementeWelche Elemente immer Arrays sind
ZahlenNumerischer Text wird zu Zahlenaus
AuswahlNur einen Elementpfad behalten, z. B. soap:Envelope/soap:Body/*/m:Price
Root, DeclarationBeim Erzeugen: der Name des Wurzelelements, die Zeile <?xml …?>
Max. BytesGrößte Eingabe64 KiB (1 bis 256 KiB)

Ein Dokument mit <!DOCTYPE wird abgelehnt. Höchstens 10.000 Elemente, 64 Attribute je Element, 128 Zeichen je Name. Fehler: parse_error, dtd_refused, too_large, too_deep, bad_name, no_root.

Hex und Base64

Kodiert eine Eigenschaft als Hex (zwei Kleinbuchstaben-Ziffern pro Byte) oder Base64-Text, oder dekodiert sie zurück.

EinstellungBedeutungStandardWerte
modeRichtungautoauto, encode, decode
propertyDie Eigenschaftmsg.payloadein Pfad msg., flow. oder global.

Bei auto wird Text, der wie Hex (oder Base64) aussieht, dekodiert und alles andere kodiert; kurze Wörter wie test oder Ziffern wie 2024 sind ebenfalls gültiges Base64 oder Hex, daher wählen Sie encode oder decode, wenn Sie die Richtung kennen. Hex-Dekodierung ignoriert Leerzeichen und Doppelpunkte.

Bytes

Liest benannte Zahlen aus Binärdaten oder erzeugt Binärdaten aus Zahlen.

EinstellungBedeutungStandardWerte
modeLesen oder erzeugendecodedecode, encode
fieldsEine Zeile pro Feldleerbis zu 16 Zeilen

Jedes Feld:

FeldBedeutungStandardWerte
nameSchlüssel im Ergebniserforderlichein Buchstabe oder _ am Anfang, bis zu 32 Zeichen
offsetErstes Byte, ab 000 bis 4.095
typeGröße und Artu16u8, i8, u16, i16, u32, i32, f32
leLittle Endianaus (Big Endian)ein, aus
bitsEin Bitbereich start:lengthganzes Feldz. B. 0:1, 4:3
scaleDecodieren: × Skalierung; encodieren: ÷ Skalierung1eine Zahl

Decodieren liest Hex-Text (Leerzeichen und Doppelpunkte ignoriert) oder ein Array von Bytewerten in msg.payload und schreibt { name: value }. Encodieren schreibt Hex-Text. Fehler invalid_value, wenn die Daten kein Hex sind oder ein Feld über das Ende hinausragt.

Beispiel: eine Rohnutzlast 00d7ff9c mit temp (offset 0, i16, scale 0.1) und pressure (offset 2, i16) ergibt { "temp": 21.5, "pressure": -100 }.

Dekodieren von Rohdaten von Geräten

Ein Gerät, das Binärdaten sendet, kommt mit dem einzelnen Schlüssel raw an (Base64 für Binärdaten). Ein typischer Decoder im Root-Flow, vor Telemetrie speichern:

Switch (msg.payload.raw nempty) → Change: set msg.payload to the path msg.payload.raw
  → Base64 (decode) → Hex (encode) → Bytes (decode fields) → Save telemetry

Prüfen Sie das Ergebnis mit Test, bevor Sie es bereitstellen. Verwenden Sie für LoRaWAN-Geräte stattdessen Codecs; siehe Codecs overview. Für alles, was sich mit den Blöcken nicht ausdrücken lässt, verwenden Sie The script block.