参考
本页内容
Door & Gate Access 的完整参考表：所有事件状态、拒绝原因、设置、默认值、限制和选项值汇总于一处。使用本页可准确查询某个值的含义；链接的指南页面会介绍如何使用各项功能。
访问事件状态
显示在访问日志中：
| 状态 | 含义 |
|---|---|
| Request received | 解锁请求已到达，正在评估（临时状态） |
| Pending | 请求已通过检查，正在等待下发（临时状态） |
| Unlocked | 已报告解锁成功 |
| Confirmed unlocked | 门控制器已确认继电器释放 |
| Admin Unlocked | 管理员从 Performance Hub 触发了解锁（管理员覆盖）；在指令下发时记录 |
| Denied | 请求被拒绝，请查看事件上的拒绝原因 |
| Timed out | 指令已发送，但控制器未及时确认 |
| Failed | 由于错误，解锁无法完成 |
| Locked by staff | 在自动解锁时间表保持门打开期间，员工使用了 Lock now（这是时间表事件，而非解锁尝试） |
| Schedule resumed | 自动解锁时间表重新接管（这是时间表事件，而非解锁尝试） |
事件生命周期：已接收 → 已下发 → 已确认解锁/已拒绝/已超时/已失败。
拒绝原因
每次被拒绝/失败的解锁都会记录一个原因。下表列出了每个原因对应的会员可见消息以及解决方法：
| 原因（日志记录值） | 面向会员的消息 | 原因说明 | 解决方法 |
|---|---|---|---|
access_disabled | "Your access has been suspended — please contact the facility" | 用户的 Access enabled 开关已关闭 | 在 Users 中的用户面板上重新启用 |
no_matching_policy_or_grant | "You don't have access to this door" | 没有任何 Access Policy 同时匹配 Who、Where 和 When，也没有任何叠加授权途径允许访问 | 检查 Access Policies、用户属性、目标/排除项、时间表和授权 |
no_matching_policy_target | "You don't have access to this door" | 对于该请求，没有任何已启用的 Access Policy 以此门为目标 | 将该门或其 Access Scope 添加到某项策略中，或使用“所有门”目标 |
no_matching_policy_audience | "You don't have access to this door" | 有策略以该门为目标，但没有一项与该人员的类型/状态或标签匹配 | 检查策略的 Who 部分和 Users 记录 |
outside_policy_schedule | "Outside allowed access hours" | Who 和 Where 匹配，但所有匹配策略的时间表均未生效或已过期 | 检查策略的 When 部分和设施时区 |
outside_geofence | "Move closer — you're outside the location's geofence." | 上报的位置距离地理围栏中心超过半径 + GPS 精度 + 缓冲 | 会员靠近；或检查地理围栏半径/图钉 |
gps_too_imprecise | "Couldn't pin down your location accurately. Try again outdoors." | 手机的 GPS 精度差于 Require GPS accuracy better than 阈值 | 会员到室外/远离干扰源重试；或提高阈值 |
location_unavailable | "Couldn't read your location. Make sure Location is enabled and set to Precise, then try again." | 手机未上报可用的位置 | 会员为应用启用定位（精确） |
geofence_misconfigured | 解锁被拒绝 | 已启用地理围栏，但缺少其中心点/图钉，系统采用失败即关闭原则 | 在 Settings → Geofencing 中放置地理围栏图钉 |
device_offline | "Door is offline. Please contact the facility." | 门控制器未上报状态（5 分钟内无心跳） | 恢复控制器的电源/网络，请参阅故障排除 |
user_deleted | "You don't have access…" | Users 记录已被删除 | 重新创建或恢复该用户 |
outside_access_time_window | 门被禁用，并在已知时显示下次可用时间 | 未来的时间窗口是该用户唯一可能的允许途径，且尚未生效 | 检查提供的可用时间、时区、源数据新鲜度和映射；Access Policies 和授权仍独立适用 |
对于特定于策略的拒绝，某些应用版本会显示较笼统的“You don't have access to this door”或“Outside allowed access hours”消息。访问日志会为管理员保留详细原因。
访问策略
| 属性 | 含义 |
|---|---|
| 策略结构 | 唯一名称、可选描述、启用标志、Who 受众、Where 目标/排除项、When 时间表 |
| 策略匹配 | Who 且 Where 且 When |
| 多项策略 | 或关系；任何匹配且已启用的策略都会允许访问 |
| Who | 人员类型加可选状态，或同步/自定义标签；状态为空 = 任意状态 |
| Where | 设施的所有门、Access Scopes、单扇门或其组合；在该策略内排除项优先 |
| When | Anytime，或以“或”关系组合的 Weekly/One-time 时间窗口 |
| 其他允许途径 | 永久授权和管理员/集成时间窗口保持独立且叠加 |
| 安全 | 已删除/已停用/被同步封锁的用户、门删除/封锁、维护、地理围栏、频率限制和控制器检查仍然适用 |
| 现有配置 | 自动导入为具有明确 Who、Where 和 When 的等效命名策略 |
策略归因
访问日志按名称标识匹配的策略，并可以显示其受众、目标和时间表。定时匹配还可以包含当前生效的具体开始和结束时间。
Access Time Window 参考
| 属性 | 含义 |
|---|---|
| 授权 | 策略时间表时间窗口即策略的 When；管理员/集成时间窗口是独立的叠加允许途径 |
| 绝对边界 | 以 Unix 秒为单位的整数 UTC 时间点，[from, to) |
| 绝对时区 | 用于显示/审计的元数据；不会偏移时间戳 |
| 每周边界 | 当地 HH:mm 时间块，结束时间不包含在内 |
| 每周时区 | 有效的 IANA 时区，决定挂钟日期/时间和夏令时 |
| 每周范围 | 可选的以 Unix 秒为单位的生效开始/生效结束时间；结束时间不包含在内 |
| 跨夜/重叠 | 不接受；请将跨夜时段拆分到不同日期，并保持时间块互不重叠 |
| 用户归属 | 管理员和每个集成源相互隔离；一方无法清除另一方 |
| 集成范围 | 稳定的源 scope_key，默认为 default，映射到 PH 目标；未知/未映射的按失败即关闭原则处理 |
| 源数据新鲜度 | 按每个集成的频率配置；过时源的行为必须明确设定 |
| 安全 | 绝不绕过已停用/已删除/存在冲突的用户、blockAllAccess、维护、地理围栏、频率限制或控制器检查 |
初始限制：每个策略/授权/源容器 50 个时间窗口；绝对时间跨度最长 90 天；ID/标签/范围键最多 120 个字符；每天 8 个每周时间块；新写入的条目过期时间不得超过一小时。
设置、默认值和范围
门设置
| 设置 | 默认值 | 范围/选项 |
|---|---|---|
| 保持时间 | 10 秒 | 1–30 秒 |
| 维护模式 | Normal | Normal / Force open / Force closed |
| 开门提示音 | 关 | 开 / 关 |
| 门位置标签 | — | 自由文本，最多 64 个字符 |
| 图标 | Door | 10 个选项（见下文） |
| 自动解锁时间表 | 关 | Facility staffed hours 或 Custom schedule，采用设施时区 |
| 自动解锁的 Unlock / Lock 时间 | At opening / At closing | At opening / At closing，或提前/推后 5、10、15、30、45、60、90 或 120 分钟 |
| 公共假期自动解锁 | Ignore holidays | Follow the facility's holiday hours / Stay locked all day / Ignore holidays |
| 访问授权（单扇门） | Access Policies | 列出匹配的策略，并允许设置 blockAllAccess |
| 地理围栏（单扇门） | Inherit from facility | Inherit from facility / Override for this door / Disable geofence for this door |
| 在线阈值 | — | 控制器在过去 5 分钟内有心跳即视为在线 |
门图标
| 图标 | 预期用途 |
|---|---|
| Door | 标准单扇门（默认） |
| Sliding door | 推拉门/自动门 |
| Double door | 双开门/法式门 |
| Garage | 车库门/卷帘门 |
| Boom gate | 道闸/挡杆 |
| Pedestrian | 员工/行人步行入口 |
| Security | 限制区域门/安全门 |
| Office | 办公室/仅限员工的房间 |
| Delivery | 装卸平台/送货区 |
| Locker | 储物柜/储藏室 |
地理围栏设置
| 设置 | 默认值 | 范围 |
|---|---|---|
| 启用地理围栏 | 开（适用于新的设施配置） | 开 / 关 |
| 半径 | 200 m | 50–5000 m（步长 10 m；预设 50 / 200 / 500 / 1000 m） |
| 精度缓冲 | 25 m | — |
| Require GPS accuracy better than | 100 m | — |
| 允许范围公式 | — | 半径 + 上报的 GPS 精度 + 精度缓冲 |
访问宽限期
位于 Settings → Access Time Windows 下：
| 设置 | 选项 |
|---|---|
| Allow early access | 关 / 5 / 10 / 15 / 30 分钟 |
| Allow access after end | 关 / 5 / 10 / 15 / 30 分钟 |
应用锁设置
| 设置 | 默认值 | 选项 |
|---|---|---|
| Enforce app lock for this facility | 关 | 开 / 关 |
| Grace period before re-prompting | 5 分钟 | Always prompt / 1 分钟 / 5 分钟 / 15 分钟 / 30 分钟 / 1 小时 |
| 多设施行为 | — | 只要任一关联设施强制启用即强制启用；以强制启用设施中最短的宽限期为准 |
支持联系人
| 模式 | 行为 |
|---|---|
| Smart（默认） | 在门离线或界面中信息有限时自动显示 |
| Always show | 始终显示在应用仪表板上 |
| Never show | 从不显示 |
应用消息
| 字段 | 限制/选项 |
|---|---|
| 通知类型 | Information / Notice / Urgent |
| 标题 | 120 个字符 |
| 正文 | 2000 个字符（超过 500 个字符时显示软性警告） |
| 链接 URL | 仅限 http(s)，2000 个字符 |
| 链接标签 | 80 个字符，默认为“More info” |
| 时间表 | 可选的 Starts at / Ends at |
| 占位符（自动规则） | {firstName}、{lastName} |
| 自动规则匹配字段 | Membership status / Person type / Tag（标签同时匹配同步标签和自定义标签，不区分大小写） / Door visibility |
| 规则优先级 | 第一条匹配的已启用规则生效（按列表顺序） |
用户字段
| 字段 | 限制/说明 |
|---|---|
| 名字/姓氏 | 各 80 个字符 |
| 手机号/电子邮箱 | 至少需要填写一项（用于 OTP 登录）；电话号码会规范化为国际格式 |
| 标签 | 每个标签 80 个字符；同步标签会被同步覆盖，自定义标签由管理员拥有 |
| 备注 | 2000 个字符 |
| Access enabled | 默认开启；关闭 = 所有解锁均被拒绝 |
| 授权 | 设施范围、门列表、范围列表、可选的营业时间 |
| Access Policies | 用户可被一项或多项命名策略覆盖；列表/有效访问权限使用 Access granted via policy |
| Access Time Windows | 由管理员拥有的可编辑时间窗口，以及由源拥有的只读时间窗口；独立于策略时间表 |
来源、状态和其他枚举值
| 枚举 | 值 |
|---|---|
| 用户来源 | Manually added / External Integration / CCTV-Computer Vision / Performance Hub staff |
| 用户卡片 | All users / Has access / No access / Not synced |
| 邀请状态 | Not invited / Invited / Send failed |
| 邀请收件人 | Only users with door access / All eligible synced users |
| 邀请规则字段 | Membership status / Person type / Tag / Sync source / Integration；运算符 is any of / is not any of |
| 访问日志视图 | Door events / No visit recorded |
| 应用采用情况 | Active（已使用过应用） / Not yet active |
| 必需标识（同步） | Email OR phone（默认） / Email required / Phone required / Both required |
| 同步日志结果 | Added / Updated / Skipped / Disabled / Processed / Stale snapshot |
| 时间窗口状态 | Active / Upcoming / Expired / Stale / Unmapped |
| 会员状态标签 | Active、Current、Expired、On hold、Cancelled、Pending（以及来自您源系统的任何值） |
| Access Scope 模板 | Custom、Main entrances、Staff-only、Restricted area、24/7 access、Business hours、Vehicle access、Service entries |
| 自动消息模板 | No door access、Expired membership、Payment overdue、Account on hold / suspended、Welcome (new member)、Trial / prospect、Document / waiver required |
同步跳过原因
| 同步日志中显示的原因 | 含义 |
|---|---|
| Integration sync is turned off for this facility | 该来源的总开关已关闭 |
| This integration is turned off in sync settings | 该特定集成已被设为不参与同步 |
| No phone or email on the record (a phone or email is required to log in) | 该记录不符合必需标识规则 |
| Record is decoupled and managed manually | 该用户的 Track source updates 已关闭 |
| No facility on the source record | 源记录未关联到此设施 |
| No matching user record | 该变更引用的人员在此处没有记录行 |
运行限制
| 限制 | 值 |
|---|---|
| CSV 导入 | 每次导入 200 个用户 |
| 批量邀请 | 每批发送 50 封 |
| 批量删除预览示例 | 显示前 50 个用户 |
| 访问日志查询 | 每个时间段最多显示最近 500 个事件 |
| 访问事件保留期 | 约 13 个月，之后自动删除 |
| 管理员解锁指令有效期 | 30 秒（未送达则指令过期） |
| 门控制器心跳 | 约每 30 秒一次；静默 5 分钟后视为离线 |
| 登录验证码请求 | 每个手机号/电子邮箱每小时 5 次（安全限制，无法解除） |
| 应用注销生效 | 立即撤销；活动会话最多需要 15 分钟才能完全结束 |
| 保存门设置 | 重新加载控制器，通常需要 10–15 秒 |
| No visit recorded 保留期 | 约 13 个月 |
| Access Time Window 映射 | 每个集成 50 个 |
| 每个容器的 Access Time Windows | 50 个 |
| One-time 时间窗口跨度 | 90 天 |
| 每周时间块 | 每周每天 8 个 |
| 时间窗口/源 ID、标签、范围键 | 120 个字符 |
| 每个设施的 Access Policies | 100 项 |
| 策略时间窗口总数 | 500 个 |
| Access Policy 名称/ID | 120 个字符 |
| Access Policy 描述 | 500 个字符 |
| Access Policy 配置 | 300 KiB UTF-8 |