Penyelesaian masalah

Pembetulan berdasarkan simptom bagi isu Door & Gate Access yang paling biasa. Setiap entri mengikut simptom → punca → penyelesaian. Untuk maksud sebarang keadaan atau sebab penolakan, lihat Rujukan; untuk logik keputusan asas, lihat Cara keputusan akses dibuat.

Mulakan dengan Access Logs. Hampir setiap laporan "tidak dapat masuk" mempunyai peristiwa ditolak dalam Access Logs dengan sebab yang tepat. Cari nama ahli, lihat peristiwa ditolak yang terkini dan pergi ke bahagian yang sepadan di bawah.

Pintu menunjukkan Luar talian

Simptom: Kad pintu menunjukkan Luar talian, ahli melihat "Door offline", pembukaan kunci tidak dapat dihantar.

Punca: Pengawal pintu tidak melapor masuk selama lebih daripada 5 minit — kuasa atau rangkaian terputus di peranti.

Penyelesaian:

1. Semak bahawa pengawal mempunyai kuasa dan sambungan rangkaiannya (kabel Ethernet / Wi-Fi) — halaman Penyelesaian Masalah Perkakasan merangkumi semakan di lokasi (LED penunjuk, pemisah PoE, pengkabelan, SIM/antena pada model 4G).
2. Buka panel pintu → tab Overview untuk melihat Status (kali terakhir dilihat), IP address dan masa operasi — "kali terakhir dilihat" yang baru-baru ini menunjukkan rangkaian yang terputus-putus dan bukannya peranti yang mati.
3. Matikan dan hidupkan semula pengawal jika perlu.
4. Untuk diagnostik yang lebih mendalam, ikuti Open in Device Management for advanced configuration.
5. Jika beberapa pintu menjadi luar talian serentak, syaki rangkaian/internet lokasi dan bukannya peranti.

Semasa pintu luar talian, ahli melihat butiran hubungan sokongan pada papan pemuka mereka (dalam mod Smart lalai), supaya mereka boleh menghubungi anda.

Ahli ditolak — "You don't have access to this door"

Simptom: Peristiwa ditolak dengan sebab no_matching_policy_or_grant.

Punca: Tiada laluan tambahan yang membenarkan mereka: tiada Access Policy yang didayakan sepadan dengan Who DAN Where DAN When, dan tiada pemberian kekal atau tetingkap pentadbir/integrasi yang aktif meliputi pintu tersebut.

Penyelesaian:

1. Buka ahli dalam Users dan bandingkan jenis orang, status keahlian dan tag disegerakkan/tersuai dengan Who polisi.
2. Semak bahawa Where merangkumi pintu tersebut secara langsung, melalui Access Scope, atau melalui semua pintu kemudahan, dan tiada pengecualian yang mengalih keluarnya.
3. Semak When: Anytime, atau sekurang-kurangnya satu tetingkap Weekly/One-time yang aktif. Masa tamat adalah eksklusif.
4. Ingat bahawa polisi digabungkan secara ATAU, tetapi setiap polisi memerlukan Who DAN Where DAN When. Padanan separa tidak sekali-kali memberikan akses.
5. Jika sesuai, gunakan pemberian kekal atau tetingkap pentadbir yang berasingan; ini kekal sebagai tambahan.

Ahli ditolak — "Your access has been suspended"

Simptom: Peristiwa ditolak dengan sebab access_disabled; pengguna menunjukkan lencana Disabled.

Punca: Akses pengguna dimatikan. Ini berlaku secara manual (pentadbir mematikan Access enabled) atau secara automatik (ahli telah dipadamkan dalam integrasi dan panel menunjukkan Removed by integration, atau mereka telah dipadam secara lembut).

Penyelesaian: Buka pengguna dan hidupkan semula Access enabled — atau, jika mereka menunjukkan Removed by integration, kembalikan mereka dalam sistem sumber (atau nyahgandingkan baris dan dayakan akses secara manual).

Polisi berjadual tidak membenarkan akses

Simptom: Aplikasi menunjukkan ketersediaan pada masa hadapan atau log mempunyai outside_access_time_window; tetingkap sumber kelihatan Stale atau Unmapped; atau akses berubah pada masa yang tidak dijangka.

Penyelesaian:

1. Sahkan bahawa polisi didayakan.
2. Semak Who dan Where polisi yang sama sebelum menyiasat jadual When-nya.
3. Bagi tetingkap One-time, bandingkan percubaan dengan [from, to). Zon waktu yang dipaparkan tidak boleh mengalihkan saat yang disimpan.
4. Bagi tetingkap Weekly, semak zon waktu IANA, hari minggu/blok tempatan, had aktif pilihan dan peralihan waktu jimat siang. Masa tamat adalah eksklusif dan blok semalaman mesti dipecahkan.
5. Gunakan policyId dan policyName dalam Access Log untuk mengesahkan polisi bernama yang dinilai.
6. Sahkan bahawa blockAllAccess, Force closed, penyahdayaan pengguna, geofence dan status pengawal tidak mengambil keutamaan.

Bagi tetingkap integrasi yang berasingan, sahkan juga pemetaan skop logik, semakan sumber, umur sumber dan kesihatan penghantaran. Tetingkap sumber yang tidak diketahui, tidak dipetakan atau lapuk tidak memberikan sebarang akses, tanpa mengalih keluar laluan Access Policy atau pemberian kekal.

Klien yang lebih lama boleh menunjukkan Outside hours kerana sebab keserasian ialah outside_access_hours; Access Log dan klien yang lebih baharu menggunakan butiran outside_access_time_window.

Penolakan geofence — "Move closer" dan yang seumpamanya

Simptom: Peristiwa ditolak dengan sebab outside_geofence, gps_too_imprecise atau location_unavailable.

Dialog butiran peristiwa ditolak menunjukkan koordinat yang dilaporkan, ketepatan dan jarak — sangat berguna untuk menilai sama ada ahli benar-benar berada di lokasi.

Pembukaan kunci dihantar tetapi pintu tidak terbuka (Timed out / Failed)

Simptom: Peristiwa berakhir dengan Timed out atau Failed dan bukannya Confirmed unlocked.

Punca: Arahan sampai ke pelayan tetapi pengawal tidak mengesahkan — sambungan yang tidak stabil di pintu, atau kerosakan peranti.

Penyelesaian:

1. Semak status dalam talian pintu dan maklumat peranti (tab Overview). Corak tamat masa pada satu pintu menunjukkan masalah pada rangkaiannya.
2. Cuba Unlock door pentadbir dari panel sambil memerhatikan pintu.
3. Gunakan Identify device (tiga bip) untuk mengesahkan anda berada secara fizikal di pengawal yang betul.
4. Jika geganti berbunyi klik tetapi pintu tidak terlepas, kerosakan berada dalam litar kunci — jalankan ujian pelompat dan multimeter dalam Penyelesaian Masalah Perkakasan.
5. Eskalasikan melalui diagnostik Pengurusan Peranti jika peranti dalam talian tetapi tidak menggerakkan kunci.

Semak juga Maintenance mode — pintu pada Force closed kekal berkunci bagi ahli mengikut reka bentuk. Block all access at this door menetapkan blockAllAccess secara jelas dan menolak setiap polisi ahli, pemberian kekal dan Access Time Window.

Jika pengawal dalam talian tetapi berhenti bertindak balas seperti biasa, Remotely reboot device (panel pintu → Configuration → Advanced) memulakannya semula. Pintu mengekalkan keadaan kuncinya semasa dan menjadi luar talian selama satu atau dua minit semasa ia dimulakan.

Ahli tidak dapat log masuk ke aplikasi

Simptom: "No record found" pada langkah Send code.

Punca: Telefon/e-mel yang mereka taip tidak sepadan dengan mana-mana rekod Users.

Penyelesaian: Cari baris mereka dalam Users dan bandingkan pengecam dengan tepat — format nombor yang berbeza, e-mel lama atau pengecam yang tiada adalah punca biasa. Kemas kini baris (atau minta ahli menggunakan pengecam yang ada dalam rekod). Ingat setiap baris memerlukan sekurang-kurangnya satu daripada telefon/e-mel.

Simptom: "Too many attempts."

Punca: Pengehadan kadar — 5 permintaan kod sejam bagi setiap kenalan, serta had di peringkat rangkaian.

Penyelesaian: Tunggu sehingga tempoh tamat; had bagi setiap kenalan ialah langkah keselamatan dan tidak boleh ditarik balik.

Masalah jemputan

Lihat jadual khusus dalam Jemputan → Penyelesaian masalah. Ringkasan pantas: Send failed → semak alamat dan hantar semula; tidak dimasukkan dalam penghantaran pukal → mereka telah dijemput, telah menggunakan aplikasi, tiada e-mel atau tiada akses.

Pengguna disegerakkan tiada atau tidak terkini

Simptom: Seseorang wujud dalam sistem ahli anda tetapi tiada dalam Users; atau butiran mereka lapuk.

Penyelesaian:

1. Semak Settings → Sync settings — adakah sumber didayakan? Adakah integrasi tertentu itu didayakan? Jika kad menunjukkan N removals held back for review, pengalihan keluar yang besar sedang menunggu pentadbir menyemaknya.
2. Kembangkan Sync activity & troubleshooting dan cari orang tersebut — sebab langkau memberitahu anda dengan tepat mengapa (pengecam tiada, dinyahgandingkan, integrasi dimatikan, dsb.). Lihat jadual sebab langkau.
3. Semak togol Track source updates pengguna — baris yang dinyahgandingkan tidak pernah dikemas kini daripada sumber.
4. Jika baris menunjukkan Not synced – duplicate, rekod lain berkongsi e-mel atau telefon yang sama. Lihat Penyelesaian pendua.
5. Gunakan Sync now untuk memaksa satu pusingan dan bukannya menunggu penyegerakan penuh harian.
6. Bagi Access Time Windows, periksa juga umur sumber, hasil semakan (updated/idempotent/stale/conflict) dan pemetaan scope_key. Pengambilan yang gagal mesti mengekalkan petikan sebelumnya tanpa perubahan dan bukannya mengosongkannya.

Jadual buka kunci automatik tidak membuka pintu

Simptom: Pintu tidak kekal terbuka semasa tetingkap berjadualnya.

Penyelesaian:

1. Buka tab Schedule pintu dan sahkan Auto-unlock dihidupkan. Semak pratonton Next 14 days untuk melihat bila pintu sepatutnya dibuka kunci.
2. Dengan Waktu Berkakitangan Kemudahan, semak waktu berkakitangan dan waktu cuti kemudahan dalam Konfigurasi Kemudahan & Sistem. Pada cuti umum, On public holidays menentukan sama ada pintu mengikut waktu cuti, kekal berkunci atau mengabaikan cuti tersebut.
3. Dengan Custom schedule, semak bahawa hari tersebut benar-benar mempunyai blok masa.
4. Semak sama ada kakitangan menggunakan Lock now: kad menunjukkan Locked by staff until HH:MM. Resume schedule mengembalikan jadual.
5. Ingat perubahan jadual hanya berkuat kuasa selepas disimpan, yang memuatkan semula pengawal (biasanya 10–15 saat).
6. Maintenance mode mengambil keutamaan — pintu pada Force closed tidak akan dibuka secara automatik.
7. Masa adalah dalam zon waktu kemudahan — sahkan tetapan zon waktu kemudahan jika tetingkap berlaku pada waktu yang ganjil.

Pentadbir menukar tetapan tetapi tiada apa-apa berlaku

Simptom: Polisi/geofence/mesej telah disunting tanpa kesan.

Punca: Perubahan tab Settings tidak digunakan sehingga Save changes diklik dalam bar simpan; menavigasi keluar menawarkan untuk membuangnya.

Penyelesaian: Gunakan semula dan simpan. Perubahan polisi dan geofence digunakan oleh percubaan kebenaran seterusnya; tetapan di sisi aplikasi muncul apabila aplikasi ahli dimuat semula seterusnya.

Halaman berkaitan

• Penyelesaian Masalah Perkakasan — diagnostik kuasa, geganti dan pendawaian kunci
• Access Logs
• Jadual Access Policy
• Rujukan — semua sebab penolakan dan nilai lalai
• Soalan lazim