Tehdit ve Panik
Temel platformduress_acknowledge_incidentTehdit ve PanikAçık bir Duress olayını kullanıcı adına onaylar: kullanıcının müdahale ettiğini kaydeder ve daha fazla eskalasyonu durdurabilir. Yalnızca açık olaylar onaylanabilir.
Her zaman önce onay alın. Olayı almak için confirm olmadan çağırın, kullanıcıya neyi onayladığını söyleyin ve yalnızca kabul ettikten sonra confirm: true ile yeniden çağırın.
Bir iş akışında veya bir Agent'tan çağrıldığında bu yalnızca tesisin müdahale planının iş akışlarının alarmları onaylamasına, çözmesine ve tetiklemesine izin verdiği yerlerde çalışır. Bir olayı kapatmak için duress_resolve_incident kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
incidentId* | string | duress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). |
note | string | İsteğe bağlı not, ör. "Resepsiyona gidiyorum" |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_end_testTehdit ve PanikBir tesiste devam eden Duress testini hemen sona erdirir, böylece bir sonraki basış gerçek bir alarm olur. Sonuçlar, her testte olduğu gibi yaklaşık 10 dakika sonra gelir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
duress_incidents_readTehdit ve PanikDuress alarm olaylarını okur (personel bir Duress düğmesine bastı veya bir iş akışı alarm tetikledi): listeler, tek bir olayın zaman çizelgesi ve gönderimleri, olay sonrası inceleme raporu ve bir alarm çevresindeki güvenlik kamerası kayıtları.
Durumlar: open (henüz kimse onaylamadı), acknowledged (biri müdahale ediyor), resolved (kapatıldı, bir sonuçla: genuine, false_alarm, test veya unknown). active, open veya acknowledged anlamına gelir. Test olayları (isTest) düğme testlerinden gelir; testType 'unplanned', gerçek olarak tetiklenen ve bir müdahale görevlisinin test olarak çözdüğü bir alarmdır.
Gönderim durumu: sent, acknowledged (alıcı onayladı), failed (bkz. error), shadow (deneme çalıştırması, hiçbir şey gönderilmedi). İzleme merkezine yapılan gönderimler ayrıca monitoringCentre altında toplanır. Sonuçlar kişilerin adını verir ancak hiçbir zaman telefon numarası veya e-posta adresi içermez. Saatler ISO biçimindedir.
Eylemler:
- list: Olayları listeler. En yeni önce. scope: facility (varsayılan; verilen veya bağlı tesis) ya da organisation (görebildiğiniz organizasyondaki her tesis; varsayılan olarak tesisin organizasyonu).
- get: Bir olayı getirir. Durum, basılan düğmeler, zaman çizelgesi (basışlar, eskalasyonlar, onaylar, notlar) ve her bildirim veya izleme merkezi gönderim denemesi sonucuyla birlikte. incidentId gerektirir.
- report: Olay raporu. Olay sonrası inceleme için: olay, onaylama ve çözme süresi (saniye), ulaşılan adımlar, her zaman çizelgesi girişi, kanal başına ne gönderildiği ve neyin başarısız olduğu ve kayıtların saklanıp saklanmadığı. İncelemeyi olaya eklemek için duress_incidents_write add_note ile birlikte kullanın. incidentId gerektirir.
- footage_previews: Alarm kayıtları. Alarm kayıtlarındaki her kamera: durumu, kare ve klip sayıları, yüklenen klipler ve basışa en yakın kare (posterSeconds). cameraId ile yalnızca o kamera ve her karenin Unix saniyesi (frameSeconds). Tesiste güvenlik kamerası gerektirir. incidentId gerektirir.
- footage_frame: Alarm kaydı karesi. Alarm kayıtlarından bir hızlandırılmış çekim karesi, görüntü olarak döndürülür: kayıtlar saklandıysa saklanan kopya, aksi halde alarm penceresindeki canlı kare. seconds, footage_previews'tan bir posterSeconds veya frameSeconds değeridir. incidentId, cameraId, seconds gerektirir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "list" | "get" | "report" | "footage_previews" | "footage_frame" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
scope | "facility" | "organisation" | Varsayılan facility (list) |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. (list) |
organisationId | string | scope organisation için. Varsayılan olarak tesisin organizasyonudur. (list) |
status | "active" | "open" | "acknowledged" | "resolved" | active, open veya acknowledged demektir (list) |
from | string | ISO tarih-saati: bu zamanda veya sonrasında açılan olaylar (list) |
to | string | ISO tarih-saati: bu zamanda veya öncesinde açılan olaylar (list) |
limit | integer | Sayfa başına öğe (varsayılan 25, en fazla 100) (list) |
cursor | string | Önceki sayfadan nextCursor (list) |
incidentId | string | duress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). (get, report, footage_previews, footage_frame) |
cameraId | string | footage_previews'tan alarm kayıtlarındaki bir kamera (footage_previews, footage_frame) |
seconds | integerstring | 10 haneli Unix saniyesi olarak kare zamanı (footage_frame) |
duress_incidents_writeTehdit ve PanikDuress ConfigurationAlarmın kendisine dokunmadan bir Duress olayını değiştirir: olayı adlandırır, personel notları ekler ve çevresindeki güvenlik kamerası kayıtlarını saklar veya serbest bırakır. Kimse uyarılmaz. Onaylamak, çözmek veya müdahale görevlilerini bilgilendirmek için duress_acknowledge_incident, duress_resolve_incident veya duress_post_update kullanın.
Eylemler:
- rename: Bir olayı adlandırır. Olayın daha sonra kolayca bulunması için ad verir, ör. "Ön tezgâhta saldırgan ziyaretçi". Boş veya null ad, adı kaldırır. Adlar Duress konsolunda ve raporlarda görünür. incidentId gerektirir.
- add_note: Not ekler. Olayın zaman çizelgesine bir not ekler, ör. kullanıcının ne bulduğu veya kimin müdahale ettiği. Her durumda kullanılabilir; notları yalnızca personel görür ve olayı değiştirmezler. Notu kullanıcının kendi sözleriyle yazın ve ifadeyi önce kullanıcıyla teyit edin. incidentId, note gerektirir.
- keep_footage: Alarm kayıtlarını saklar. Çözülmüş gerçek bir alarm çevresindeki güvenlik kamerası kayıtlarını, müdahale planının dakikalarını ve kameralarını kullanarak normal kayıtlarla birlikte silinmeyecek şekilde saklar. Kayıtlar yüklendikten birkaç dakika sonra gerçekleşir. Testler, açık alarmlar veya zaten saklanmış ya da serbest bırakılmış kayıtlar için kullanılamaz. incidentId gerektirir.
- release_footage: Saklanan kayıtları serbest bırakır. Bir alarm için saklanan kayıtlardan vazgeçer: klipler normal saklama süresine döner ve saklanan kareler silinir; böylece normal kayıtların süresi dolduğunda artık görüntülenemez. Tesiste Duress Configuration gerektirir. incidentId gerektirir. Onay ister.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "rename" | "add_note" | "keep_footage" | "release_footage" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
incidentId | string | duress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). |
name | stringnull | Ad; boş veya null adı kaldırır (rename) |
note | string | Not (add_note) |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_lift_lockdownTehdit ve PanikBir Duress alarmının kilitlemesini kaldırır: kilitlediği kapılar yeniden insanların girişine izin verir. Alarmın durumu ne olursa olsun çalışır.
Önce onay alın. Kilitlemeyi görmek için confirm olmadan çağırın, kullanıcıya bildirin ve kabul ettiğinde confirm: true ile yeniden çağırın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
incidentId* | string | duress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_post_updateTehdit ve PanikBir Duress alarmına müdahale eden kişilere bir güncelleme gönderir, ör. "Polis yolda" veya "Tehlike geçti, kişi ayrıldı". Güncelleme alarm sayfalarında ve Duress uygulamasında görünür; gerçek bir alarmda müdahale planı bunu alarm hakkında zaten SMS gönderilmiş herkese SMS olarak da gönderebilir. Güncellemeler, alarm çözüldükten sonraki 24 saate kadar gönderilebilir.
Önce onay alın. Olayı kontrol etmek için confirm olmadan çağırın, kullanıcıya tam ifadeyi gösterin ve kabul ettiğinde confirm: true ile yeniden çağırın. Yalnızca personelin görmesi gereken bir şey için bunun yerine duress_incidents_write add_note kullanın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
incidentId* | string | duress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). |
text* | string | Güncellemenin kelimesi kelimesine metni |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_raise_alarmTehdit ve PanikTesiste, bir düğmeye basılmış gibi gerçek bir Duress alarmı tetikler: müdahale planı çalışır (kişiler uyarılır, eskalasyon ve hatırlatmalar izler, müdahale eylemleri çalışır) ve alarm, nedeniyle birlikte bu iş akışı tarafından tetiklendiğini belirtir.
- reason: ne olduğu, ör. "Arka çıkıştaki kapı zorla açıldı" (en fazla 200 karakter).
- deviceSerialNumber: isteğe bağlı. Konumu kullanılacak bir düğme; yalnızca bu durumda izleme merkezi de o düğmenin bölgesiyle bilgilendirilir.
Yalnızca bir iş akışı adımı olarak, müdahale planı iş akışlarının alarmları onaylamasına, çözmesine ve tetiklemesine izin veren tesislerde kullanılır. Bu iş akışının alarmı açıkken başka bir alarm tetiklemez; bunun yerine o alarmı döndürür.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
reason* | string | Ne olduğu |
deviceSerialNumber | string | Tesisteki bir düğme (isteğe bağlı) |
duress_reports_readTehdit ve PanikDuress ConfigurationBir tesis, marka veya organizasyon için Duress uyumluluk raporlaması: müdahale süreleri (P50/P95), sonuca göre olaylar ve yanlış alarm oranı, test kapsamı ve testi gecikmiş tesisler, düğme çalışma süresi, izleme merkezi gönderim başarısı ve olay bazında dışa aktarma. Ayrıca tek bir tesisteki son alarmın iletilmeyen uyarıları.
Günler tesisin yerel saatine göredir; 400 günü aşan dönemler kısaltılır (range.capped). Gerçek ve test olayları ayrı sayılır. Süreler ms cinsindendir (p50Ms, p95Ms). Organizasyon genelinde erişiminiz yoksa marka raporları yalnızca erişebildiğiniz tesisleri kapsar (scope.restrictedToAccessibleFacilities).
Eylemler:
- overview: Duress rapor özeti. Toplamlar, aylık eğilim ve organizasyon, marka ve tesis başına ölçümler (incidents, testCoverage, deviceUptime, deliveries). Tesisler sayfalıdır.
- compliance_summary: Duress uyumluluk özeti. Uyumluluk PDF'inin gösterdikleri: testi gecikmiş tesislerle test kapsamı, düğme çalışma süresi, gönderim başarısı, son testler (testHistory) ve her tesis için son testi, tatbikatı ve gerçek alarmı ile her düğmenin çalışma süresi. Tesisler sayfalıdır.
- incident_export: Duress olay dışa aktarımı. CSV dışa aktarımının sütunlarıyla, en eskisi önce olmak üzere olay başına bir satır: tesis, test veya gerçek, durum, sonuç, yerel saatler, onaylama ve çözme süresi (saniye), kimin onayladığı ve çözdüğü, düğmeler ve gönderim sayıları.
- delivery_problems: İletilmeyen alarm uyarıları. Tesisin son alarmı veya testi (tüm test penceresiyle) ve hiç ulaşmayan uyarılar, kanala göre. Her şey iletildiyse problems null olur. Orada Duress veya Duress Configuration gerektirir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "overview" | "compliance_summary" | "incident_export" | "delivery_problems" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
scope | "facility" | "brand" | "organisation" | Varsayılan: verilen en belirli kimlik, yoksa bağlı tesis. (overview, compliance_summary, incident_export) |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
brandId | string | Bir tesis yerine markanın şablonu için marka kimliği (overview, compliance_summary, incident_export) |
organisationId | string | Organizasyon genelinde Duress erişimi gerektirir (overview, compliance_summary, incident_export) |
from | string | İlk gün, tesis yerel saatine göre YYYY-MM-DD (varsayılan to'dan 30 gün önce) (overview, compliance_summary, incident_export) |
to | string | Son gün, tesis yerel saatine göre YYYY-MM-DD, dahil (varsayılan bugün) (overview, compliance_summary, incident_export) |
limit | integer | Sayfa başına öğe (varsayılan 25, en fazla 100) (overview, compliance_summary, incident_export) |
cursor | string | Önceki sayfadan nextCursor (overview, compliance_summary, incident_export) |
duress_resolve_incidentTehdit ve PanikBir Duress olayını çözer: alarmı kapatır, eskalasyonu durdurur ve sonucu kaydeder. Açık ve onaylanmış olaylar çözülebilir.
- disposition:
genuine(gerçek bir acil durum),false_alarm,testveyaunknown. - note: ne olduğu. Gerçek bir alarm için zorunludur.
Her zaman önce onay alın. Olayı almak için confirm olmadan çağırın, kullanıcıya hangi alarmı kapattığını ve sonucu söyleyin ve yalnızca kabul ettikten sonra confirm: true ile yeniden çağırın.
Bir iş akışında veya bir Agent'tan çağrıldığında bu yalnızca tesisin müdahale planının iş akışlarının alarmları onaylamasına, çözmesine ve tetiklemesine izin verdiği yerlerde çalışır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
incidentId* | string | duress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). |
disposition* | "genuine" | "false_alarm" | "test" | "unknown" | Sonuç |
note | string | Ne olduğu. disposition genuine olduğunda zorunludur. |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_settings_readTehdit ve PanikDuress ConfigurationDuress ayarlarını okur: müdahale planları (bir tesiste veya marka şablonu olarak kimin, hangi sırayla ve nasıl uyarıldığı), alarm motorunun fiilen kullandığı çözümlenmiş plan, eklenebilecek kişiler ve roller, cihaz uyarıları (pil, çevrimdışı, kapsama ve gönderim sorunları), marka iletişim kuralları ve plan durumu, bir markanın veya organizasyonun düğme özeti ve alarmların izleme merkezine nereden gittiği.
Bir tesis, markasının (yoksa organizasyonunun) şablonunu izler, onu ek kişilerle genişletir (mode extend) veya kendi planıyla değiştirir (mode replace). Ayarları duress_settings_write ile değiştirin. Saatler ISO biçimindedir.
Eylemler:
- response_plan: Müdahale planı. Bir tesiste geçerli olan plan (effective) ve her düzeyin içeriği (sources: facility, brand, organisation) ya da yalnızca brandId ile markanın şablonu. Kişiler kaydedildiği şekliyle, düzenlenip geri kaydedilmeye hazır olarak döner.
- resolved_plan: Çözümlenmiş plan. Alarm motorunun tesiste kademe kademe kimlerle iletişime geçtiği: kişilere açılmış roller, her birine ulaşılabilecek kanallar, gecikmeler ve bir alarmdan önce düzeltilmesi gereken uyarılar. Yalnızca adlar; telefon numarası veya e-posta yok.
- contact_options: İletişim seçenekleri. Markanın iletişim kuralları uygulandıktan sonra tesisin planına (orada Duress Configuration gerektirir) ya da yalnızca brandId ile markanın şablonuna eklenebilecek kişiler ve roller.
- device_alerts: Cihaz uyarıları. Düşük piller, çevrimdışı düğmeler, kaybedilen kapsama ve başarısız gönderimler hakkında kimin bilgilendirildiği: her düzeydeki kurallar ve tesisin çözümlenmiş alıcıları ya da yalnızca brandId ile markanın kuralları.
- contact_rules: Marka iletişim kuralları. Markadaki tesislerin planlara hangi rolleri ekleyebileceği: allowAllExcept listelenen rolleri gizler, manual yalnızca bunları sunar. Marka planını düzenlemenin gerektirdiği izinleri gerektirir. brandId gerektirir.
- plan_status: Marka plan durumu. Markadaki her tesis: şablonu izleyip izlemediği, genişletip genişletmediği veya kendi planı olup olmadığı, kaç kişi eklediği ve planının uyarıları. brandId gerektirir.
- buttons_summary: Düğme özeti. Bir marka veya organizasyondaki her tesis: düğmeler, pil ve çevrimdışı sayıları, sonraki ve son test. Brands & Customisation ve organizasyon özetlerinin verileri.
- monitoring: İzleme merkezi yönlendirmesi. Alarmların tesisten nasıl çıktığı: eaAlarmType none, cid (eaAlarmProvider üzerinden bir izleme merkezi araması) veya relay (eaRelayModel üzerinden kablolu bir panel) ve kullanabileceği sağlayıcılar.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "response_plan" | "resolved_plan" | "contact_options" | "device_alerts" | "contact_rules" | "plan_status" | "buttons_summary" | "monitoring" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. (response_plan, resolved_plan, contact_options, device_alerts, monitoring) |
brandId | string | Bir tesis yerine markanın şablonu için marka kimliği (response_plan, contact_options, device_alerts, contact_rules, plan_status, buttons_summary) |
organisationId | string | Organizasyon kimliği (buttons_summary) |
duress_settings_writeDuress ConfigurationDuress ayarlarını değiştirir: müdahale planları (bir tesiste ya da bir markanın veya organizasyonun şablonunda), cihaz uyarıları, marka iletişim kuralları ve alarmların izleme merkezine nereden gittiği. Kimin uyarılacağını değiştirdiği için her değişiklik onay ister.
facilityId (varsayılan: bağlı tesis), brandId veya organisationId'den birini iletin. Tesis planları orada Duress Configuration gerektirir; şablonlar Duress Configuration'a sahip bir organizasyon yöneticisi ya da bir marka için markadaki her tesiste Duress Configuration gerektirir. Önce duress_settings_read ile okuyun.
Eylemler:
- save_response_plan: Bir müdahale planını kaydeder. Basıştan afterSeconds sonra uyarılan kişi kademeleri (artan sırada, ilki genellikle 0), ackRequired, hatırlatmalar ve responseActions. Bir tesis bunun yerine şablonunu eklemelerle genişletebilir (mode extend). Belirtilmeyen alanlar kayıtlı değerlerini korur; responseActions eyleme göre birleştirilir. Onay ister.
- remove_response_plan: Bir müdahale planını kaldırır. Bu düzeyde kaydedilen planı siler; böylece tesis yeniden şablonunu izler, marka ise organizasyonun planına geri döner. Onay ister.
- save_device_alerts: Cihaz uyarılarını kaydeder. Bu düzeydeki cihaz uyarısı kurallarının yerini alır: her biri bir olay ve kişi kümesi (push, sms veya email) olan en fazla 10 kural. duress_settings_read device_alerts'ten okunan kural kimliklerini koruyun. rules gerektirir. Onay ister.
- remove_device_alerts: Cihaz uyarılarını kaldırır. Bu düzeydeki cihaz uyarısı kurallarını siler; böylece yeniden bir üst düzeyi izler. Onay ister.
- save_contact_rules: Marka iletişim kurallarını kaydeder. Markanın tesislerinin planlara hangi rolleri ekleyebileceği: allowAllExcept roleIds'i gizler, manual yalnızca roleIds'i sunar. Zaten kaydedilmiş kişiler kalır; çözümlenmiş planlar yenilenir. brandId, mode, roleIds gerektirir. Onay ister.
- save_monitoring: İzleme merkezi yönlendirmesini kaydeder. Alarmların nereye gittiği: eaAlarmType none, cid (eaAlarmProvider gerektirir; duress_settings_read monitoring'in listelediği sağlayıcılardan biri) veya relay (eaRelayModel). Tesiste Duress Configuration gerektirir. eaAlarmType gerektirir. Onay ister.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "save_response_plan" | "remove_response_plan" | "save_device_alerts" | "remove_device_alerts" | "save_contact_rules" | "save_monitoring" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_monitoring) |
brandId | string | Bir tesis yerine markanın şablonu için marka kimliği (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_contact_rules) |
organisationId | string | Organizasyonun şablonu için organizasyon kimliği (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts) |
mode | "replace" | "extend" | Yalnızca tesis planları: replace (kendi kademeleri) veya extend (şablona eklemeler) (save_response_plan, save_contact_rules) |
tiers | array | Planın kademeleri (mode replace ve şablonlar) (save_response_plan) |
additions | array | Mode extend: şablon kademesi başına ek kişiler (tierId ve oradan afterSeconds) (save_response_plan) |
ackRequired | boolean | Biri onaylayana kadar eskalasyonun devam edip etmediği (save_response_plan) |
reminders | objectnull | Uyarıları stopAfterSeconds'a kadar her everySeconds'ta bir tekrarlar (0 kapatır) (save_response_plan) |
responseActions | object | Ada göre eylemler, her biri { enabled, ... }: unlockOnAcknowledge (doorIds), lockdown, staffScreenAlerts, buttonAcknowledge, dashboardCctv, dashboardDoorControls, dashboardResolve, updateTexts, aiSummary, workflowControl, retainFootage (minutesBefore, minutesAfter, cameras) (save_response_plan) |
rules | array | Kurallar; boş liste hiçbir kural kaydetmez (bu düzeyde kimse uyarılmaz) (save_device_alerts) |
roleIds | array | mode'un uygulandığı rol kimlikleri (save_contact_rules) |
eaAlarmType | "none" | "cid" | "relay" | none, cid veya relay (save_monitoring) |
eaAlarmProvider | stringnull | cid için: sağlayıcı kodu (save_monitoring) |
eaRelayModel | "none" | "numato-rl80001" | relay için: röle kartı (save_monitoring) |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_start_lockdownTehdit ve PanikBir Duress alarmı için tesisi kilitler: kilitleme kaldırılana kadar (duress_lift_lockdown ile veya konsoldan) hiçbir kapı insanların girişine izin vermez. Bir alarm yalnızca bir kez kilitleme alabilir.
Test veya çözülmüş alarmlar için asla kullanılmaz. Tesiste Door/Gate Access gerektirir.
Önce onay alın. Olayı kontrol etmek için confirm olmadan çağırın, kullanıcıya tüm kapıların kilitleneceğini söyleyin ve kabul ettiğinde confirm: true ile yeniden çağırın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
incidentId* | string | duress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_start_testTehdit ve PanikBir tesiste hemen bir Duress testi başlatır. Test bitene kadar her basış gerçek bir alarm değil, bir testtir:
walk: personel her düğmeye basar; müdahale planının yalnızca ilk adımı TEST etiketiyle uyarılır.drill: müdahale planının tamamı TEST etiketiyle çalışır.
Tesisin test kişilerine testin başladığı bildirilir ve test bittikten yaklaşık 10 dakika sonra sonuçları alırlar. Her tesiste aynı anda tek bir test yapılabilir. Erken bitirmek için duress_end_test kullanın; testleri önceden planlamak için duress_tests_write kullanın.
Önce onay alın. confirm olmadan çağırın, kullanıcıya durationMinutes boyunca basışların gerçek alarm tetiklemeyeceğini söyleyin ve kabul ettiğinde confirm: true ile yeniden çağırın. Bir iş akışında veya bir Agent'tan çağrıldığında bu yalnızca tesisin müdahale planının iş akışlarının alarmları onaylamasına, çözmesine ve tetiklemesine izin verdiği yerlerde çalışır.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
type | "walk" | "drill" | walk (varsayılan) veya drill |
durationMinutes | integer | Basışların ne kadar süre test sayılacağı (varsayılan 60) |
monitoringCentreMode | "test-codes" | "none" | `test-codes` izleme merkezine test sinyalleri gönderir; `none` hiçbir şey göndermez |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_tests_readTehdit ve PanikDuress ConfigurationDuress düğme testlerini okur: testleri planlayan programlar (walk, comms veya drill; tek seferlik veya yinelenen; bir organizasyon, markalar veya tesisler için), her tesiste oluşturdukları test pencereleri (scheduled, active, completed, cancelled ve plansız testler) ve bir pencerenin sonuçları (hangi düğmelere basıldığı veya hangilerinin atlandığı, kimin bilgilendirildiği, izleme merkezi sinyalleri, onay süreleri).
Testi kimin planladığı, değiştirdiği veya iptal ettiği dahil edilmez; gönderim alıcıları gizlenir. Saatler ISO biçimindedir; localDate ve localStartTime tesisin saat dilimindedir. Testleri duress_tests_write ile planlayın veya değiştirin; hemen bir test başlatmak için duress_start_test kullanın.
Eylemler:
- schedules: Test programları. scope facility (varsayılan; atladığı veya yerine geçtiği paylaşılanlar dahil, onu kapsayan her program), brand (brandId) veya organisation (varsayılan: tesisin organizasyonu). En yeni değişiklik önce.
- windows: Test pencereleri. Bir tesisin
fromiletoarasındaki test pencereleri (varsayılan yaklaşık bir hafta öncesinden bir ay sonrasına kadar) ya da yalnızca organisationId ile organizasyonun tüm tesislerindeki yaklaşan pencereler. - results: Test sonuçları. Bir pencere ve sonuçları: gönderildikten sonra saklanır, test sürerken canlı hesaplanır (walk testi kontrol listesi), planlanmış veya iptal edilmiş pencereler için null'dur. Tesiste Duress gerektirir. startsAtKey gerektirir.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "schedules" | "windows" | "results" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
scope | "facility" | "brand" | "organisation" | Varsayılan facility (schedules) |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. |
brandId | string | Bir tesis yerine markanın şablonu için marka kimliği (schedules) |
organisationId | string | scope organisation için (schedules, windows) |
includeCancelled | boolean | İptal edilenleri dahil et (schedules, windows) |
limit | integer | Sayfa başına öğe (varsayılan 25, en fazla 100) (schedules, windows) |
cursor | string | Önceki sayfadan nextCursor (schedules, windows) |
from | string | ISO tarih-saati (windows) |
to | string | ISO tarih-saati (windows) |
startsAtKey | string | duress_tests_read windows'tan test penceresi (startsAtKey) (results) |
duress_tests_writeDuress ConfigurationTehdit ve PanikDuress test programlarını oluşturur, değiştirir ve iptal eder; bir tesisin paylaşılan bir programı nasıl izleyeceğini belirler ve yaklaşan tek bir test penceresini iptal eder. Her değişiklik gelecekteki pencereleri oluşturur veya yeniden yazar ve paydaşlara e-posta gönderir; bu nedenle her biri onay ister.
Programlar, hedeflerinin tamamında Duress Configuration yetkisi gerektirir (organizasyon genelindeki programlar için bir organizasyon yöneticisi). Saatler her tesisin saat dilimindedir. Programları ve pencereleri önce duress_tests_read ile okuyun; hemen bir test başlatmak için duress_start_test kullanın.
Eylemler:
- create_schedule: Test programı oluşturun. target içindeki her tesiste yaklaşık bir yıl ilerisine kadar pencereler oluşturur ve rezervasyon onayı e-postası gönderir. Gerekli: name, type, target, startDate, localStartTime ve recurrence. Gerekli: name, type, target, startDate, localStartTime, recurrence. Onay ister.
- update_schedule: Bir test programını değiştirin. Gönderilmeyen alanlar değerlerini korur. Gelecekteki pencereler yeniden yazılır (başlamış olanlara dokunulmaz) ve paydaşlara değişiklik bildirimi gider. Sonrasında sonuçtaki ownerScope değerini kullanın. Gerekli: ownerScope, scheduleId. Onay ister.
- cancel_schedule: Bir test programını iptal edin. Programı ve gelecekteki pencerelerini iptal eder ve iptal e-postası gönderir. Kendi kopyası olan tesisler kopyalarını korur. Gerekli: ownerScope, scheduleId. Onay ister.
- set_facility_override: Paylaşılan bir programı tek bir tesis için değiştirin. mode follow (paylaşılan programı burada yeniden uygula), skip (burada durdur) veya own (burada schedule değerinden oluşturulan bir kopyayla değiştir). Yalnızca o tesiste Duress Configuration gerektirir. Gerekli: ownerScope, scheduleId, mode. Onay ister.
- cancel_window: Tek bir test penceresini iptal edin. Bir tesisteki planlanmış tek bir testi iptal eder (program devam eder) ve paydaşlarına e-posta gönderir. Tesiste Duress yetkisi gerektirir; etkin bir test bunun yerine duress_end_test ile sonlandırılır. Gerekli: startsAtKey. Onay ister.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
action* | "create_schedule" | "update_schedule" | "cancel_schedule" | "set_facility_override" | "cancel_window" | Yapılacak işlem; her eylem araç açıklamasında anlatılmıştır. |
name | string | E-postalarda ve takvimde gösterilir (create_schedule, update_schedule) |
type | "walk" | "comms" | "drill" | walk (her butona basılır), comms (izleme yolu başına bir basış) veya drill (prova edilmiş bir müdahale) (create_schedule, update_schedule) |
target | object | Hangi tesisler: tüm organizasyon, brandIds veya facilityIds (create_schedule, update_schedule) |
startDate | string | İlk tekrar, her tesisin saat diliminde YYYY-MM-DD (create_schedule, update_schedule) |
localStartTime | string | Her tesisin saat diliminde HH:mm (create_schedule, update_schedule) |
durationMinutes | integer | Varsayılan 60 (create_schedule, update_schedule) |
recurrence | "once" | "monthly" | "quarterly" | "twice-yearly" | "yearly" | once, monthly, quarterly, twice-yearly veya yearly (create_schedule, update_schedule) |
repeatOn | objectnull | Aynı tarih yerine ayın n'inci hafta gününde tekrarlar; null temizler (create_schedule, update_schedule) |
monitoringCentreMode | "test-codes" | "none" | test-codes sinyalleri test olarak gönderir; none izleme merkezini sürecin dışında tutar (create_schedule, update_schedule) |
extraEmails | array | Rezervasyon, hatırlatmalar ve sonuçlar bu kişilere de e-postayla gönderilir (create_schedule, update_schedule) |
organisationId | string | Varsayılan: bağlı tesisin organizasyonu (create_schedule, update_schedule, cancel_schedule, set_facility_override) |
ownerScope | string | duress_tests_read schedules sonucundan, ör. brand#b-123; hedef değiştiğinde değişebilir (update_schedule, cancel_schedule, set_facility_override) |
scheduleId | string | duress_tests_read schedules sonucundan (update_schedule, cancel_schedule, set_facility_override) |
facilityId | string | Tesis kimliği. Kastettiğiniz tesis bağlı tesisse isteğe bağlıdır. (set_facility_override, cancel_window) |
mode | "follow" | "skip" | "own" | follow, skip veya own (set_facility_override) |
schedule | object | mode own: kopyanın alanları (target her zaman bu tesistir); gönderilmeyen alanlar paylaşılan programdan alınır (set_facility_override) |
startsAtKey | string | duress_tests_read windows sonucundaki test penceresi (startsAtKey) (cancel_window) |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |
duress_unlock_doorsTehdit ve PanikBir duress alarmı için kapıların kilidini açar, ör. polisin veya ilk yardım ekibinin içeri girmesi için: basılan butona bağlı kapılar, yoksa müdahale planının kapıları. Tümü için doorIds alanını göndermeyin veya bazılarını listeleyin. Her kilit açma, olay zaman çizelgesinde ve Erişim Kayıtları'nda yer alır.
Test veya çözülmüş alarmlar için asla kullanılmaz. Tesiste Door/Gate Access gerektirir.
Önce onaylayın. Hangi kapıların açılacağını görmek için confirm olmadan çağırın, kullanıcıya bildirin ve kullanıcı kabul ettiğinde confirm: true ile yeniden çağırın.
Parametreler
| Ad | Tür | Açıklama |
|---|---|---|
incidentId* | string | duress_incidents_read list'ten veya bir Duress iş akışının tetikleyicisinden olay kimliği (inc_...). |
doorIds | array | confirm olmadan listelenen kapılardan bazıları. Tümü için göndermeyin. |
confirm | boolean | Yalnızca kullanıcı ilk çağrının döndürdüğü önizlemeyi onayladıktan sonra ayarlayın |