Kecemasan
Platform Terasduress_acknowledge_incidentKecemasanMengakui insiden duress yang terbuka bagi pihak pengguna: ia merekodkan bahawa mereka sedang bertindak balas dan boleh menghentikan peningkatan selanjutnya. Hanya insiden terbuka boleh diakui.
Sentiasa sahkan dahulu. Panggil tanpa confirm untuk mendapatkan insiden, beritahu pengguna perkara yang mereka akui, dan panggil semula dengan confirm: true hanya selepas mereka bersetuju.
Dalam aliran kerja, atau daripada Ejen, ini hanya berfungsi jika pelan tindak balas kemudahan membenarkan aliran kerja mengakui, menyelesaikan dan mencetuskan penggera. Untuk menutup insiden, gunakan duress_resolve_incident.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
incidentId* | string | ID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. |
note | string | Nota pilihan, cth. "Dalam perjalanan ke kaunter penyambut tetamu" |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_end_testKecemasanMenamatkan ujian duress yang sedang berjalan di sesebuah kemudahan serta-merta, supaya tekanan seterusnya ialah penggera sebenar. Keputusan menyusul kira-kira 10 minit kemudian, seperti mana-mana ujian lain.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
facilityId | string | ID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. |
duress_incidents_readKecemasanMembaca insiden penggera duress (kakitangan menekan butang duress, atau aliran kerja mencetuskannya): senarai, garis masa dan penghantaran satu insiden, laporan postmortem, dan rakaman CCTV sekitar penggera.
Status: open (belum ada sesiapa yang mengakuinya), acknowledged (seseorang sedang bertindak balas), resolved (ditutup, dengan disposisi: genuine, false_alarm, test atau unknown). active bermaksud open atau acknowledged. Insiden ujian (isTest) datang daripada ujian butang; testType 'unplanned' ialah penggera yang dicetuskan sebagai sebenar tetapi diselesaikan oleh responden sebagai ujian.
Status penghantaran: sent, acknowledged (penerima mengesahkan), failed (lihat error), shadow (larian percubaan, tiada apa-apa dihantar). Penghantaran ke pusat pemantauan turut dijumlahkan di bawah monitoringCentre. Keputusan menamakan orang tetapi tidak pernah menyertakan nombor telefon atau alamat e-mel. Masa dalam format ISO.
Tindakan:
- list: Senaraikan insiden. Terbaharu dahulu. scope: facility (lalai; kemudahan yang diberikan atau disambungkan) atau organisation (setiap kemudahan di dalamnya yang boleh Anda lihat; lalai kepada organisasi kemudahan tersebut).
- get: Dapatkan insiden. Status, butang yang ditekan, garis masa (tekanan, peningkatan, pengakuan, nota) dan setiap percubaan penghantaran pemberitahuan atau ke pusat pemantauan bersama hasilnya. Memerlukan incidentId.
- report: Laporan insiden. Untuk postmortem: insiden, saat untuk mengakui dan menyelesaikan, langkah yang dicapai, setiap entri garis masa, perkara yang dihantar bagi setiap saluran dan yang gagal, serta sama ada rakaman disimpan. Gandingkan dengan duress_incidents_write add_note untuk meletakkan postmortem pada insiden. Memerlukan incidentId.
- footage_previews: Rakaman penggera. Setiap kamera dalam rakaman penggera: statusnya, bilangan bingkai dan klip, klip yang dimuat naik, dan bingkai yang paling hampir dengan tekanan (posterSeconds). Dengan cameraId, kamera itu sahaja serta saat Unix setiap bingkai (frameSeconds). Memerlukan CCTV di kemudahan tersebut. Memerlukan incidentId.
- footage_frame: Bingkai rakaman penggera. Satu bingkai timelapse daripada rakaman penggera, dikembalikan sebagai imej: salinan yang disimpan setelah rakaman disimpan, jika tidak bingkai langsung dalam tetingkap penggera. seconds ialah nilai posterSeconds atau frameSeconds daripada footage_previews. Memerlukan incidentId, cameraId, seconds.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
action* | "list" | "get" | "report" | "footage_previews" | "footage_frame" | Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat. |
scope | "facility" | "organisation" | Lalai facility (list) |
facilityId | string | ID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. (list) |
organisationId | string | Untuk scope organisation. Lalai kepada organisasi kemudahan tersebut. (list) |
status | "active" | "open" | "acknowledged" | "resolved" | active ialah open atau acknowledged (list) |
from | string | Tarikh-masa ISO: insiden yang dibuka pada atau selepas masa ini (list) |
to | string | Tarikh-masa ISO: insiden yang dibuka pada atau sebelum masa ini (list) |
limit | integer | Item setiap halaman (lalai 25, maksimum 100) (list) |
cursor | string | nextCursor daripada halaman sebelumnya (list) |
incidentId | string | ID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. (get, report, footage_previews, footage_frame) |
cameraId | string | Kamera dalam rakaman penggera, daripada footage_previews (footage_previews, footage_frame) |
seconds | integerstring | Masa bingkai sebagai saat Unix 10 digit (footage_frame) |
duress_incidents_writeKecemasanDuress ConfigurationMengubah insiden duress tanpa menyentuh penggera itu sendiri: menamakannya, menambah nota kakitangan, dan menyimpan atau melepaskan rakaman CCTV sekitarnya. Tiada sesiapa yang dimaklumkan. Untuk mengakui, menyelesaikan atau memaklumkan responden, gunakan duress_acknowledge_incident, duress_resolve_incident atau duress_post_update.
Tindakan:
- rename: Namakan insiden. Menamakan insiden supaya mudah dicari kemudian, cth. "Pelawat agresif di kaunter hadapan". Nama kosong atau null mengalih keluarnya. Nama dipaparkan dalam konsol Duress dan laporan. Memerlukan incidentId.
- add_note: Tambah nota. Menambah nota pada garis masa insiden, cth. perkara yang ditemui pengguna atau siapa yang hadir. Sebarang status; hanya kakitangan yang melihat nota dan nota tidak mengubah insiden. Tulis menggunakan perkataan pengguna dan sahkan susunan katanya dengan mereka terlebih dahulu. Memerlukan incidentId, note.
- keep_footage: Simpan rakaman penggera. Menyimpan rakaman CCTV sekitar penggera sebenar yang telah diselesaikan supaya tidak dipadamkan bersama rakaman biasa, menggunakan minit dan kamera pelan tindak balas. Berlaku beberapa minit kemudian, setelah dimuat naik. Bukan untuk ujian, penggera terbuka, atau rakaman yang sudah disimpan atau dilepaskan. Memerlukan incidentId.
- release_footage: Lepaskan rakaman yang disimpan. Melepaskan rakaman yang disimpan untuk sesuatu penggera: klip kembali kepada pengekalan biasa dan bingkai yang disimpan dipadamkan, jadi rakaman tidak lagi boleh dilihat setelah rakaman biasa tamat tempoh. Memerlukan Duress Configuration di kemudahan tersebut. Memerlukan incidentId. Meminta pengesahan.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
action* | "rename" | "add_note" | "keep_footage" | "release_footage" | Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat. |
incidentId | string | ID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. |
name | stringnull | Nama; kosong atau null mengalih keluarnya (rename) |
note | string | Nota (add_note) |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_lift_lockdownKecemasanMenarik balik sekatan (lockdown) penggera duress: pintu yang dikuncinya membenarkan orang masuk semula. Berfungsi tanpa mengira status penggera.
Sahkan dahulu. Panggil tanpa confirm untuk melihat sekatan, beritahu pengguna, dan panggil semula dengan confirm: true setelah mereka bersetuju.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
incidentId* | string | ID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_post_updateKecemasanMenyiarkan kemas kini kepada orang yang bertindak balas terhadap penggera duress, cth. "Polis sedang dalam perjalanan" atau "Keadaan selamat, orang tersebut telah beredar". Kemas kini dipaparkan pada halaman penggera mereka dan dalam aplikasi Duress, dan bagi penggera sebenar, pelan tindak balas juga boleh menghantarnya melalui SMS kepada semua orang yang telah menerima SMS tentang penggera itu. Kemas kini boleh disiarkan sehingga 24 jam selepas penggera diselesaikan.
Sahkan dahulu. Panggil tanpa confirm untuk menyemak insiden, tunjukkan susunan kata yang tepat kepada pengguna, dan panggil semula dengan confirm: true setelah mereka bersetuju. Untuk perkara yang hanya patut dilihat oleh kakitangan, gunakan duress_incidents_write add_note.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
incidentId* | string | ID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. |
text* | string | Kemas kini, kata demi kata |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_raise_alarmKecemasanMencetuskan penggera duress sebenar di kemudahan, seolah-olah butang ditekan: pelan tindak balas dijalankan (orang dimaklumkan, peningkatan dan peringatan menyusul, tindakan tindak balas dijalankan) dan penggera menyatakan bahawa ia dicetuskan oleh aliran kerja ini, bersama sebabnya.
- reason: perkara yang berlaku, cth. "Pintu dibuka secara paksa di pintu keluar belakang" (sehingga 200 aksara).
- deviceSerialNumber: pilihan. Butang yang lokasinya hendak digunakan; hanya dalam kes ini pusat pemantauan turut dimaklumkan, dengan zon butang tersebut.
Hanya sebagai langkah aliran kerja, di kemudahan yang pelan tindak balasnya membenarkan aliran kerja mengakui, menyelesaikan dan mencetuskan penggera. Selagi penggera aliran kerja ini terbuka, ia tidak akan mencetuskan penggera lain; sebaliknya ia mengembalikan penggera tersebut.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
facilityId | string | ID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. |
reason* | string | Perkara yang berlaku |
deviceSerialNumber | string | Butang di kemudahan (pilihan) |
duress_reports_readKecemasanDuress ConfigurationLaporan pematuhan Duress bagi kemudahan, jenama atau organisasi: masa tindak balas (P50/P95), insiden mengikut disposisi dan kadar penggera palsu, liputan ujian dan kemudahan yang tertunggak, masa operasi butang, kejayaan penghantaran ke pusat pemantauan, dan eksport insiden demi insiden. Serta amaran penggera terkini yang tidak dihantar di satu kemudahan.
Hari mengikut waktu tempatan kemudahan; tempoh melebihi 400 hari dipendekkan (range.capped). Insiden sebenar dan ujian dikira secara berasingan. Tempoh dalam ms (p50Ms, p95Ms). Laporan jenama hanya meliputi kemudahan yang boleh Anda akses melainkan Anda mempunyai akses seluruh organisasi (scope.restrictedToAccessibleFacilities).
Tindakan:
- overview: Gambaran keseluruhan laporan Duress. Jumlah, trend bulanan dan metrik bagi setiap organisasi, jenama dan kemudahan (incidents, testCoverage, deviceUptime, deliveries). Kemudahan dipaparkan berhalaman.
- compliance_summary: Ringkasan pematuhan Duress. Perkara yang dipaparkan dalam PDF pematuhan: liputan ujian dengan kemudahan yang tertunggak, masa operasi butang, kejayaan penghantaran, ujian terkini (testHistory), dan bagi setiap kemudahan, ujian, latih tubi dan penggera sebenar terakhirnya bersama masa operasi setiap butang. Kemudahan dipaparkan berhalaman.
- incident_export: Eksport insiden Duress. Satu baris bagi setiap insiden, terlama dahulu, dengan lajur eksport CSV: kemudahan, ujian atau sebenar, status, disposisi, waktu tempatan, saat untuk mengakui dan menyelesaikan, siapa yang mengakui dan menyelesaikan, butang dan bilangan penghantaran.
- delivery_problems: Amaran penggera yang tidak dihantar. Penggera atau ujian terkini kemudahan (dengan keseluruhan tetingkap ujiannya) dan amaran yang tidak pernah sampai, mengikut saluran. problems bernilai null apabila semuanya berjaya dihantar. Memerlukan Duress atau Duress Configuration di sana.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
action* | "overview" | "compliance_summary" | "incident_export" | "delivery_problems" | Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat. |
scope | "facility" | "brand" | "organisation" | Lalai: id paling khusus yang diberikan, jika tidak kemudahan yang disambungkan. (overview, compliance_summary, incident_export) |
facilityId | string | ID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. |
brandId | string | ID jenama, untuk templat jenama dan bukannya kemudahan (overview, compliance_summary, incident_export) |
organisationId | string | Memerlukan akses Duress seluruh organisasi (overview, compliance_summary, incident_export) |
from | string | Hari pertama, YYYY-MM-DD waktu tempatan kemudahan (lalai 30 hari sebelum to) (overview, compliance_summary, incident_export) |
to | string | Hari terakhir, YYYY-MM-DD waktu tempatan kemudahan, termasuk (lalai hari ini) (overview, compliance_summary, incident_export) |
limit | integer | Item setiap halaman (lalai 25, maksimum 100) (overview, compliance_summary, incident_export) |
cursor | string | nextCursor daripada halaman sebelumnya (overview, compliance_summary, incident_export) |
duress_resolve_incidentKecemasanMenyelesaikan insiden duress: menutup penggera, menghentikan peningkatan dan merekodkan hasilnya. Insiden yang terbuka dan telah diakui boleh diselesaikan.
- disposition:
genuine(kecemasan sebenar),false_alarm,testatauunknown. - note: perkara yang berlaku. Wajib bagi penggera sebenar.
Sentiasa sahkan dahulu. Panggil tanpa confirm untuk mendapatkan insiden, beritahu pengguna penggera mana yang mereka tutup dan hasilnya, dan panggil semula dengan confirm: true hanya selepas mereka bersetuju.
Dalam aliran kerja, atau daripada Ejen, ini hanya berfungsi jika pelan tindak balas kemudahan membenarkan aliran kerja mengakui, menyelesaikan dan mencetuskan penggera.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
incidentId* | string | ID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. |
disposition* | "genuine" | "false_alarm" | "test" | "unknown" | Hasil |
note | string | Perkara yang berlaku. Wajib apabila disposisi ialah genuine. |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_settings_readKecemasanDuress ConfigurationMembaca tetapan Duress: pelan tindak balas (siapa yang dimaklumkan, dalam urutan apa dan bagaimana, di kemudahan atau sebagai templat jenama), pelan diselesaikan yang sebenarnya digunakan oleh enjin penggera, orang dan peranan yang boleh ditambah, amaran peranti (masalah bateri, luar talian, liputan dan penghantaran), peraturan kenalan jenama dan status pelan, gambaran keseluruhan butang jenama atau organisasi, dan destinasi penggera ke pusat pemantauan.
Kemudahan mengikut templat jenamanya (jika tidak, templat organisasinya), melanjutkannya dengan kenalan tambahan (mode extend), atau menggantikannya dengan pelannya sendiri (mode replace). Ubah tetapan dengan duress_settings_write. Masa dalam format ISO.
Tindakan:
- response_plan: Pelan tindak balas. Pelan yang berkuat kuasa di kemudahan (effective) dan kandungan setiap peringkat (sources: facility, brand, organisation), atau dengan brandId sahaja, templat jenama. Kenalan adalah seperti yang disimpan, sedia untuk diedit dan disimpan semula.
- resolved_plan: Pelan diselesaikan. Siapa yang dihubungi oleh enjin penggera di kemudahan, peringkat demi peringkat: peranan dikembangkan kepada orang, saluran yang boleh digunakan untuk menghubungi setiap orang, kelewatan, dan amaran yang perlu dibaiki sebelum penggera. Nama sahaja, tiada nombor telefon atau e-mel.
- contact_options: Pilihan kenalan. Orang dan peranan yang boleh ditambah kepada pelan kemudahan (memerlukan Duress Configuration di sana), atau dengan brandId sahaja, kepada templat jenama, selepas peraturan kenalan jenama.
- device_alerts: Amaran peranti. Siapa yang dimaklumkan tentang bateri lemah, butang luar talian, liputan yang hilang dan penghantaran yang gagal: peraturan di setiap peringkat dan penerima diselesaikan kemudahan, atau dengan brandId sahaja, peraturan jenama.
- contact_rules: Peraturan kenalan jenama. Peranan yang boleh ditambah kepada pelan oleh kemudahan dalam jenama: allowAllExcept menyembunyikan peranan yang disenaraikan, manual hanya menawarkan peranan tersebut. Memerlukan keperluan yang sama seperti mengedit pelan jenama. Memerlukan brandId.
- plan_status: Status pelan jenama. Setiap kemudahan dalam jenama: sama ada ia mengikut templat, melanjutkannya atau mempunyai pelannya sendiri, bilangan kenalan yang ditambahnya, dan amaran pelannya. Memerlukan brandId.
- buttons_summary: Gambaran keseluruhan butang. Setiap kemudahan dalam jenama atau organisasi: butang, bilangan bateri dan luar talian, ujian seterusnya dan terakhir. Data gambaran keseluruhan Brands & Customisation dan organisasi.
- monitoring: Penghalaan pusat pemantauan. Cara penggera keluar dari kemudahan: eaAlarmType none, cid (panggilan pusat pemantauan melalui eaAlarmProvider) atau relay (panel berwayar melalui eaRelayModel), dan pembekal yang boleh digunakannya.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
action* | "response_plan" | "resolved_plan" | "contact_options" | "device_alerts" | "contact_rules" | "plan_status" | "buttons_summary" | "monitoring" | Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat. |
facilityId | string | ID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. (response_plan, resolved_plan, contact_options, device_alerts, monitoring) |
brandId | string | ID jenama, untuk templat jenama dan bukannya kemudahan (response_plan, contact_options, device_alerts, contact_rules, plan_status, buttons_summary) |
organisationId | string | ID organisasi (buttons_summary) |
duress_settings_writeDuress ConfigurationMengubah tetapan Duress: pelan tindak balas (di kemudahan, atau templat jenama atau organisasi), amaran peranti, peraturan kenalan jenama, dan destinasi penggera ke pusat pemantauan. Setiap perubahan meminta pengesahan kerana ia mengubah siapa yang dimaklumkan.
Hantar salah satu daripada facilityId (lalai: kemudahan yang disambungkan), brandId atau organisationId. Pelan kemudahan memerlukan Duress Configuration di sana; templat memerlukan pentadbir organisasi dengan Duress Configuration, atau bagi jenama, Duress Configuration di setiap kemudahan di dalamnya. Baca dahulu dengan duress_settings_read.
Tindakan:
- save_response_plan: Simpan pelan tindak balas. Peringkat kenalan yang dimaklumkan afterSeconds selepas tekanan (menaik, yang pertama biasanya 0), ackRequired, reminders dan responseActions. Kemudahan boleh sebaliknya melanjutkan templatnya (mode extend) dengan tambahan. Medan yang ditinggalkan mengekalkan nilai yang disimpan; responseActions digabungkan mengikut tindakan. Meminta pengesahan.
- remove_response_plan: Alih keluar pelan tindak balas. Memadamkan pelan yang disimpan di peringkat ini, supaya kemudahan kembali mengikut templatnya dan jenama kembali kepada templat organisasi. Meminta pengesahan.
- save_device_alerts: Simpan amaran peranti. Menggantikan peraturan amaran peranti di peringkat ini: sehingga 10 peraturan, setiap satu ialah set peristiwa dan kenalan (push, sms atau email). Kekalkan id peraturan yang dibaca daripada duress_settings_read device_alerts. Memerlukan rules. Meminta pengesahan.
- remove_device_alerts: Alih keluar amaran peranti. Memadamkan peraturan amaran peranti di peringkat ini, supaya ia kembali mengikut peringkat di atasnya. Meminta pengesahan.
- save_contact_rules: Simpan peraturan kenalan jenama. Peranan yang boleh ditambah kepada pelan oleh kemudahan jenama: allowAllExcept menyembunyikan roleIds, manual hanya menawarkan roleIds. Kenalan yang sudah disimpan kekal; pelan diselesaikan dimuat semula. Memerlukan brandId, mode, roleIds. Meminta pengesahan.
- save_monitoring: Simpan penghalaan pusat pemantauan. Destinasi penggera: eaAlarmType none, cid (memerlukan eaAlarmProvider, salah satu pembekal yang disenaraikan oleh duress_settings_read monitoring) atau relay (eaRelayModel). Memerlukan Duress Configuration di kemudahan tersebut. Memerlukan eaAlarmType. Meminta pengesahan.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
action* | "save_response_plan" | "remove_response_plan" | "save_device_alerts" | "remove_device_alerts" | "save_contact_rules" | "save_monitoring" | Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat. |
facilityId | string | ID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_monitoring) |
brandId | string | ID jenama, untuk templat jenama dan bukannya kemudahan (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts, save_contact_rules) |
organisationId | string | ID organisasi, untuk templat organisasi (save_response_plan, remove_response_plan, save_device_alerts, remove_device_alerts) |
mode | "replace" | "extend" | Pelan kemudahan sahaja: replace (peringkatnya sendiri) atau extend (tambahan kepada templat) (save_response_plan, save_contact_rules) |
tiers | array | Peringkat pelan (mode replace dan templat) (save_response_plan) |
additions | array | Mode extend: kenalan tambahan bagi setiap peringkat templat (tierId dan afterSeconds daripadanya) (save_response_plan) |
ackRequired | boolean | Sama ada peningkatan diteruskan sehingga seseorang mengakuinya (save_response_plan) |
reminders | objectnull | Ulang amaran setiap everySeconds (0 mematikannya) sehingga stopAfterSeconds (save_response_plan) |
responseActions | object | Tindakan mengikut nama, setiap satu { enabled, ... }: unlockOnAcknowledge (doorIds), lockdown, staffScreenAlerts, buttonAcknowledge, dashboardCctv, dashboardDoorControls, dashboardResolve, updateTexts, aiSummary, workflowControl, retainFootage (minutesBefore, minutesAfter, cameras) (save_response_plan) |
rules | array | Peraturan; senarai kosong tidak menyimpan apa-apa (tiada sesiapa dimaklumkan di sini) (save_device_alerts) |
roleIds | array | Id peranan yang terpakai bagi mode (save_contact_rules) |
eaAlarmType | "none" | "cid" | "relay" | none, cid atau relay (save_monitoring) |
eaAlarmProvider | stringnull | Untuk cid: kod pembekal (save_monitoring) |
eaRelayModel | "none" | "numato-rl80001" | Untuk relay: papan geganti (save_monitoring) |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_start_lockdownKecemasanMengenakan sekatan (lockdown) di kemudahan untuk penggera duress: setiap pintu berhenti membenarkan orang masuk sehingga sekatan ditarik balik (duress_lift_lockdown, atau dari konsol). Sesuatu penggera hanya boleh mempunyai satu sekatan.
Tidak sekali-kali untuk penggera ujian atau yang telah diselesaikan. Memerlukan Door/Gate Access di kemudahan tersebut.
Sahkan dahulu. Panggil tanpa confirm untuk menyemak insiden, beritahu pengguna bahawa setiap pintu akan dikunci, dan panggil semula dengan confirm: true setelah mereka bersetuju.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
incidentId* | string | ID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_start_testKecemasanMemulakan ujian duress di sesebuah kemudahan serta-merta. Sehingga ujian tamat, setiap tekanan ialah ujian, bukan penggera sebenar:
walk: kakitangan menekan setiap butang; hanya langkah pertama pelan tindak balas dimaklumkan, dilabelkan TEST.drill: keseluruhan pelan tindak balas dijalankan, dilabelkan TEST.
Kenalan ujian kemudahan dimaklumkan bahawa ujian telah bermula dan menerima keputusan kira-kira 10 minit selepas ujian tamat. Satu ujian pada satu masa bagi setiap kemudahan. Tamatkan lebih awal dengan duress_end_test; tempah ujian lebih awal dengan duress_tests_write.
Sahkan dahulu. Panggil tanpa confirm, beritahu pengguna bahawa tekanan tidak akan mencetuskan penggera sebenar selama durationMinutes, dan panggil semula dengan confirm: true setelah mereka bersetuju. Dalam aliran kerja, atau daripada Ejen, ini hanya berfungsi jika pelan tindak balas kemudahan membenarkan aliran kerja mengakui, menyelesaikan dan mencetuskan penggera.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
facilityId | string | ID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. |
type | "walk" | "drill" | walk (lalai) atau drill |
durationMinutes | integer | Tempoh tekanan dikira sebagai ujian (lalai 60) |
monitoringCentreMode | "test-codes" | "none" | `test-codes` menghantar isyarat ujian ke pusat pemantauan; `none` tidak menghantar apa-apa kepadanya |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_tests_readKecemasanDuress ConfigurationMembaca ujian butang duress: jadual yang menempahnya (walk, comms atau drill, sekali atau berulang, bagi organisasi, jenama atau kemudahan), tetingkap ujian yang diciptanya di setiap kemudahan (scheduled, active, completed, cancelled, serta ujian ad hoc), dan keputusan sesuatu tetingkap (butang yang ditekan atau terlepas, siapa yang dimaklumkan, isyarat pusat pemantauan, masa pengakuan).
Siapa yang menempah, mengubah atau membatalkan ujian tidak disertakan; penerima penghantaran disunting. Masa dalam format ISO; localDate dan localStartTime dalam zon waktu kemudahan. Tempah atau ubah ujian dengan duress_tests_write; mulakan ujian serta-merta dengan duress_start_test.
Tindakan:
- schedules: Jadual ujian. scope facility (lalai; setiap jadual yang meliputinya, termasuk jadual dikongsi yang dilangkau atau digantikannya), brand (brandId) atau organisation (lalai: organisasi kemudahan tersebut). Perubahan terbaharu dahulu.
- windows: Tetingkap ujian. Tetingkap ujian kemudahan dari
fromhinggato(lalai kira-kira seminggu ke belakang hingga sebulan ke hadapan), atau dengan organisationId sahaja, tetingkap akan datang organisasi merentas kemudahannya. - results: Keputusan ujian. Tetingkap dan keputusannya: disimpan setelah dihantar, dikira secara langsung semasa ujian berjalan (senarai semak ujian walk), null bagi tetingkap yang dijadualkan atau dibatalkan. Memerlukan Duress di kemudahan tersebut. Memerlukan startsAtKey.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
action* | "schedules" | "windows" | "results" | Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat. |
scope | "facility" | "brand" | "organisation" | Lalai facility (schedules) |
facilityId | string | ID kemudahan. Pilihan jika kemudahan yang disambungkan ialah kemudahan yang Anda maksudkan. |
brandId | string | ID jenama, untuk templat jenama dan bukannya kemudahan (schedules) |
organisationId | string | Untuk scope organisation (schedules, windows) |
includeCancelled | boolean | Sertakan yang dibatalkan (schedules, windows) |
limit | integer | Item setiap halaman (lalai 25, maksimum 100) (schedules, windows) |
cursor | string | nextCursor daripada halaman sebelumnya (schedules, windows) |
from | string | Tarikh-masa ISO (windows) |
to | string | Tarikh-masa ISO (windows) |
startsAtKey | string | Tetingkap ujian (startsAtKey), daripada duress_tests_read windows (results) |
duress_tests_writeDuress ConfigurationKecemasanMenempah, mengubah dan membatalkan jadual ujian duress, menetapkan cara satu kemudahan mengikuti jadual yang dikongsi, dan membatalkan satu tetingkap ujian yang akan datang. Setiap perubahan menempah atau menulis semula tetingkap akan datang dan menghantar e-mel kepada pihak berkepentingan, jadi setiap satu meminta pengesahan.
Jadual memerlukan Duress Configuration ke atas keseluruhan sasarannya (pentadbir organisasi bagi jadual seluruh organisasi). Masa adalah dalam zon waktu setiap kemudahan. Baca jadual dan tetingkap dahulu dengan duress_tests_read; mulakan ujian sekarang dengan duress_start_test.
Tindakan:
- create_schedule: Tempah jadual ujian. Menempah tetingkap sehingga kira-kira setahun ke hadapan di setiap kemudahan dalam target dan menghantar e-mel pengesahan tempahan. Memerlukan name, type, target, startDate, localStartTime dan recurrence. Memerlukan name, type, target, startDate, localStartTime, recurrence. Meminta pengesahan.
- update_schedule: Ubah jadual ujian. Medan yang tidak dihantar mengekalkan nilainya. Tetingkap akan datang ditulis semula (yang telah bermula dibiarkan) dan pihak berkepentingan menerima notis perubahan. Gunakan ownerScope dalam hasil selepas itu. Memerlukan ownerScope, scheduleId. Meminta pengesahan.
- cancel_schedule: Batalkan jadual ujian. Membatalkan jadual dan tetingkap akan datangnya, serta menghantar e-mel pembatalan. Kemudahan yang mempunyai salinan sendiri mengekalkannya. Memerlukan ownerScope, scheduleId. Meminta pengesahan.
- set_facility_override: Ubah jadual dikongsi untuk satu kemudahan. mode follow (jalankan semula jadual dikongsi di sini), skip (hentikannya di sini) atau own (gantikannya di sini dengan salinan yang dibina daripada schedule). Memerlukan Duress Configuration di kemudahan itu sahaja. Memerlukan ownerScope, scheduleId, mode. Meminta pengesahan.
- cancel_window: Batalkan satu tetingkap ujian. Membatalkan satu ujian berjadual di sesebuah kemudahan (jadual diteruskan) dan menghantar e-mel kepada pihak berkepentingannya. Memerlukan Duress di kemudahan itu; ujian yang sedang aktif ditamatkan dengan duress_end_test sebaliknya. Memerlukan startsAtKey. Meminta pengesahan.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
action* | "create_schedule" | "update_schedule" | "cancel_schedule" | "set_facility_override" | "cancel_window" | Perkara yang hendak dilakukan; setiap tindakan diterangkan dalam penerangan alat. |
name | string | Dipaparkan dalam e-mel dan kalendar (create_schedule, update_schedule) |
type | "walk" | "comms" | "drill" | walk (tekan setiap butang), comms (satu tekanan bagi setiap laluan pemantauan) atau drill (respons yang dilatih) (create_schedule, update_schedule) |
target | object | Kemudahan yang terlibat: seluruh organisasi, brandIds atau facilityIds (create_schedule, update_schedule) |
startDate | string | Kejadian pertama, YYYY-MM-DD dalam zon waktu setiap kemudahan (create_schedule, update_schedule) |
localStartTime | string | HH:mm dalam zon waktu setiap kemudahan (create_schedule, update_schedule) |
durationMinutes | integer | Lalai 60 (create_schedule, update_schedule) |
recurrence | "once" | "monthly" | "quarterly" | "twice-yearly" | "yearly" | once, monthly, quarterly, twice-yearly atau yearly (create_schedule, update_schedule) |
repeatOn | objectnull | Ulang pada hari bekerja ke-n dalam bulan itu dan bukannya pada tarikh yang sama; null mengosongkannya (create_schedule, update_schedule) |
monitoringCentreMode | "test-codes" | "none" | test-codes menghantar isyarat sebagai ujian; none tidak melibatkan pusat pemantauan (create_schedule, update_schedule) |
extraEmails | array | Turut menerima e-mel tempahan, peringatan dan keputusan (create_schedule, update_schedule) |
organisationId | string | Lalai: organisasi kemudahan yang disambungkan (create_schedule, update_schedule, cancel_schedule, set_facility_override) |
ownerScope | string | Daripada jadual duress_tests_read, cth. brand#b-123; ia boleh berubah apabila sasaran berubah (update_schedule, cancel_schedule, set_facility_override) |
scheduleId | string | Daripada jadual duress_tests_read (update_schedule, cancel_schedule, set_facility_override) |
facilityId | string | ID kemudahan. Pilihan apabila kemudahan yang disambungkan ialah kemudahan yang anda maksudkan. (set_facility_override, cancel_window) |
mode | "follow" | "skip" | "own" | follow, skip atau own (set_facility_override) |
schedule | object | mode own: medan salinan (target sentiasa kemudahan ini); medan yang tidak dihantar diambil daripada jadual dikongsi (set_facility_override) |
startsAtKey | string | Tetingkap ujian (startsAtKey), daripada tetingkap duress_tests_read (cancel_window) |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |
duress_unlock_doorsKecemasanMembuka kunci pintu untuk penggera duress, cth. untuk membenarkan polis atau pasukan pertolongan cemas masuk: pintu yang dipautkan kepada butang yang ditekan, atau pintu pelan respons. Tinggalkan doorIds untuk semua pintu, atau senaraikan sebahagian daripadanya. Setiap buka kunci direkodkan dalam garis masa insiden dan dalam Access Logs.
Tidak sekali-kali untuk penggera ujian atau penggera yang telah diselesaikan. Memerlukan Door/Gate Access di kemudahan itu.
Sahkan dahulu. Panggil tanpa confirm untuk melihat pintu yang akan dibuka kuncinya, maklumkan kepada pengguna, dan panggil semula dengan confirm: true setelah mereka bersetuju.
Parameter
| Nama | Jenis | Penerangan |
|---|---|---|
incidentId* | string | ID insiden (inc_...), daripada duress_incidents_read list atau pencetus aliran kerja Duress. |
doorIds | array | Sebahagian daripada pintu yang disenaraikan tanpa confirm. Tinggalkan untuk semua pintu. |
confirm | boolean | Tetapkan hanya selepas pengguna mengesahkan pratonton yang dikembalikan oleh panggilan pertama |