Tham khảo
Trên trang này
Các bảng đầy đủ cho Door & Gate Access: mọi trạng thái sự kiện, lý do từ chối, cài đặt, giá trị mặc định, giới hạn và giá trị tùy chọn ở cùng một nơi. Hãy dùng trang này để tra cứu chính xác ý nghĩa của một giá trị; các trang hướng dẫn được liên kết sẽ giải thích cách sử dụng từng tính năng.
Trạng thái sự kiện truy cập
Hiển thị trong Nhật ký truy cập:
| Trạng thái | Ý nghĩa |
|---|---|
| Request received | Yêu cầu mở khóa đã đến và đang được đánh giá (tạm thời) |
| Pending | Yêu cầu đã vượt qua các bước kiểm tra và đang chờ được gửi đi (tạm thời) |
| Unlocked | Việc mở khóa được báo cáo là thành công |
| Confirmed unlocked | Bộ điều khiển cửa đã xác nhận rơ-le được nhả |
| Admin Unlocked | Quản trị viên đã kích hoạt mở khóa từ Performance Hub (ghi đè của quản trị viên); được ghi lại khi lệnh được gửi đi |
| Denied | Yêu cầu bị từ chối — xem lý do từ chối trên sự kiện |
| Timed out | Lệnh đã được gửi nhưng bộ điều khiển không xác nhận kịp thời |
| Failed | Không thể hoàn tất việc mở khóa do lỗi |
| Locked by staff | Nhân viên đã dùng Lock now trong khi lịch tự động mở khóa đang giữ cửa mở (một sự kiện của lịch, không phải lần thử mở khóa) |
| Schedule resumed | Lịch tự động mở khóa đã tiếp quản trở lại (một sự kiện của lịch, không phải lần thử mở khóa) |
Vòng đời sự kiện: đã nhận → đã gửi đi → đã xác nhận mở khóa / bị từ chối / hết thời gian chờ / thất bại.
Lý do từ chối
Mỗi lần mở khóa bị từ chối/thất bại đều ghi lại một lý do. Bảng sau đối chiếu lý do với những gì hội viên nhìn thấy và cách khắc phục:
| Lý do (như được ghi lại) | Thông báo hội viên nhìn thấy | Nguyên nhân | Cách khắc phục |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | Công tắc Access enabled của người dùng đang tắt | Bật lại công tắc trên bảng của người dùng trong Users |
no_matching_policy_or_grant | "You don't have access to this door" | Không có Access Policy nào khớp Who VÀ Where VÀ When và không có cách cấp quyền bổ sung nào cho phép truy cập | Xem lại Access Policies, thuộc tính người dùng, mục tiêu/mục loại trừ, lịch và quyền cấp |
no_matching_policy_target | "You don't have access to this door" | Không có Access Policy nào đang bật nhắm đến cửa này cho yêu cầu | Thêm cửa hoặc Access Scope của cửa vào một chính sách, hoặc dùng mục tiêu tất cả các cửa |
no_matching_policy_audience | "You don't have access to this door" | Có chính sách nhắm đến cửa, nhưng không có chính sách nào khớp với loại/trạng thái hoặc thẻ của người đó | Xem lại mục Who của chính sách và bản ghi Users |
outside_policy_schedule | "Outside allowed access hours" | Who và Where khớp, nhưng mọi lịch của các chính sách phù hợp đều không hoạt động hoặc đã hết hạn | Xem lại mục When của chính sách và múi giờ của cơ sở |
outside_geofence | "Move closer — you're outside the location's geofence." | Vị trí được báo cáo cách tâm geofence xa hơn bán kính + độ chính xác GPS + vùng đệm | Hội viên di chuyển lại gần hơn; hoặc xem lại bán kính/ghim của geofence |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | Độ chính xác GPS của điện thoại kém hơn ngưỡng Require GPS accuracy better than | Hội viên thử lại ngoài trời / tránh xa nguồn nhiễu; hoặc nâng ngưỡng |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | Điện thoại không báo cáo vị trí có thể sử dụng | Hội viên bật Location (Precise) cho ứng dụng |
geofence_misconfigured | Mở khóa bị từ chối | Geofence đã được bật nhưng thiếu tâm/ghim — hệ thống không cấp quyền truy cập khi thiếu thông tin này | Đặt ghim geofence trong Settings → Geofencing |
device_offline | "Door is offline. Please contact the facility." | Bộ điều khiển cửa chưa gửi tín hiệu (không có heartbeat trong vòng 5 phút) | Khôi phục nguồn điện/mạng cho bộ điều khiển — xem Khắc phục sự cố |
user_deleted | "You don't have access…" | Bản ghi Users đã bị xóa | Tạo lại hoặc khôi phục người dùng |
outside_access_time_window | Cửa bị vô hiệu hóa, kèm thời điểm khả dụng tiếp theo khi biết | Một khoảng thời gian trong tương lai là cách cho phép tiềm năng duy nhất của người dùng và chưa hoạt động | Kiểm tra thời điểm khả dụng được cung cấp, múi giờ, độ mới của nguồn và ánh xạ; Access Policies và quyền cấp vẫn được áp dụng độc lập |
Một số phiên bản ứng dụng hiển thị thông báo chung hơn là "You don't have access to this door" hoặc "Outside allowed access hours" cho các trường hợp từ chối liên quan đến chính sách cụ thể. Nhật ký truy cập vẫn lưu lý do chi tiết cho quản trị viên.
Chính sách Cấp quyền
| Thuộc tính | Ý nghĩa |
|---|---|
| Cấu trúc chính sách | Tên duy nhất, mô tả tùy chọn, cờ bật, đối tượng Who, mục tiêu/mục loại trừ Where, lịch When |
| Điều kiện khớp chính sách | Who VÀ Where VÀ When |
| Nhiều chính sách | HOẶC; bất kỳ chính sách nào đang bật và khớp đều cho phép |
| Who | Loại người cùng các trạng thái tùy chọn, HOẶC thẻ được đồng bộ/thẻ tùy chỉnh; để trống trạng thái = bất kỳ trạng thái nào |
| Where | Tất cả các cửa của cơ sở, Access Scopes, từng cửa riêng lẻ hoặc kết hợp; mục loại trừ được ưu tiên trong phạm vi chính sách đó |
| When | Anytime, hoặc các khoảng thời gian Weekly/One-time được kết hợp theo phép HOẶC |
| Các cách cho phép khác | Quyền cấp vĩnh viễn và các khoảng thời gian do quản trị viên/tích hợp tạo luôn riêng biệt và mang tính bổ sung |
| An toàn | Người dùng đã bị xóa/vô hiệu hóa/bị chặn do đồng bộ, việc xóa/chặn cửa, chế độ bảo trì, geofence, giới hạn tần suất và các bước kiểm tra bộ điều khiển vẫn được áp dụng |
| Cấu hình hiện có | Được tự động nhập vào các chính sách có tên tương đương với Who, Where và When rõ ràng |
Ghi nhận chính sách
Nhật ký truy cập xác định chính sách phù hợp theo tên và có thể hiển thị đối tượng, mục tiêu và lịch của chính sách đó. Các trường hợp khớp theo lịch cũng có thể bao gồm thời điểm bắt đầu và kết thúc cụ thể đang hoạt động.
Tham khảo về Access Time Window
| Thuộc tính | Ý nghĩa |
|---|---|
| Cấp quyền | Các khoảng thời gian trong lịch của chính sách là When của chính sách; các khoảng thời gian do quản trị viên/tích hợp tạo là những cách cho phép bổ sung riêng biệt |
| Ranh giới tuyệt đối | Các thời điểm UTC tính bằng số nguyên giây Unix, [from, to) |
| Múi giờ tuyệt đối | Siêu dữ liệu để hiển thị/kiểm tra; không làm dịch chuyển mốc thời gian epoch |
| Ranh giới Weekly | Các khối HH:mm theo giờ địa phương với thời điểm kết thúc không bao gồm |
| Múi giờ Weekly | Múi giờ IANA hợp lệ quyết định ngày/giờ theo đồng hồ địa phương và DST |
| Giới hạn Weekly | Thời điểm bắt đầu/kết thúc hoạt động tùy chọn tính bằng giây Unix; thời điểm kết thúc không bao gồm |
| Qua đêm/chồng lấn | Không được chấp nhận; hãy chia các khoảng thời gian qua đêm sang các ngày và giữ các khối không chồng lấn nhau |
| Quyền sở hữu của người dùng | Quản trị viên và từng nguồn tích hợp được tách biệt; nguồn này không thể xóa dữ liệu của nguồn khác |
| Phạm vi tích hợp | scope_key ổn định của nguồn, mặc định là default, được ánh xạ đến các mục tiêu PH; khóa không xác định/chưa được ánh xạ sẽ không cấp quyền truy cập |
| Độ mới của nguồn | Được cấu hình theo tần suất của từng tích hợp; hành vi khi nguồn đã cũ phải được xác định rõ ràng |
| An toàn | Không bao giờ bỏ qua người dùng bị vô hiệu hóa/đã xóa/xung đột, blockAllAccess, chế độ bảo trì, geofence, giới hạn tần suất hoặc các bước kiểm tra bộ điều khiển |
Giới hạn ban đầu: 50 khoảng thời gian cho mỗi vùng chứa chính sách/quyền cấp/nguồn; khoảng thời gian tuyệt đối tối đa 90 ngày; 120 ký tự cho ID/nhãn/khóa phạm vi; tám khối hằng tuần mỗi ngày; các mục mới được ghi không được phép đã hết hạn quá một giờ.
Cài đặt, giá trị mặc định và phạm vi
Cài đặt cửa
| Cài đặt | Mặc định | Phạm vi / tùy chọn |
|---|---|---|
| Thời gian giữ mở | 10 giây | 1–30 giây |
| Chế độ bảo trì | Normal | Normal / Force open / Force closed |
| Âm thanh khi mở cửa | Tắt | Bật / Tắt |
| Nhãn vị trí cửa | — | Văn bản tự do, tối đa 64 ký tự |
| Biểu tượng | Door | 10 tùy chọn (bên dưới) |
| Lịch tự động mở khóa | Tắt | Giờ có nhân viên tại cơ sở hoặc Custom schedule, theo múi giờ của cơ sở |
| Thời điểm Unlock / Lock của tự động mở khóa | At opening / At closing | At opening / At closing, hoặc 5, 10, 15, 30, 45, 60, 90 hay 120 phút trước hoặc sau |
| Tự động mở khóa vào ngày lễ | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| Cấp quyền truy cập (cho từng cửa) | Access Policies | Liệt kê các chính sách phù hợp và cho phép blockAllAccess |
| Geofence (cho từng cửa) | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| Ngưỡng trực tuyến | — | Bộ điều khiển được tính là trực tuyến khi có heartbeat trong 5 phút gần nhất |
Biểu tượng cửa
| Biểu tượng | Mục đích sử dụng |
|---|---|
| Door | Cửa đơn tiêu chuẩn (mặc định) |
| Sliding door | Cửa trượt / cửa tự động |
| Double door | Cửa đôi / cửa kiểu Pháp |
| Garage | Cửa nhà để xe / cửa cuốn |
| Boom gate | Cổng barie / tay chắn |
| Pedestrian | Lối vào dành cho nhân viên / người đi bộ |
| Security | Cửa hạn chế / cửa an ninh |
| Office | Văn phòng / phòng chỉ dành cho nhân viên |
| Delivery | Bến bốc dỡ hàng / khu giao hàng |
| Locker | Tủ đồ / kho chứa |
Cài đặt geofence
| Cài đặt | Mặc định | Phạm vi |
|---|---|---|
| Bật geofence | Bật (đối với cấu hình cơ sở mới) | Bật / Tắt |
| Bán kính | 200 m | 50–5000 m (bước 10 m; giá trị đặt sẵn 50 / 200 / 500 / 1000 m) |
| Vùng đệm độ chính xác | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| Công thức phạm vi cho phép | — | bán kính + độ chính xác GPS được báo cáo + vùng đệm độ chính xác |
Thời gian ân hạn truy cập
Trong Settings → Access Time Windows:
| Cài đặt | Tùy chọn |
|---|---|
| Allow early access | Tắt / 5 / 10 / 15 / 30 phút |
| Allow access after end | Tắt / 5 / 10 / 15 / 30 phút |
Cài đặt khóa ứng dụng
| Cài đặt | Mặc định | Tùy chọn |
|---|---|---|
| Enforce app lock for this facility | Tắt | Bật / Tắt |
| Grace period before re-prompting | 5 phút | Always prompt / 1 phút / 5 phút / 15 phút / 30 phút / 1 giờ |
| Hành vi khi có nhiều cơ sở | — | Bắt buộc nếu bất kỳ cơ sở được liên kết nào bắt buộc; thời gian ân hạn ngắn nhất trong số các cơ sở có bắt buộc sẽ được áp dụng |
Thông tin liên hệ hỗ trợ
| Chế độ | Hành vi |
|---|---|
| Smart (default) | Tự động hiển thị khi một cửa ngoại tuyến hoặc khi giao diện có ít thông tin |
| Always show | Luôn hiển thị trên bảng điều khiển của ứng dụng |
| Never show | Không bao giờ hiển thị |
Tin nhắn trong ứng dụng
| Trường | Giới hạn / tùy chọn |
|---|---|
| Loại thông báo | Information / Notice / Urgent |
| Tiêu đề | 120 ký tự |
| Nội dung | 2000 ký tự (cảnh báo nhẹ ở mức 500) |
| URL liên kết | Chỉ http(s), 2000 ký tự |
| Nhãn liên kết | 80 ký tự, mặc định là "More info" |
| Lịch | Starts at / Ends at tùy chọn |
| Trình giữ chỗ (quy tắc tự động) | {firstName}, {lastName} |
| Các trường khớp của quy tắc tự động | Membership status / Person type / Tag (thẻ khớp cả thẻ được đồng bộ và thẻ tùy chỉnh, không phân biệt chữ hoa chữ thường) / Door visibility |
| Mức độ ưu tiên của quy tắc | Quy tắc được bật đầu tiên khớp sẽ được áp dụng (theo thứ tự danh sách) |
Trường thông tin người dùng
| Trường | Giới hạn / ghi chú |
|---|---|
| Tên / họ | Mỗi trường 80 ký tự |
| Số điện thoại di động / email | Bắt buộc có ít nhất một (dùng để đăng nhập bằng OTP); số điện thoại được chuẩn hóa sang định dạng quốc tế |
| Thẻ | 80 ký tự mỗi thẻ; thẻ được đồng bộ bị ghi đè khi đồng bộ, thẻ tùy chỉnh do quản trị viên quản lý |
| Ghi chú | 2000 ký tự |
| Access enabled | Mặc định bật; tắt = mọi lần mở khóa đều bị từ chối |
| Quyền cấp | Toàn cơ sở, danh sách cửa, danh sách phạm vi, giờ hoạt động tùy chọn |
| Access Policies | Người dùng có thể được bao gồm trong một hoặc nhiều chính sách có tên; danh sách/quyền truy cập có hiệu lực dùng Access granted via policy |
| Access Time Windows | Các khoảng thời gian có thể chỉnh sửa do quản trị viên quản lý cùng các khoảng thời gian chỉ đọc do nguồn quản lý; tách biệt với lịch của chính sách |
Nguồn, trạng thái và các kiểu liệt kê khác
| Kiểu liệt kê | Giá trị |
|---|---|
| Nguồn người dùng | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| Ô người dùng | All users / Has access / No access / Not synced |
| Trạng thái lời mời | Not invited / Invited / Send failed |
| Người nhận lời mời | Only users with door access / All eligible synced users |
| Các trường của quy tắc lời mời | Membership status / Person type / Tag / Sync source / Integration; toán tử is any of / is not any of |
| Chế độ xem Nhật ký truy cập | Door events / No visit recorded |
| Mức độ sử dụng ứng dụng | Active (đã sử dụng ứng dụng) / Not yet active |
| Yêu cầu thông tin nhận dạng (đồng bộ) | Email OR phone (mặc định) / Email required / Phone required / Both required |
| Kết quả trong nhật ký đồng bộ | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| Trạng thái khoảng thời gian | Active / Upcoming / Expired / Stale / Unmapped |
| Nhãn trạng thái hội viên | Active, Current, Expired, On hold, Cancelled, Pending (cùng mọi giá trị từ hệ thống nguồn của bạn) |
| Mẫu Access Scope | Custom, Main entrances, Staff-only, Restricted area, 24/7 access, Business hours, Vehicle access, Service entries |
| Mẫu tin nhắn tự động | No door access, Expired membership, Payment overdue, Account on hold / suspended, Welcome (new member), Trial / prospect, Document / waiver required |
Lý do bỏ qua khi đồng bộ
| Lý do hiển thị trong nhật ký đồng bộ | Ý nghĩa |
|---|---|
| Integration sync is turned off for this facility | Công tắc chính của nguồn đang tắt |
| This integration is turned off in sync settings | Tích hợp cụ thể này đã được loại khỏi đồng bộ |
| No phone or email on the record (a phone or email is required to log in) | Bản ghi không đáp ứng quy tắc Require identifier |
| Record is decoupled and managed manually | Track source updates đang tắt cho người dùng này |
| No facility on the source record | Bản ghi nguồn không được liên kết với cơ sở này |
| No matching user record | Thay đổi tham chiếu đến một người không có hàng tại đây |
Giới hạn vận hành
| Giới hạn | Giá trị |
|---|---|
| Nhập CSV | 200 người dùng mỗi lần nhập |
| Lời mời hàng loạt | Được gửi theo đợt 50 lời mời |
| Mẫu xem trước khi xóa hàng loạt | Hiển thị 50 người dùng đầu tiên |
| Truy vấn Nhật ký truy cập | Tối đa 500 sự kiện gần nhất cho mỗi khoảng thời gian |
| Thời gian lưu giữ sự kiện truy cập | ~13 tháng, sau đó tự động bị xóa |
| Thời gian hiệu lực của lệnh mở khóa từ quản trị viên | 30 giây (lệnh hết hạn nếu không được chuyển đến) |
| Heartbeat của bộ điều khiển cửa | Khoảng mỗi ~30 giây; ngoại tuyến sau 5 phút không có tín hiệu |
| Yêu cầu mã đăng nhập | 5 lần mỗi giờ cho mỗi số điện thoại/email (giới hạn bảo mật, không thể gỡ bỏ) |
| Lan truyền việc đăng xuất ứng dụng | Thu hồi ngay lập tức; tối đa 15 phút để phiên đang hoạt động kết thúc hoàn toàn |
| Lưu cài đặt cửa | Tải lại bộ điều khiển — thường mất 10–15 giây |
| Thời gian lưu giữ No visit recorded | ~13 tháng |
| Ánh xạ Access Time Window | 50 cho mỗi tích hợp |
| Access Time Windows cho mỗi vùng chứa | 50 |
| Khoảng thời gian One-time | 90 ngày |
| Khối Weekly | 8 cho mỗi ngày trong tuần |
| ID khoảng thời gian/nguồn, nhãn, khóa phạm vi | 120 ký tự |
| Access Policies cho mỗi cơ sở | 100 |
| Tổng số khoảng thời gian của chính sách | 500 |
| Tên/ID của Access Policy | 120 ký tự |
| Mô tả Access Policy | 500 ký tự |
| Cấu hình Access Policy | 300 KiB UTF-8 |