Bu bloklar kişiler ve cihazlar üzerinde çalışır: alarm açar ve kapatır, komut gönderir, bir cihazın kendi isteklerini yanıtlar ve bildirim gönderir. Alarm ve komut blokları, kaynağı bir cihaz olan bir mesaj gerektirir; Notify ise herhangi bir 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şlendikten sonra 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 | hiç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 veya 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, alarm fırtınasında özet, kuruluşunuz kapatmadıysa kritik alarmlar kişisel tercihleri aşar. 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ında bir türdeki açık alarmı çözümler.
| Ayar | Anlamı | Değerler |
|---|---|---|
| alarm | Alarm türü | zorunlu, bir şablon |
out: temizlenen alarm; açık alarm yoksa mesaj değişmeden. Alarmdan haberdar edilen 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 | tüm açık alarmlar | *, 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 çizelgesinde bir not | yok | en fazla 256 karakter |
Üç alarm bloğunun tümü, alarm kurallarının yaptığı gibi alarm üretir. Yaptıkları bir alarm değişikliği, alarm dinleyen Cihaz mesajı tetikleyicileri tarafından algılanır; alarm oluşturup aynı zamanda 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 bir komutu mesajın cihazına gönderir. Beklenmez: mesaj yaptığı istekle birlikte akışa devam eder; cihazın yanıtı daha sonra gelir.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| command | Profilin komut listesindeki bir komut | zorunlu (veya ham bir method) | profillerinizin komutlarından seçilir |
| params | Komutun parametreleri | yok | {"on": true} gibi bir nesne veya msg.payload gibi bir yol |
| method | Komut listesinin dışında ham bir method | 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 bekleyemediyse ve cihaz çevrimdışıysa FAILED) içeren mesaj. Hatalar (istek yapılmadı):
| Kod | Anlamı |
|---|---|
not_a_device, device_not_found | Sizin 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 bunu adlandırır) |
method_refused | Fabrika ayarlarına sıfırlama, 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 bildireceği gibi |
- Komut, her mesajın cihazının profilinde aranır: birden fazla profile hizmet eden bir akış, yalnızca profilinde komut bulunanlara gönderir.
- İstek akış adına yapılır ve konsoldakiler 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 bulunduğu her profilde komut seviyesinin gönderme iznini, yüksek etkili bir komut için Kontrol seviyesindeki düğümlerle akışları dağıt iznini ve ham bir method için ham RPC iznini gerektirir.
- Tekrar oynatılan veya yeniden iletilen bir mesaj, zaten 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 (SUCCESSFUL,FAILED,TIMEOUT,EXPIRED,CANCELLED) biter. Bu bir cihaz mesajıdır, cihazın kök akışına ulaşır; oradan yönlendirin.
Bir ağ geçidinin arkasındaki cihazlara komut gönderme geliştirme aşamasındadır. Bkz. Cihazlara komut gönderme.
Cihaz isteğini yanıtla
Cihazın platforma gönderdiği bir isteği yanıtlar (bir rpc_request mesajı: cihaz bulutta bir method çağırır). Yerleşik getCurrentTime ve getSessionLimits methodları, bir akış hiçbir şey görmeden yanıtlanır.
| Ayar | Anlamı | Varsayılan | Değerler |
|---|---|---|---|
| result | Methodun 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 kazanır. 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. Bir MQTT cihazı yanıtı v1/rpc/up/res/{id} üzerinden, bir HTTP cihazı ise bekleyen isteği üzerinden alır. Bu bloğu kök akışın rpc_request dalına koyun (varsayılan kök yalnızca bu istekleri günlüğe yazar).
Bildir
Bir bildirim gönderir ve mesajı ileterek devam eder.
| 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 | Bekleme 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 kapatmadıysa kişisel tercihleri atlar | normal | normal, critical |
| Başlık, Metin | İleti | şablonlar, 200 ve 4.000 karakter | |
| Metin biçimi | text, ya da e-posta için html | text | text, html |
| E-posta konusu, Yanıtla | E-posta seçenekleri | başlık, yok | şablonlar |
| Bilgi, Gizli bilgi | Daha fazla e-posta alıcısı; 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 | O üye; uygulamada, push ile ve bağlı sohbet uygulamalarında |
role | OWNER, ADMIN veya 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 kaynağının sahipleri, yukarıdaki gibi |
address | Virgülle ayrılmış bir veya daha fazla e-posta adresi | E-posta |
phone | Virgülle ayrılmış, uluslararası biçimde bir veya daha fazla numara | SMS |
Üyelere yalnızca kullanıcı kimlikleriyle ulaşılır. E-posta ve SMS yalnızca address ve phone satırlarına ulaşır. user olarak listelenen veya rol, özel rol ya da ekip üzerinden ulaşılan bir üye, bildirimi tercihlerine göre uygulamada, push ile ve bağlı sohbet uygulamalarında alır; e-posta adresi olsa bile e-posta veya SMS ile almaz. Kişilere e-posta göndermek için adreslerini bir address satırına ekleyin.
20’den fazla etkin üyesi olan bir rol veya ekip reddedilir (too_many_recipients), yarım bildirim yapılmaz.
Bekleme süresi, kotalar ve gecikmiş mesajlar
- Bir kişi, aynı akıştan aynı nedenle gelen bildirimi en fazla her 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 ayarlayın, ör.
level of {{ msg.metadata.deviceName }}. Bekleme süresi bittikten sonraki bildirim “(+n)” ifadesiyle gelir. - Göndermeden önce blok aylık posta ve SMS kotalarını denetler; kotası dolan bir kanal dışarıda bırakılır (
msg.metadata.notify.quota). Yalnızca her kanalın kotası dolduğundalimitile başarısız olur. - Gecikmiş bir mesaj hiç kimseye bildirim göndermez.
out, msg.metadata.notify 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-posta ve ekler için bkz. Kurallardan ve akışlardan bildirimler.