Bu bloklar kişiler ve cihazlar üzerinde işlem yapar: alarm açar ve kapatır, komut gönderir, bir cihazın kendi isteklerini yanıtlar ve bildirim gönderir. Alarm ve komut blokları, kökeni bir cihaz olan bir mesaj gerektirir; Notify ise her mesajla çalışır.
Alarm oluştur
Mesajın cihazında bir alarm açar veya aynı türdeki açık alarmı günceller: cihaz ve tür başına bir açık alarm.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| alarm | Alarm türü | zorunlu | bir şablon, ör. tank.{{ msg.metadata.topic }}.low; harfler, rakamlar, _ . : -, işlenmiş hâlinde en fazla 128 |
| severity | Önem derecesi | warning | critical, major, minor, warning, info |
| text | Başlık | tür | bir şablon, en fazla 256 karakter |
| value | Alarmın ayrıntılarında tutulur | msg.payload | bir yol |
| notify_to | Kime bildirilir | kimse | kullanıcı kimlikleri, e-posta adresleri, OWNER, ADMIN, USER rolleri |
| notify_channels | Kanallar | her kişinin tercihi | inapp, mail gibi kanal kimlikleri |
| notify_min_severity | Yalnızca bu önem derecesinden itibaren bildir | info | bir önem derecesi |
| notify_repeat_sec | Açık ve onaylanmadığı sürece hatırlat | hatırlatma yok | 0, ya da 60 saniye ve üzeri |
out: alarm (msgType alarm, alarm msg.payload içinde). Hatalar: not_a_device, bad_alarm_id. Bildirimler, alarm kurallarıyla aynı yaşam döngüsünü izler: sınırlama, bir alarm fırtınasında özet, kritik alarmlar kuruluşunuz bunu kapatmadıysa kişisel tercihleri atlar. Bir yükseltme yeniden bildirir; aynı önem derecesinde yeniden oluşturma bildirmez. Gecikmiş bir mesaj hiçbir alarmı değiştirmez. Bkz. Alarm bildirimleri ayrıntılı.
Alarmı temizle
Mesajın cihazındaki belirli türde açık alarmı çözüldü olarak kapatır.
| Ayar | Anlamı | Değerler |
|---|---|---|
| alarm | Alarm türü | zorunlu, bir şablon |
out: temizlenen alarm; açık alarm yoksa mesaj değişmeden çıkar. Alarm hakkında bilgilendirilen herkese çözüldüğü bildirilir.
Alarmı onayla
Cihazın açık alarmlarını onaylar: açık kalırlar, hatırlatmalar durur.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| alarm | Hangi alarmlar | açık olan her alarm | *, bir tür veya * ile biten bir önek |
| min_severity | Yalnızca bu önem derecesinden itibaren | info | bir önem derecesi |
| note | Her alarmın zaman çizelgesine not | yok | en fazla 256 karakter |
Üç alarm bloğunun tümü, alarm kurallarının yaptığı gibi alarm üretir. Yaptıkları alarm değişiklikleri, alarm dinleyen Cihaz mesajı tetikleyicileri tarafından algılanır; hem alarm oluşturan hem de alarmları dinleyen bir akış kendini yeniden başlatabilir ve dağıtım “Kendi akışını yeniden başlatabilir” uyarısı verir. Bkz. Alarmlarla çalışma.
Komut gönder
Cihaz profilinin komut listesinden, mesajın cihazına bir komut gönderir. Bekleme yoktur: mesaj yaptığı istekle birlikte akışa devam eder; cihazın yanıtı daha sonra gelir.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| command | Profilin komut listesinden bir komut | zorunlu (ya da ham bir metot) | profillerinizin komutları arasından seçilir |
| params | Komutun parametreleri | yok | {"on": true} gibi bir nesne ya da msg.payload gibi bir yol |
| method | Komut listesi dışında ham bir metot | boş | namespace.verb, en fazla 64 karakter |
out: msg.metadata.rpcId (istek; cihazın Komutlar sekmesinde de görünür) ve msg.metadata.rpcStatus (QUEUED, ya da komut beklemeye alınamadığında ve cihaz çevrimdışıyken FAILED) içeren mesaj. Hatalar (istek yapılmadı):
| Kod | Anlamı |
|---|---|
not_a_device, device_not_found | Cihazlarınızdan biri değil |
unknown_command | Cihazın profilinde böyle bir komut yok |
bad_params | Parametreler komutla eşleşmiyor (msg.error.param birini adlandırır) |
method_refused | Fabrika ayarlarına dönme, eşleştirme veya ağı unutma buluttan asla gönderilmez |
limit | Son bir dakikada bu cihaza çok fazla komut (akışlardan varsayılan 30) |
device_not_active, rpc_not_supported_by_profile, payload_too_large | Konsolun vereceği şekilde |
- Komut, her mesajın cihazının profilinde aranır: birden çok profile hizmet eden bir akış yalnızca komutu olan profillere gönderir.
- İstek akış adına yapılır ve konsoldan yapılmış gibi cihazın komut geçmişinde görünür. Yüksek etkili bir komut çalışırken onay gerektirmez: dağıtımda onaylanmıştır.
- Dağıtım, komutun her profildeki seviyesine ait gönderme iznini, yüksek etkili bir komut için Kontrol seviyeli düğümlerle akışları dağıt iznini ve ham bir metot için ham RPC iznini gerektirir.
- Tekrar oynatılan ya da yeniden iletilen bir mesaj, yaptığı isteği bulur ve yeniden hiçbir şey göndermez. Gecikmiş bir mesaj komut göndermez.
- Her istek,
msg.metadata.rpcStatus,rpcIdverequestedByile birlikte tek birrpc_responsemesajıyla sonlanır (SUCCESSFUL,FAILED,TIMEOUT,EXPIRED,CANCELLED). Bu bir cihaz mesajıdır, bu yüzden cihazın kök akışına ulaşır; oradan yönlendirin.
Cihaz isteğini yanıtla
Cihazın platforma gönderdiği bir isteği yanıtlar (cihazın bulutta bir metot çağırdığı bir rpc_request mesajı). Yerleşik getCurrentTime ve getSessionLimits metotları, bir akış herhangi bir şey görmeden yanıtlanır.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| result | Metodun döndürdüğü değer | msg.payload | herhangi bir değer; {"ok": true, "result": …} olarak gönderilir |
| error | Bunun yerine reddet | yok | unsupported_method, bad_params, busy, timeout, expired, forbidden, payload_too_large, internal; {"ok": false, "error": …} olarak gönderilir |
| message | Reddetmeyle birlikte gönderilen metin | boş | en fazla 256 karakter, şablonlara izin verilir |
İlk yanıt geçerlidir. Hiçbir akış 5 saniye içinde yanıt vermezse platform unsupported_method yanıtını verir. Hatalar: rpc_request_closed, not_an_rpc_request, payload_too_large, invalid_value. MQTT cihazı yanıtı v1/rpc/up/res/{id} üzerinden alır, HTTP cihazı ise bekleyen isteğine alır. Bu bloğu kök akışın rpc_request dalına koyun (varsayılan kök yalnızca bu istekleri günlükler).
Notify
Bir bildirim gönderir ve mesajı akışta iletir.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| Alıcılar | Bir Tür ve bir değerden oluşan satırlar | zorunlu | en fazla 20 satır; genişletmeden sonra 20 alıcı |
| Tekrar nedeni | Soğuma süresi için iki bildirimi “aynı” yapan şey | bildirimin sözcükleri | şablon, 200 karakter |
| Kanallar | Bu kanallarla sınırla | her alıcının tercihleri | inapp, mail, sms, push gibi kanal kimlikleri |
| Aciliyet | critical, kuruluşunuz bunu kapatmadıysa kişisel tercihleri atlar | normal | normal, critical |
| Başlık, Metin | Mesaj | şablonlar, sırasıyla 200 ve 4.000 karakter | |
| Metin biçimi | text, ya da e-posta için html | text | text, html |
| E-posta konusu, Yanıt adresi | E-posta seçenekleri | başlık, ya da yok | şablonlar |
| Kopya, Gizli kopya | Ek e-posta alıcıları; her biri kendi e-postasını alır | yok | şablonlar |
| E-posta ekleri | E-posta için dosyalar | yok | 10 dosya, toplam 1 MiB |
Kime, hangi kanaldan ulaşılır
| Tür | Değer | Ulaşılan |
|---|---|---|
user | Bir üyenin kullanıcı kimliği | Bu üye; uygulamada, push ile ve bağlı sohbet uygulamalarında |
role | OWNER, ADMIN ya da USER | O role sahip her etkin üye, yukarıdaki gibi |
custom_role | Özel bir rol anahtarı | Üyeleri, yukarıdaki gibi |
team | Bir ekip kimliği | Üyeleri, yukarıdaki gibi |
originator_owner | Boş | Bir modülün tanımladığı yerde, mesajın kökenindeki sahipler, yukarıdaki gibi |
address | Virgülle ayrılmış bir ya da daha fazla e-posta adresi | E-posta |
phone | Virgülle ayrılmış, uluslararası biçimde bir ya da daha fazla numara | SMS |
Üyeler yalnızca kullanıcı kimlikleriyle (user id) eklenir. E-posta ve SMS yalnızca address ve phone satırlarına ulaşır. user olarak listelenen ya da bir rol, özel rol veya ekip üzerinden erişilen bir üye, bildirimi uygulamada, tercihlerine göre push ile ve bağlı sohbet uygulamalarında alır; e-posta adresi olsa bile e-posta veya SMS almaz. İnsanlara e-posta göndermek için adreslerini bir address satırına ekleyin.
20’den fazla aktif üyesi olan bir rol veya ekip reddedilir (too_many_recipients); yarım bilgilendirme yapılmaz.
Bekleme süresi, kotalar ve geç gelen mesajlar
- Bir kişi, aynı akıştan gelen aynı nedenli bildirimi 10 dakikada bir alır (planınız başka bir süre belirleyebilir, en az 1 dakika). Metin her okumayla değiştiğinde Tekrar nedeni alanını ayarlayın; örneğin
level of {{ msg.metadata.deviceName }}. Bekleme süresi dolduktan sonraki bildirim “(+n)” ifadesiyle gönderilir. - Göndermeden önce blok, aylık e-posta ve SMS kotalarını denetler; kotası dolan bir kanal dışarıda bırakılır (
msg.metadata.notify.quota). Yalnızca tüm kanalların kotası dolduğundalimithatasıyla başarısız olur. - Geç gelen bir mesaj kimseye bildirim göndermez.
out, msg.metadata.notify değerini taşır: recipients, delivered, failed, suppressed, invalid, quota, held. Hatalar: no_recipients, too_many_recipients, members_unavailable, invalid_attachment, notify_failed, node_not_ready, circuit_open, limit.
Şablonlar, HTML e-postalar ve ekler için bkz. Kurallar ve akışlardan bildirimler.

