Rujukan
Pada halaman ini
Jadual lengkap untuk Door & Gate Access: setiap keadaan peristiwa, sebab penolakan, tetapan, nilai lalai, had dan nilai pilihan di satu tempat. Gunakan halaman ini untuk mencari maksud tepat sesuatu nilai; halaman panduan yang dipautkan menerangkan cara menggunakan setiap ciri.
Keadaan peristiwa akses
Ditunjukkan dalam Access Logs:
| Keadaan | Maksud |
|---|---|
| Request received | Permintaan buka kunci telah diterima dan sedang dinilai (sementara) |
| Pending | Permintaan lulus semakan dan sedang menunggu penghantaran (sementara) |
| Unlocked | Pembukaan kunci dilaporkan berjaya |
| Confirmed unlocked | Pengawal pintu mengesahkan geganti telah dilepaskan |
| Admin Unlocked | Pentadbir mencetuskan pembukaan kunci daripada Performance Hub (pengatasan pentadbir); dilog apabila arahan dihantar |
| Denied | Permintaan ditolak — lihat sebab penolakan pada peristiwa |
| Timed out | Arahan telah dihantar tetapi pengawal tidak mengesahkannya dalam masa yang ditetapkan |
| Failed | Pembukaan kunci tidak dapat diselesaikan disebabkan ralat |
| Locked by staff | Kakitangan menggunakan Lock now semasa jadual buka kunci automatik menahan pintu terbuka (peristiwa jadual, bukan percubaan buka kunci) |
| Schedule resumed | Jadual buka kunci automatik mengambil alih semula (peristiwa jadual, bukan percubaan buka kunci) |
Kitaran hayat peristiwa: diterima → dihantar → disahkan dibuka kunci / ditolak / tamat masa / gagal.
Sebab penolakan
Setiap pembukaan kunci yang ditolak/gagal merekodkan sebab. Jadual ini memetakan sebab kepada perkara yang dilihat oleh ahli dan cara membetulkannya:
| Sebab (seperti yang dilog) | Mesej yang dilihat oleh ahli | Punca | Pembetulan |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | Suis Access enabled pengguna dimatikan | Dayakannya semula pada panel pengguna dalam Users |
no_matching_policy_or_grant | "You don't have access to this door" | Tiada Access Policy yang sepadan dengan Who DAN Where DAN When dan tiada laluan pemberian tambahan yang membenarkan akses | Semak Access Policies, atribut pengguna, sasaran/pengecualian, jadual dan pemberian |
no_matching_policy_target | "You don't have access to this door" | Tiada Access Policy didayakan yang menyasarkan pintu ini untuk permintaan tersebut | Tambah pintu atau Access Scopenya ke dalam polisi, atau gunakan sasaran semua pintu |
no_matching_policy_audience | "You don't have access to this door" | Polisi menyasarkan pintu, tetapi tiada yang sepadan dengan jenis/status atau tag orang tersebut | Semak bahagian Who polisi dan rekod Users |
outside_policy_schedule | "Outside allowed access hours" | Who dan Where sepadan, tetapi semua jadual polisi yang sepadan tidak aktif atau telah tamat tempoh | Semak bahagian When polisi dan zon waktu kemudahan |
outside_geofence | "Move closer — you're outside the location's geofence." | Lokasi yang dilaporkan melebihi jejari + ketepatan GPS + penimbal dari pusat geofence | Ahli bergerak lebih dekat; atau semak jejari/pin geofence |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | Ketepatan GPS telefon lebih buruk daripada ambang Require GPS accuracy better than | Ahli mencuba semula di luar bangunan / jauh daripada gangguan; atau naikkan ambang |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | Telefon tidak melaporkan lokasi yang boleh digunakan | Ahli mendayakan Location (Precise) untuk aplikasi |
geofence_misconfigured | Pembukaan kunci ditolak | Geofence didayakan tetapi pusat/pinnya tiada — sistem menolak akses dalam keadaan ini | Letakkan pin geofence dalam Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | Pengawal pintu tidak melaporkan status (tiada isyarat denyutan dalam tempoh 5 minit) | Pulihkan kuasa/rangkaian kepada pengawal — lihat Penyelesaian masalah |
user_deleted | "You don't have access…" | Rekod Users telah dipadamkan | Cipta semula atau pulihkan pengguna |
outside_access_time_window | Pintu dinyahdayakan dengan ketersediaan seterusnya apabila diketahui | Tetingkap masa hadapan ialah satu-satunya laluan kebenaran berpotensi bagi pengguna dan belum aktif | Semak ketersediaan yang diberikan, zon waktu, kesegaran sumber dan pemetaan; Access Policies dan pemberian masih terpakai secara bebas |
Sesetengah versi aplikasi memaparkan mesej yang lebih umum "You don't have access to this door" atau "Outside allowed access hours" bagi penolakan khusus polisi. Access Logs mengekalkan sebab terperinci untuk pentadbir.
Dasar Akses
| Sifat | Maksud |
|---|---|
| Bentuk polisi | Nama unik, perihalan pilihan, bendera didayakan, khalayak Who, sasaran/pengecualian Where, jadual When |
| Padanan polisi | Who DAN Where DAN When |
| Berbilang polisi | ATAU; mana-mana polisi didayakan yang sepadan membenarkan |
| Who | Jenis orang serta status pilihan, ATAU tag yang disegerakkan/tersuai; status kosong = sebarang status |
| Where | Semua pintu kemudahan, Access Scopes, pintu individu atau gabungan; pengecualian diutamakan dalam polisi tersebut |
| When | Anytime, atau tetingkap Weekly/One-time yang digabungkan dengan ATAU |
| Laluan kebenaran lain | Pemberian kekal dan tetingkap pentadbir/integrasi kekal berasingan dan bersifat tambahan |
| Keselamatan | Pengguna yang dipadamkan/dinyahdayakan/disekat penyegerakan, pemadaman/sekatan pintu, penyelenggaraan, geofence, had kadar dan semakan pengawal masih terpakai |
| Konfigurasi sedia ada | Diimport secara automatik ke dalam polisi bernama yang setara dengan Who, Where dan When yang eksplisit |
Atribusi polisi
Access Logs mengenal pasti polisi yang sepadan mengikut nama dan boleh menunjukkan khalayak, sasaran dan jadualnya. Padanan berjadual juga boleh merangkumi masa mula dan tamat konkrit yang aktif.
Rujukan Access Time Window
| Sifat | Maksud |
|---|---|
| Kebenaran | Tetingkap jadual polisi ialah When polisi; tetingkap pentadbir/integrasi ialah laluan kebenaran tambahan yang berasingan |
| Sempadan mutlak | Saat integer Unix dalam UTC, [from, to) |
| Zon waktu mutlak | Metadata paparan/audit; tidak mengalihkan epoch |
| Sempadan Weekly | Blok HH:mm tempatan dengan penghujung eksklusif |
| Zon waktu Weekly | Zon waktu IANA yang sah yang menentukan hari/masa waktu dinding dan DST |
| Had Weekly | Aktif-dari/aktif-hingga dalam saat Unix pilihan; penghujung eksklusif |
| Semalaman/pertindihan | Tidak diterima; pisahkan tempoh semalaman merentasi hari dan pastikan blok tidak bertindih |
| Pemilikan pengguna | Pentadbir dan setiap sumber integrasi diasingkan; satu tidak boleh memadamkan yang lain |
| Skop integrasi | scope_key sumber yang stabil, lalai default, dipetakan kepada sasaran PH; yang tidak diketahui/tidak dipetakan tidak memberikan akses |
| Kesegaran sumber | Dikonfigurasikan mengikut kekerapan setiap integrasi; tingkah laku sumber lapuk mesti dinyatakan secara eksplisit |
| Keselamatan | Tidak pernah memintas pengguna yang dinyahdayakan/dipadamkan/berkonflik, blockAllAccess, penyelenggaraan, geofence, had kadar atau semakan pengawal |
Had awal: 50 tetingkap bagi setiap bekas polisi/pemberian/sumber; rentang mutlak maksimum 90 hari; 120 aksara untuk ID/label/kunci skop; lapan blok mingguan setiap hari; entri yang baru ditulis tidak boleh telah tamat tempoh lebih daripada satu jam.
Tetapan, nilai lalai dan julat
Tetapan pintu
| Tetapan | Lalai | Julat / pilihan |
|---|---|---|
| Masa tahan | 10 saat | 1–30 saat |
| Mod penyelenggaraan | Normal | Normal / Force open / Force closed |
| Bunyi pintu terbuka | Mati | Hidup / Mati |
| Label lokasi pintu | — | Teks bebas, maksimum 64 aksara |
| Ikon | Door | 10 pilihan (di bawah) |
| Jadual buka kunci automatik | Mati | Facility staffed hours atau Custom schedule, zon waktu kemudahan |
| Masa Unlock / Lock buka kunci automatik | At opening / At closing | At opening / At closing, atau 5, 10, 15, 30, 45, 60, 90 atau 120 minit sebelum atau selepas |
| Buka kunci automatik pada cuti umum | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| Kebenaran akses (bagi setiap pintu) | Access Policies | Menyenaraikan polisi yang sepadan dan membenarkan blockAllAccess |
| Geofence (bagi setiap pintu) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| Ambang dalam talian | — | Pengawal dikira dalam talian dengan isyarat denyutan dalam tempoh 5 minit yang lalu |
Ikon pintu
| Ikon | Kegunaan yang dimaksudkan |
|---|---|
| Door | Pintu tunggal standard (lalai) |
| Sliding door | Pintu gelangsar / automatik |
| Double door | Pintu berkembar / pintu Perancis |
| Garage | Pintu garaj / pintu gulung |
| Boom gate | Palang pagar / lengan penghadang |
| Pedestrian | Pintu masuk kakitangan / pejalan kaki |
| Security | Pintu terhad / keselamatan |
| Office | Pejabat / bilik kakitangan sahaja |
| Delivery | Dok pemunggahan / ruang penghantaran |
| Locker | Loker / storan |
Tetapan geofence
| Tetapan | Lalai | Julat |
|---|---|---|
| Geofence didayakan | Hidup (untuk konfigurasi kemudahan baharu) | Hidup / Mati |
| Jejari | 200 m | 50–5000 m (langkah 10 m; pratetap 50 / 200 / 500 / 1000 m) |
| Penimbal ketepatan | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Formula kelonggaran | — | jejari + ketepatan GPS yang dilaporkan + penimbal ketepatan |
Tempoh tangguh akses
Di bawah Settings → Access Time Windows:
| Tetapan | Pilihan |
|---|---|
| Allow early access | Mati / 5 / 10 / 15 / 30 minit |
| Allow access after end | Mati / 5 / 10 / 15 / 30 minit |
Tetapan kunci aplikasi
| Tetapan | Lalai | Pilihan |
|---|---|---|
| Enforce app lock for this facility | Mati | Hidup / Mati |
| Grace period before re-prompting | 5 minit | Always prompt / 1 min / 5 min / 15 min / 30 min / 1 jam |
| Tingkah laku berbilang kemudahan | — | Dikuatkuasakan jika mana-mana kemudahan yang dipautkan menguatkuasakannya; tempoh tangguh paling singkat antara kemudahan yang menguatkuasakannya diguna pakai |
Kenalan sokongan
| Mod | Tingkah laku |
|---|---|
| Smart (lalai) | Dipaparkan secara automatik apabila pintu luar talian atau maklumat dalam UI terhad |
| Always show | Sentiasa berada pada papan pemuka aplikasi |
| Never show | Tidak pernah dipaparkan |
Mesej aplikasi
| Medan | Had / pilihan |
|---|---|
| Jenis pemberitahuan | Information / Notice / Urgent |
| Tajuk | 120 aksara |
| Kandungan | 2000 aksara (amaran ringan pada 500) |
| URL pautan | http(s) sahaja, 2000 aksara |
| Label pautan | 80 aksara, lalai "More info" |
| Jadual | Starts at / Ends at pilihan |
| Pemegang tempat (peraturan automatik) | {firstName}, {lastName} |
| Medan padanan peraturan automatik | Membership status / Person type / Tag (tag sepadan dengan yang disegerakkan + tersuai, tidak sensitif huruf besar/kecil) / Door visibility |
| Keutamaan peraturan | Peraturan didayakan pertama yang sepadan diguna pakai (susunan senarai) |
Medan pengguna
| Medan | Had / nota |
|---|---|
| Nama pertama / akhir | 80 aksara setiap satu |
| Telefon mudah alih / e-mel | Sekurang-kurangnya satu diperlukan (digunakan untuk log masuk OTP); nombor telefon dinormalkan kepada format antarabangsa |
| Tag | 80 aksara bagi setiap tag; tag yang disegerakkan ditulis ganti oleh penyegerakan, tag tersuai dimiliki oleh pentadbir |
| Nota | 2000 aksara |
| Access enabled | Lalai hidup; mati = semua pembukaan kunci ditolak |
| Pemberian | Seluruh kemudahan, senarai pintu, senarai skop, waktu operasi pilihan |
| Access Policies | Pengguna boleh diliputi oleh satu atau lebih polisi bernama; senarai/akses berkesan menggunakan Access granted via policy |
| Access Time Windows | Tetingkap boleh edit yang dimiliki oleh pentadbir serta tetingkap baca sahaja yang dimiliki oleh sumber; berasingan daripada jadual polisi |
Sumber, status dan penghitungan lain
| Penghitungan | Nilai |
|---|---|
| Sumber pengguna | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Jubin pengguna | All users / Has access / No access / Not synced |
| Status jemputan | Not invited / Invited / Send failed |
| Penerima jemputan | Only users with door access / All eligible synced users |
| Medan peraturan jemputan | Membership status / Person type / Tag / Sync source / Integration; operator is any of / is not any of |
| Paparan Access Logs | Door events / No visit recorded |
| Penggunaan aplikasi | Active (telah menggunakan aplikasi) / Not yet active |
| Pengecam diperlukan (penyegerakan) | Email OR phone (lalai) / Email required / Phone required / Both required |
| Hasil log penyegerakan | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| Keadaan tetingkap | Active / Upcoming / Expired / Stale / Unmapped |
| Label status keahlian | Active, Current, Expired, On hold, Cancelled, Pending (serta sebarang nilai daripada sistem sumber anda) |
| Templat Access Scope | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Templat mesej automatik | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Sebab langkau penyegerakan
| Sebab yang ditunjukkan dalam log penyegerakan | Maksud |
|---|---|
| Integration sync is turned off for this facility | Togol utama sumber dimatikan |
| This integration is turned off in sync settings | Integrasi tertentu tersebut telah dikecualikan |
| No phone or email on the record (a phone or email is required to log in) | Rekod gagal memenuhi peraturan Require identifier |
| Record is decoupled and managed manually | Track source updates dimatikan untuk pengguna ini |
| No facility on the source record | Rekod sumber tidak dipautkan kepada kemudahan ini |
| No matching user record | Perubahan merujuk kepada orang yang tiada baris di sini |
Had operasi
| Had | Nilai |
|---|---|
| Import CSV | 200 pengguna bagi setiap import |
| Jemputan pukal | Dihantar dalam kelompok 50 |
| Sampel pratonton pemadaman pukal | 50 pengguna pertama ditunjukkan |
| Pertanyaan Access Logs | Sehingga 500 peristiwa terkini bagi setiap tetingkap |
| Tempoh simpanan peristiwa akses | ~13 bulan, kemudian dibuang secara automatik |
| Tempoh sah arahan buka kunci pentadbir | 30 saat (arahan tamat tempoh jika tidak dihantar) |
| Isyarat denyutan pengawal pintu | Setiap ~30 saat; luar talian selepas 5 minit tanpa isyarat |
| Permintaan kod log masuk | 5 sejam bagi setiap telefon/e-mel (had keselamatan, tidak boleh ditarik balik) |
| Penyebaran log keluar aplikasi | Dibatalkan serta-merta; sehingga 15 minit untuk sesi aktif tamat sepenuhnya |
| Menyimpan tetapan pintu | Memuatkan semula pengawal — biasanya 10–15 saat |
| Tempoh simpanan No visit recorded | ~13 bulan |
| Pemetaan Access Time Window | 50 bagi setiap integrasi |
| Access Time Windows bagi setiap bekas | 50 |
| Rentang tetingkap One-time | 90 hari |
| Blok Weekly | 8 bagi setiap hari dalam minggu |
| ID tetingkap/sumber, label, kunci skop | 120 aksara |
| Access Policies bagi setiap kemudahan | 100 |
| Jumlah tetingkap polisi | 500 |
| Nama/ID Access Policy | 120 aksara |
| Perihalan Access Policy | 500 aksara |
| Konfigurasi Access Policy | 300 KiB UTF-8 |