Yeni: Yapay zekâ güvenlik duvarı tüm platformu izliyor ve her olayı sade bir dille açıklıyor. Nasıl çalıştığını görün

Alarm, komut ve bildirim blokları

Alarm oluştur, Alarmı temizle, Alarmı onayla, Komut gönder, Cihaz isteğini yanıtla ve Bildir bloklarının referansı; bir bildirimin hangi kanalda kimlere ulaştığı dahil.

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.

AyarAnlamıVarsayılanDeğerler
alarmAlarm türüzorunlubir şablon, ör. tank.{{ msg.metadata.topic }}.low; harfler, rakamlar, _ . : -, işlenmiş hâlinde en fazla 128
severityÖnem derecesiwarningcritical, major, minor, warning, info
textBaşlıktürbir şablon, en fazla 256 karakter
valueAlarmın ayrıntılarında tutulurmsg.payloadbir yol
notify_toKime bildirilirkimsekullanıcı kimlikleri, e-posta adresleri, OWNER, ADMIN, USER rolleri
notify_channelsKanallarher kişinin tercihiinapp, mail gibi kanal kimlikleri
notify_min_severityYalnızca bu önem derecesinden itibaren bildirinfobir önem derecesi
notify_repeat_secAçık ve onaylanmadığı sürece hatırlathatırlatma yok0, 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.

AyarAnlamıDeğerler
alarmAlarm 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.

AyarAnlamıVarsayılanDeğerler
alarmHangi alarmlaraçık olan her alarm*, bir tür veya * ile biten bir önek
min_severityYalnızca bu önem derecesinden itibareninfobir önem derecesi
noteHer alarmın zaman çizelgesine notyoken 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.

AyarAnlamıVarsayılanDeğerler
commandProfilin komut listesinden bir komutzorunlu (ya da ham bir metot)profillerinizin komutları arasından seçilir
paramsKomutun parametreleriyok{"on": true} gibi bir nesne ya da msg.payload gibi bir yol
methodKomut listesi dışında ham bir metotboş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ı):

KodAnlamı
not_a_device, device_not_foundCihazlarınızdan biri değil
unknown_commandCihazın profilinde böyle bir komut yok
bad_paramsParametreler komutla eşleşmiyor (msg.error.param birini adlandırır)
method_refusedFabrika ayarlarına dönme, eşleştirme veya ağı unutma buluttan asla gönderilmez
limitSon bir dakikada bu cihaza çok fazla komut (akışlardan varsayılan 30)
device_not_active, rpc_not_supported_by_profile, payload_too_largeKonsolun 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, rpcId ve requestedBy ile birlikte tek bir rpc_response mesajı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.

AyarAnlamıVarsayılanDeğerler
resultMetodun döndürdüğü değermsg.payloadherhangi bir değer; {"ok": true, "result": …} olarak gönderilir
errorBunun yerine reddetyokunsupported_method, bad_params, busy, timeout, expired, forbidden, payload_too_large, internal; {"ok": false, "error": …} olarak gönderilir
messageReddetmeyle birlikte gönderilen metinboş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.

AyarAnlamıVarsayılanDeğerler
AlıcılarBir Tür ve bir değerden oluşan satırlarzorunluen fazla 20 satır; genişletmeden sonra 20 alıcı
Tekrar nedeniSoğuma süresi için iki bildirimi “aynı” yapan şeybildirimin sözcüklerişablon, 200 karakter
KanallarBu kanallarla sınırlaher alıcının tercihleriinapp, mail, sms, push gibi kanal kimlikleri
Aciliyetcritical, kuruluşunuz bunu kapatmadıysa kişisel tercihleri atlarnormalnormal, critical
Başlık, MetinMesajşablonlar, sırasıyla 200 ve 4.000 karakter
Metin biçimitext, ya da e-posta için htmltexttext, html
E-posta konusu, Yanıt adresiE-posta seçenekleribaşlık, ya da yokşablonlar
Kopya, Gizli kopyaEk e-posta alıcıları; her biri kendi e-postasını alıryokşablonlar
E-posta ekleriE-posta için dosyalaryok10 dosya, toplam 1 MiB

Kime, hangi kanaldan ulaşılır

TürDeğerUlaşılan
userBir üyenin kullanıcı kimliğiBu üye; uygulamada, push ile ve bağlı sohbet uygulamalarında
roleOWNER, ADMIN ya da USERO role sahip her etkin üye, yukarıdaki gibi
custom_roleÖzel bir rol anahtarıÜyeleri, yukarıdaki gibi
teamBir ekip kimliğiÜyeleri, yukarıdaki gibi
originator_ownerBoşBir modülün tanımladığı yerde, mesajın kökenindeki sahipler, yukarıdaki gibi
addressVirgülle ayrılmış bir ya da daha fazla e-posta adresiE-posta
phoneVirgülle ayrılmış, uluslararası biçimde bir ya da daha fazla numaraSMS

Ü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ğunda limit hatası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.