Dönüştürme blokları mesajı değiştirir ve ileri gönderir. Save telemetry öncesinde anahtarları yeniden adlandırmak, değer hesaplamak, metin oluşturmak ve ham cihaz verisini çözmek için bunları kullanırsınız. Her birinin bir out çıkışı ve bir error çıkışı vardır. Hiçbiri durum (state) tutmaz.
Change
Mesajın ve flow veya global değişkenlerin özelliklerini adım adım, yukarıdan aşağıya ayarlar, düzenler, siler veya taşır.
| Ayar | Anlamı | Değerler |
|---|---|---|
| ops | Adımlar | en fazla 16 satır |
Her adım:
| op | Yaptığı iş | Alanlar |
|---|---|---|
set | Bir değer yazar; eksik üst öğeler oluşturulur | path, value (her türde değer) |
change | Metindeki her from geçişini to ile değiştirir; metin olmayanlara dokunulmaz | path, from, to, regex (en fazla 64 karakterlik bir desen) |
delete | Özelliği veya değişkeni kaldırır | path |
move | to içindeki yola kopyalar, sonra özgün öğeyi siler. | path, to |
copy keys | path konumundaki nesnenin, tam adı Keys matching ile eşleşen her üst düzey anahtarını To object içine kopyalar | path, Keys matching, To object |
delete keys | Tam adı eşleşen her üst düzey anahtarı siler | path, Keys matching |
Yollar msg., flow. veya global. yollarıdır (kalıcı depo için flow.persist:x). Motor alanları (_…), msg.msgType ve msg.originator yazılamaz. Hatalar: invalid_value ile invalid_path, read_only, invalid_key, limit (değişken deposu dolu) veya bad pattern; hata veren adımdan önceki adımlar zaten uygulanmıştır.
Örnek: kaydetmeden önce bir cihazın anahtarını yeniden adlandırma: 1. adım msg.payload.temperature üzerinde set, yol msg.payload.tmp; 2. adım msg.payload.tmp üzerinde delete.
Calculate
Bir ifadeyi hesaplar ve sonucu yazar.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| expr | İfade | zorunlu | en fazla 512 karakter |
| target | Sonucun yazılacağı yer | msg.payload | bir msg., flow. veya global. yolu |
7 / 2 sonucu 3.5tir; iki taraftan biri metin olduğunda + metinleri birleştirir; null veya herhangi bir metin üzerinde aritmetik ("21.5" dahil) type hatasıyla başarısız olur: number() ile dönüştürün. Hatalar: invalid_value, type, div_zero, steps, limit. Fonksiyonlar için bkz. Condition blocks.
Örnekler: round(msg.payload.temperature * 1.8 + 32, 1); 10 * log10(msg.payload.ratio); clamp(msg.payload.level, 0, 100).
Scale
Bir sayıyı doğrusal olarak bir aralıktan diğerine, yerinde eşler.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| property | Sayı | msg.payload | bir yol |
| in_min, in_max | Giriş aralığı | 0, 4095 | sayılar, eşit olmayan |
| out_min, out_max | Çıkış aralığı | 0, 100 | sayılar |
| mode | Çıkış aralığının dışında | clamp | clamp (sınırla), wrap (sarmala), free (serbest bırak) |
| round | Ondalik basamak sayısı | yok | 0 ile 10 arası |
Formül: out_min + (value − in_min) × (out_max − out_min) / (in_max − in_min). Sayısal metinler ve true/false (1/0) sayı sayılır. Hata invalid_value (“not a number” veya boş giriş aralığı).
Template
{{ expression }} yer tutucularından metin veya bir JSON değeri oluşturur.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| template | Metin | {{ msg.payload }} | en fazla 4.096 karakter |
| target | Sonucun yazılacağı yer | msg.payload | bir msg., flow. veya global. yolu |
| format | text, veya json (sonuç JSON olarak ayrıştırılır) | text | text, json |
null boş olur, nesneler ve diziler JSON olarak yazılır. JSON çıktısı için metin yer tutucularını tırnak içine kendiniz koyun: {"temp": {{ msg.payload }}, "unit": "{{ flow.unit }}"}. Sonuç en fazla 64 KB metindir.
JSON
JSON metnini bir değere veya bir değeri JSON metnine, yerinde çevirir.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| mode | auto (metni ayrıştır, gerisini geçir), parse, stringify | auto | |
| property | Özellik | msg.payload | bir yol |
Hatalar: invalid_value “not JSON: …” veya “not a string”.
CSV
CSV metnini kayıtlara veya kayıtları CSV metnine, yerinde çevirir.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| mode | auto, decode, encode | auto | |
| property | Özellik | msg.payload | bir yol |
| sep | Alan ayırıcı | virgül | comma, semicolon, tab, pipe |
| header | Decode: ilk satır adları içerir. Encode: bir başlık satırı yazar | off | on, off |
| columns | Sütun adları, virgülle ayrılmış | boş | en fazla 256 karakter |
| numbers | Decode: sayıya benzeyen alanlar sayı olur | off | on, off |
| output | Decode: tüm kayıtlarla tek mesaj (array) veya kayıt başına bir mesaj (rows) | array | array, rows |
Tırnaklama RFC 4180’i izler. 10.000 satırın veya kaydın üzerinde queue_full hatası.
XML
XML metnini bir nesneye veya bir nesneyi XML metnine çevirir.
| Ayar | Anlamı | Varsayılan |
|---|---|---|
| Mode | parse, build veya auto | |
| Property | Dönüşümün yapıldığı yer | msg.payload |
| Öznitelik öneki | Öznitelik anahtarlarının öneki | @ |
| Metin anahtarı | Alt öğelerin yanındaki metnin anahtarı | #text |
| Diziler / dizi öğeleri | Hangi öğelerin her zaman dizi olduğu | |
| Sayılar | Sayısal metin sayıya dönüşür | off |
| Select | Yalnızca bir öğe yolunu tut, örn. soap:Envelope/soap:Body/*/m:Price | |
| Root, Declaration | Oluşturma: kök öğe adı, <?xml …?> satırı | |
| Max bytes | En büyük girdi | 64 KiB (1 ile 256 KiB arası) |
<!DOCTYPE içeren belge reddedilir. En fazla 10.000 öğe, öğe başına 64 öznitelik, ad başına 128 karakter. Hatalar: parse_error, dtd_refused, too_large, too_deep, bad_name, no_root.
Hex ve Base64
Bir özelliği hex (bayt başına iki küçük harfli rakam) veya base64 metnine kodlar ya da geri çözer.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| mode | Hangi yön | auto | auto, encode, decode |
| property | Özellik | msg.payload | bir msg., flow. veya global. yolu |
auto modunda hex (veya base64) gibi görünen metin çözülür, diğer her şey kodlanır; test gibi kısa sözcükler veya 2024 gibi rakamlar da geçerli base64 veya hex’tir, bu yüzden yönü bildiğinizde encode veya decode seçin. Hex çözme boşlukları ve iki noktaları yok sayar.
Bytes
İkili verilerden adlandırılmış sayıları okur veya sayılardan ikili veri oluşturur.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| mode | Okuma veya oluşturma | decode | decode, encode |
| fields | Alan başına bir satır | boş | en fazla 16 satır |
Her alan:
| Alan | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| name | Sonuçtaki anahtar | zorunlu | önce bir harf veya _, en fazla 32 karakter |
| offset | İlk bayt, 0’dan başlar | 0 | 0 ile 4.095 arası |
| type | Boyut ve tür | u16 | u8, i8, u16, i16, u32, i32, f32 |
| le | Little endian | off (big endian) | on, off |
| bits | Bit aralığı start:length | tüm alan | örn. 0:1, 4:3 |
| scale | Decode: × ölçek; encode: ÷ ölçek | 1 | bir sayı |
Decode, msg.payload içindeki hex metni (boşluk ve iki nokta yok sayılır) veya bayt değerleri dizisini okur ve { name: value } yazar. Encode hex metni yazar. Veri hex değilse veya bir alan sonunun ötesine düşerse invalid_value hatası.
Örnek: 00d7ff9c ham yükü, temp (offset 0, i16, scale 0.1) ve pressure (offset 2, i16) ile { "temp": 21.5, "pressure": -100 } verir.
Ham cihaz verisinin çözülmesi
İkili veri gönderen bir cihaz, tek bir raw anahtarıyla gelir (ikili veri için base64). Save telemetry öncesinde kök flow içinde tipik bir çözücü:
Switch (msg.payload.raw nempty) → Change: set msg.payload to the path msg.payload.raw
→ Base64 (decode) → Hex (encode) → Bytes (decode fields) → Save telemetry
Dağıtmadan önce sonucu Test ile kontrol edin. LoRaWAN cihazları için bunun yerine codec kullanın; bkz. Codecs overview. Blokların ifade edemediği durumlar için The script block kullanın.

