访问策略时间表
本页内容
时间是每个 Access Policy 的 When 部分。选择 Anytime 或 Scheduled；计划型策略包含一个或多个 Weekly 或 One-time 时间窗口。有关 Settings → Access Time Windows 页面，请参阅宽限期和时区。
只有当 Who AND Where AND When 全部匹配时，一个策略才会授予访问权限。一个策略内的多个时间窗口之间是“或”（OR）的关系，多个具名策略之间也是“或”的关系。策略都是仅允许型的：未生效的策略不会撤销由其他匹配策略、永久授权或独立的管理员/集成时间窗口授予的访问权限。
任何时候
Anytime 表示策略的 Who 和 Where 可以在没有时间表限制的情况下匹配。它不会绕过安全、维护、地理围栏、封禁、速率限制或设备检查。
Weekly 时间窗口
Weekly 时间窗口使用当地挂钟时间段重复，例如星期一 06:00–08:30。
- 所选的 IANA 时区决定星期、当地时间和夏令时行为。
- 可选的生效起始和生效截止时刻可以限定重复范围；结束时刻不包含在内。
- 时间段不能重叠，也不能跨越午夜。请将跨夜时段拆分到两天。
- 在夏令时开始（时钟拨快）时，被跳过的当地时间不会出现。在夏令时结束（时钟拨慢）时，重复的当地时间所代表的两个实际时刻都符合条件。
One-time 时间窗口
One-time 时间窗口有一个精确的开始时刻和结束时刻。可将其用于已知的一次性时段。
- 开始和结束时间为整数 Unix 秒，表示 UTC 时刻。
- 边界为左闭右开区间：
[from, to)。开始时刻符合条件；结束时刻不符合。 - 显示的时区用于输入、显示和审计上下文。它不会更改已存储的时刻。
独立的用户时间窗口和集成时间窗口
管理员拥有的用户时间窗口和集成提供的时间窗口仍是独立的附加途径；它们不会被转换为 Access Policies，也无法通过编辑策略来移除。它们可以根据各自的约定以设施、门或 Access Scopes 为目标。
集成时间窗口保留来源归属、修订版本、数据时效和 scope_key 映射行为。未知、已禁用、未映射、已过时或已解除关联的来源时间窗口不会授予访问权限。一个来源无法清除另一个来源的时间窗口，来源更新和策略编辑也都不会清除管理员拥有的时间窗口。
永久授权是另一条独立的附加途径。其现有的可选营业时间仍独立于策略时间表。
宽限期和时区
图 1：Settings → Access Time Windows → Access grace periods
Settings → Access Time Windows → Access grace periods 用于设置人员在其计划时间窗口前后可获得的宽限时间。“Scheduled start and end times remain unchanged. These buffers only expand when door access is allowed.”（计划的开始和结束时间保持不变。这些缓冲时间仅扩展允许门禁访问的时段。）
- 设施时区：Weekly 时间窗口使用的时区，会自动遵循夏令时变化。使用 在设施及系统配置中更改时区 进行更改；请参阅时区。
- Allow early access：“Allow users to unlock doors shortly before their scheduled window starts.”（允许用户在其计划时间窗口开始前不久解锁门。）可选 Off、5 minutes、10 minutes、15 minutes 或 30 minutes。
- Allow access after end：“Keep door access available briefly after the scheduled window ends.”（在计划时间窗口结束后短暂保持门禁访问可用。）可选 Off、5 minutes、10 minutes、15 minutes 或 30 minutes。
宽限期适用于设施中的所有 One-time 和 Weekly 时间窗口，包括由预订集成提供的时间窗口。它们也会计入 No visit recorded：在宽限期内解锁的人员视为已到访。例如，酒店可以将 Allow access after end 设置为 15 分钟，以便为使用宾客通行证的客人延迟退房提供便利。
现有时间表
现有的营业时间会自动导入到相应 Access Policies 的 When 部分。以前适用于特定范围或门的不同时间会保留在具有明确 Where 目标的策略中。管理员无需手动转换时间表。
授权和可用性
对于会员访问，系统会先运行用户和门的安全检查。然后，服务器会评估策略、永久授权、管理员时间窗口和集成时间窗口这些允许途径。地理围栏和控制器检查仍是随后具有决定性的关卡。
未来的策略时间窗口可以返回结构化的可用性信息，包括其下一个具体的开始/结束时间、类型、标签和时区。受支持的客户端会使用这些数据进行显示；它们不会在本地计算授权。精确边界仍为 [from, to)。
未来时间窗口的详细拒绝原因为 outside_access_time_window。兼容客户端可以继续收到现有的 outside_access_hours 原因，并附带 deniedReasonDetail: outside_access_time_window。
归因
策略判定会按名称标明匹配的策略。对于计划访问，访问日志还可以显示当前生效的时间窗口及其具体开始和结束时间，从而清楚地表明是哪个 When 条目授予了访问权限。