การแก้ไขปัญหา

ในหน้านี้

วิธีแก้ไขตามอาการสำหรับปัญหาที่พบบ่อยที่สุดของ Door & Gate Access แต่ละรายการเรียงตามอาการ → สาเหตุ → วิธีแก้ไข สำหรับความหมายของสถานะหรือเหตุผลในการปฏิเสธ ดูข้อมูลอ้างอิง สำหรับตรรกะการตัดสินใจเบื้องหลัง ดูการตัดสินใจเรื่องการเข้าถึงทำงานอย่างไร

เริ่มต้นที่บันทึกการเข้าถึง รายงาน "เข้าไม่ได้" เกือบทุกกรณีจะมีเหตุการณ์ที่ถูกปฏิเสธในบันทึกการเข้าถึง พร้อมเหตุผลที่แน่ชัด ค้นหาชื่อของสมาชิก ดูเหตุการณ์ที่ถูกปฏิเสธล่าสุด แล้วไปยังส่วนที่ตรงกันด้านล่าง

ประตูแสดงสถานะออฟไลน์

อาการ: การ์ดประตูแสดง ออฟไลน์ สมาชิกเห็น "Door offline" และส่งคำสั่งปลดล็อกไม่ได้

สาเหตุ: ตัวควบคุมประตูไม่ได้รายงานสถานะมานานกว่า 5 นาที เนื่องจากไฟฟ้าหรือเครือข่ายที่อุปกรณ์ขัดข้อง

วิธีแก้ไข:

  1. ตรวจสอบว่าตัวควบคุมมีไฟเลี้ยงและการเชื่อมต่อเครือข่าย (สาย Ethernet / Wi-Fi) หน้าการแก้ไขปัญหาฮาร์ดแวร์ครอบคลุมการตรวจสอบที่หน้างาน (ไฟ LED แสดงสถานะ ตัวแยก PoE การเดินสาย SIM/เสาอากาศในรุ่น 4G)
  2. เปิดแผงของประตู → แท็บ Overview เพื่อดู Status (เวลาที่เห็นล่าสุด) IP address และระยะเวลาทำงาน หาก "last seen" เป็นเวลาไม่นานมานี้ แสดงว่าน่าจะเป็นปัญหาเครือข่ายที่ขาดเป็นช่วง ๆ มากกว่าอุปกรณ์เสีย
  3. ปิดและเปิดตัวควบคุมใหม่หากจำเป็น
  4. สำหรับการวินิจฉัยเชิงลึก ให้ใช้ Open in Device Management for advanced configuration
  5. หากประตูหลายบานออฟไลน์พร้อมกัน ให้สงสัยว่าเป็นปัญหาเครือข่าย/อินเทอร์เน็ตของสถานที่มากกว่าอุปกรณ์

ขณะที่ประตูออฟไลน์ สมาชิกจะเห็นรายละเอียดการติดต่อฝ่ายสนับสนุนบนแดชบอร์ดของตน (ในโหมด Smart ซึ่งเป็นค่าเริ่มต้น) เพื่อให้โทรหาคุณได้

สมาชิกถูกปฏิเสธ — "You don't have access to this door"

อาการ: เหตุการณ์ที่ถูกปฏิเสธพร้อมเหตุผล no_matching_policy_or_grant

สาเหตุ: ไม่มีเส้นทางเพิ่มเติมใดที่อนุญาต ไม่มี Access Policy ที่เปิดใช้งานซึ่งตรงทั้ง Who AND Where AND When และไม่มีสิทธิ์ถาวรหรือช่วงเวลาของผู้ดูแลระบบ/การผสานรวมที่ใช้งานอยู่ซึ่งครอบคลุมประตูนั้น

วิธีแก้ไข:

  1. เปิดสมาชิกใน Users แล้วเปรียบเทียบประเภทบุคคล สถานะสมาชิก และแท็กที่ซิงค์/แท็กที่กำหนดเองกับ Who ของนโยบาย
  2. ตรวจสอบว่า Where รวมประตูนั้นไว้โดยตรง ผ่าน Access Scope หรือผ่านประตูทั้งหมดของสถานที่ และไม่มีข้อยกเว้นใดที่นำประตูนั้นออก
  3. ตรวจสอบ When: Anytime หรือมีช่วงเวลา Weekly/One-time ที่ใช้งานอยู่อย่างน้อยหนึ่งช่วง เวลาสิ้นสุดไม่นับรวม
  4. โปรดจำไว้ว่านโยบายต่าง ๆ จะรวมกันแบบ OR แต่แต่ละนโยบายต้องตรงทั้ง Who AND Where AND When การตรงกันบางส่วนจะไม่ให้สิทธิ์การเข้าถึง
  5. หากเหมาะสม ให้ใช้สิทธิ์ถาวรหรือช่วงเวลาของผู้ดูแลระบบแยกต่างหาก ซึ่งยังคงเป็นเส้นทางเพิ่มเติม

สมาชิกถูกปฏิเสธ — "Your access has been suspended"

อาการ: เหตุการณ์ที่ถูกปฏิเสธพร้อมเหตุผล access_disabled และผู้ใช้แสดงป้าย Disabled

สาเหตุ: สิทธิ์การเข้าถึงของผู้ใช้ถูกปิด ซึ่งเกิดขึ้นได้ด้วยตนเอง (ผู้ดูแลระบบปิด Access enabled) หรือโดยอัตโนมัติ (สมาชิกถูกลบในการผสานรวมและแผงแสดง Removed by integration หรือถูกลบแบบซอฟต์)

วิธีแก้ไข: เปิดผู้ใช้และเปิด Access enabled อีกครั้ง หรือหากแสดง Removed by integration ให้คืนสถานะผู้ใช้ในระบบต้นทาง (หรือแยกแถวออกและเปิดสิทธิ์การเข้าถึงด้วยตนเอง)

นโยบายตามกำหนดการไม่อนุญาตให้เข้าถึง

อาการ: แอปแสดงช่วงเวลาที่ใช้งานได้ในอนาคต หรือบันทึกมี outside_access_time_window ช่วงเวลาจากแหล่งข้อมูลแสดงเป็น Stale หรือ Unmapped หรือสิทธิ์การเข้าถึงเปลี่ยนในเวลาที่ไม่คาดคิด

วิธีแก้ไข:

  1. ยืนยันว่านโยบายเปิดใช้งานอยู่
  2. ตรวจสอบ Who และ Where ของนโยบายเดียวกันก่อนตรวจสอบกำหนดการ When
  3. สำหรับช่วงเวลา One-time ให้เปรียบเทียบความพยายามกับ [from, to) เขตเวลาที่แสดงไม่สามารถเลื่อนเวลาที่จัดเก็บไว้ได้
  4. สำหรับช่วงเวลา Weekly ให้ตรวจสอบเขตเวลา IANA วันในสัปดาห์/ช่วงเวลาตามเวลาท้องถิ่น ขอบเขตการใช้งานที่ไม่บังคับ และการเปลี่ยนเวลาออมแสง เวลาสิ้นสุดไม่นับรวม และช่วงเวลาข้ามคืนต้องแยกออกเป็นสองช่วง
  5. ใช้ policyId และ policyName ในบันทึกการเข้าถึงเพื่อยืนยันว่านโยบายที่มีชื่อใดถูกประเมิน
  6. ยืนยันว่า blockAllAccess, Force closed การปิดใช้งานผู้ใช้ Geofence และสถานะของตัวควบคุมไม่ได้มีลำดับความสำคัญเหนือกว่า

สำหรับช่วงเวลาจากการผสานรวมแยกต่างหาก ให้ตรวจสอบการแมปขอบเขตเชิงตรรกะ รุ่นของแหล่งข้อมูล อายุของแหล่งข้อมูล และสถานะการส่งข้อมูลด้วย ช่วงเวลาจากแหล่งข้อมูลที่ไม่รู้จัก ไม่ได้แมป หรือล้าสมัยจะปฏิเสธการเข้าถึงโดยไม่นำเส้นทาง Access Policy หรือสิทธิ์ถาวรออก

ไคลเอ็นต์รุ่นเก่าอาจแสดง Outside hours เนื่องจากเหตุผลด้านความเข้ากันได้คือ outside_access_hours ส่วนบันทึกการเข้าถึงและไคลเอ็นต์รุ่นใหม่จะใช้รายละเอียด outside_access_time_window

การปฏิเสธเนื่องจาก Geofence — "Move closer" และอื่น ๆ

อาการ: เหตุการณ์ที่ถูกปฏิเสธพร้อมเหตุผล outside_geofence, gps_too_imprecise หรือ location_unavailable

เหตุผลสาเหตุวิธีแก้ไข
outside_geofenceตำแหน่งที่สมาชิกรายงานอยู่ไกลจากหมุดเกิน รัศมี + ความแม่นยำของ GPS + ระยะเผื่อหากสมาชิกอยู่ที่สถานที่จริง ให้ตรวจสอบตำแหน่งหมุดและรัศมีใน Settings → Geofencing (ใช้ Test Geofence เพื่อจำลองตำแหน่งของสมาชิก) สังเกตคำเตือนของหมุดว่าอยู่ไกลจากที่อยู่ที่บันทึกไว้ของสถานที่หรือไม่ หากประตูไม่ควรใช้ Geofence เลย (เช่น ทางเข้าสำหรับบริการ) ให้ใช้ตัวเลือก Disable geofence for this door ของประตู
gps_too_impreciseตำแหน่ง GPS ของโทรศัพท์แม่นยำน้อยกว่าเกณฑ์ Require GPS accuracy better than (ค่าเริ่มต้น 100 m) ซึ่งพบบ่อยเมื่ออยู่ลึกเข้าไปในอาคารให้สมาชิกลองอีกครั้งใกล้หน้าต่างหรือนอกอาคาร หากเกิดขึ้นเป็นประจำที่สถานที่ของคุณ ให้เพิ่มเกณฑ์เล็กน้อย
location_unavailableโทรศัพท์ไม่ได้ให้ตำแหน่ง เนื่องจากปิดบริการระบุตำแหน่ง หรือแอปไม่มีสิทธิ์/มีสิทธิ์แบบตำแหน่งโดยประมาณสมาชิกต้องเปิด Location สำหรับแอปและตั้งค่าเป็น Precise (แอปจะแสดงทางลัด Open Settings)

กล่องโต้ตอบรายละเอียดของเหตุการณ์ที่ถูกปฏิเสธจะแสดงพิกัดที่รายงาน ความแม่นยำ และระยะทาง ซึ่งมีประโยชน์อย่างยิ่งในการตัดสินว่าสมาชิกอยู่ที่สถานที่จริงหรือไม่

ส่งคำสั่งปลดล็อกแล้วแต่ประตูไม่เปิด (Timed out / Failed)

อาการ: เหตุการณ์สิ้นสุดด้วย Timed out หรือ Failed แทนที่จะเป็น Confirmed unlocked

สาเหตุ: คำสั่งไปถึงเซิร์ฟเวอร์แต่ตัวควบคุมไม่ได้ยืนยัน เนื่องจากการเชื่อมต่อที่ประตูไม่เสถียร หรืออุปกรณ์ขัดข้อง

วิธีแก้ไข:

  1. ตรวจสอบสถานะออนไลน์และข้อมูลอุปกรณ์ของประตู (แท็บ Overview) หากหมดเวลาซ้ำ ๆ ที่ประตูบานเดียว แสดงว่าเป็นปัญหาที่เครือข่ายของประตูนั้น
  2. ลองใช้ Unlock door ของผู้ดูแลระบบจากแผงขณะเฝ้าดูประตู
  3. ใช้ Identify device (เสียงบี๊บสามครั้ง) เพื่อยืนยันว่าคุณอยู่ที่ตัวควบคุมที่ถูกต้อง
  4. หากรีเลย์มีเสียงคลิกแต่ประตูไม่ปลดล็อก แสดงว่าปัญหาอยู่ที่วงจรล็อก ให้ทำการทดสอบด้วยสายจัมเปอร์และมัลติมิเตอร์ในการแก้ไขปัญหาฮาร์ดแวร์
  5. ส่งเรื่องต่อผ่านการวินิจฉัยในการจัดการอุปกรณ์หากอุปกรณ์ออนไลน์อยู่แต่ไม่ทำงาน

ตรวจสอบ Maintenance mode ด้วย ประตูที่ตั้งเป็น Force closed จะล็อกอยู่สำหรับสมาชิกตามการออกแบบ Block all access at this door จะตั้งค่า blockAllAccess อย่างชัดเจน และปฏิเสธนโยบายสมาชิก สิทธิ์ถาวร และ Access Time Window ทั้งหมด

หากตัวควบคุมออนไลน์อยู่แต่หยุดตอบสนองตามปกติ Remotely reboot device (แผงประตู → Configuration → Advanced) จะรีสตาร์ตตัวควบคุม ประตูจะคงสถานะล็อกปัจจุบันไว้และออฟไลน์ประมาณหนึ่งถึงสองนาทีขณะบูต

สมาชิกลงชื่อเข้าใช้แอปไม่ได้

อาการ: "No record found" ในขั้นตอน Send code

สาเหตุ: โทรศัพท์/อีเมลที่สมาชิกพิมพ์ไม่ตรงกับระเบียนใดใน Users

วิธีแก้ไข: ค้นหาแถวของสมาชิกใน Users แล้วเปรียบเทียบตัวระบุให้ตรงกันทุกตัวอักษร รูปแบบหมายเลขที่ต่างกัน อีเมลเก่า หรือไม่มีตัวระบุ มักเป็นสาเหตุ อัปเดตแถว (หรือให้สมาชิกใช้ตัวระบุที่บันทึกไว้) โปรดจำไว้ว่าแต่ละแถวต้องมีโทรศัพท์หรืออีเมลอย่างน้อยหนึ่งอย่าง

อาการ: "Too many attempts."

สาเหตุ: การจำกัดอัตรา ขอรหัสได้ 5 ครั้งต่อชั่วโมงต่อผู้ติดต่อ รวมถึงขีดจำกัดระดับเครือข่าย

วิธีแก้ไข: รอจนกว่าจะครบเวลา ขีดจำกัดต่อผู้ติดต่อเป็นมาตรการด้านความปลอดภัยและไม่สามารถยกเลิกได้

ปัญหาคำเชิญ

ดูตารางเฉพาะในคำเชิญ → การแก้ไขปัญหา สรุปโดยย่อ: Send failed → ตรวจสอบที่อยู่และส่งอีกครั้ง ไม่รวมอยู่ในการส่งจำนวนมาก → ผู้ใช้ได้รับเชิญแล้ว เคยใช้แอปแล้ว ไม่มีอีเมล หรือไม่มีสิทธิ์การเข้าถึง

ผู้ใช้ที่ซิงค์หายไปหรือข้อมูลไม่เป็นปัจจุบัน

อาการ: บุคคลมีอยู่ในระบบสมาชิกของคุณแต่ไม่มีใน Users หรือรายละเอียดล้าสมัย

วิธีแก้ไข:

  1. ตรวจสอบ Settings → Sync settings แหล่งข้อมูลเปิดใช้งานอยู่หรือไม่ การผสานรวมนั้นเปิดใช้งานอยู่หรือไม่ หากการ์ดแสดง N removals held back for review แสดงว่ามีการนำออกจำนวนมากที่รอให้ผู้ดูแลระบบตรวจสอบ
  2. ขยาย Sync activity & troubleshooting แล้วค้นหาบุคคลนั้น เหตุผลในการข้ามจะบอกสาเหตุที่แน่ชัด (ไม่มีตัวระบุ แยกออกแล้ว การผสานรวมปิดอยู่ ฯลฯ) ดูตารางเหตุผลในการข้าม
  3. ตรวจสอบสวิตช์ Track source updates ของผู้ใช้ แถวที่แยกออกแล้วจะไม่อัปเดตจากแหล่งข้อมูลเลย
  4. หากแถวแสดง Not synced – duplicate แสดงว่ามีระเบียนอื่นที่ใช้อีเมลหรือโทรศัพท์เดียวกัน ดูการแก้ไขข้อมูลซ้ำ
  5. ใช้ Sync now เพื่อบังคับให้ซิงค์แทนที่จะรอการซิงค์เต็มรูปแบบรายวัน
  6. สำหรับ Access Time Windows ให้ตรวจสอบอายุของแหล่งข้อมูล ผลลัพธ์ของรุ่น (updated/idempotent/stale/conflict) และการแมป scope_key ด้วย การดึงข้อมูลที่ล้มเหลวต้องคงสแนปช็อตก่อนหน้าไว้โดยไม่เปลี่ยนแปลงแทนที่จะล้างข้อมูล

กำหนดการปลดล็อกอัตโนมัติไม่เปิดประตู

อาการ: ประตูไม่ค้างเปิดในช่วงเวลาตามกำหนดการ

วิธีแก้ไข:

  1. เปิดแท็บ Schedule ของประตูและยืนยันว่า Auto-unlock เปิดอยู่ ตรวจสอบตัวอย่าง Next 14 days เพื่อดูว่าประตูควรปลดล็อกเมื่อใด
  2. เมื่อใช้ เวลาที่มีพนักงานประจำสถานที่ ให้ตรวจสอบเวลาที่มีพนักงานประจำและเวลาวันหยุดของสถานที่ในการกำหนดค่าสถานที่และระบบ ในวันหยุดนักขัตฤกษ์ On public holidays จะกำหนดว่าประตูจะใช้ตามเวลาวันหยุด ล็อกไว้ หรือไม่สนใจวันหยุด
  3. เมื่อใช้ Custom schedule ให้ตรวจสอบว่าวันนั้นมีช่วงเวลากำหนดไว้จริง
  4. ตรวจสอบว่าพนักงานใช้ Lock now หรือไม่ การ์ดจะแสดง Locked by staff until HH:MM Resume schedule จะกลับไปใช้กำหนดการ
  5. โปรดจำไว้ว่าการเปลี่ยนแปลงกำหนดการจะมีผลหลังจากบันทึกแล้วเท่านั้น ซึ่งจะโหลดตัวควบคุมใหม่ (โดยทั่วไป 10–15 วินาที)
  6. Maintenance mode มีลำดับความสำคัญเหนือกว่า ประตูที่ตั้งเป็น Force closed จะไม่เปิดอัตโนมัติ
  7. เวลาเป็นไปตามเขตเวลาของสถานที่ ตรวจสอบการตั้งค่าเขตเวลาของสถานที่หากช่วงเวลาทำงานในเวลาที่ผิดปกติ

ผู้ดูแลระบบเปลี่ยนการตั้งค่าแล้วแต่ไม่มีอะไรเกิดขึ้น

อาการ: แก้ไขนโยบาย/Geofence/ข้อความแล้วไม่มีผล

สาเหตุ: การเปลี่ยนแปลงในแท็บ Settings จะไม่มีผลจนกว่าจะคลิก Save changes ในแถบบันทึก การออกจากหน้าจะมีตัวเลือกให้ยกเลิกการเปลี่ยนแปลง

วิธีแก้ไข: ทำการเปลี่ยนแปลงอีกครั้งแล้วบันทึก การเปลี่ยนแปลงนโยบายและ Geofence จะใช้กับความพยายามขออนุญาตครั้งถัดไป ส่วนการตั้งค่าฝั่งแอปจะปรากฏเมื่อแอปของสมาชิกรีเฟรชครั้งถัดไป