Skip to main content

Schedules and holidays

A schedule says when: a set of weekly time windows. Access groups use schedules to say when their members may pass each door (Access groups). Holidays are dates on which every schedule uses its holiday windows instead of the weekday's.

Everyone can see schedules and holidays; creating and changing them needs the Tenant admin role.

Schedules​

Schedules shows every schedule as a card with its week at a glance and how many access group doors use it (3 group doors).

Choose New schedule, or a schedule to open it. A schedule has:

FieldMeaning
Name1–100 characters, unique in the tenant (name_taken).
DescriptionOptional, up to 500 characters.
WeekThe time windows of each day (below).

Choose Save. The controllers that use the schedule receive it at once (Schedule saved: controllers using it are updated.).

Edit the week​

Each day (Monday to Sunday, and Holidays) has zero or more windows, from a start time to an end time. A day without windows is Closed.

  • Presets fills the whole week: Office hours (Mon–Fri 08:00–18:00), Always (24/7) (every day and holidays, all day), or Clear.
  • Add window adds a window to a day; Copy Monday to Tuesday–Friday copies Monday's windows.
  • A window includes its start and excludes its end: 08:00–18:00 lets people in from 08:00:00 to 17:59:59. For a whole day use 00:00–24:00.
  • Each window must end after it starts (Each window must end after it starts.). Overlapping windows of the same day are merged when you save.
  • A schedule has at most 64 windows.

Holiday windows​

On a date listed under Holidays, the schedule uses its Holidays windows instead of that weekday's. With no holiday windows, the schedule is Closed on holidays: badges are refused with the reason holiday.

The Office hours preset has no holiday windows, so offices stay closed on holidays; Always (24/7) includes them.

Holidays​

The Holidays card on the Schedules page lists the tenant's holidays. Enter a Date and the name of the Holiday, and choose Add; the bin icon deletes one. Each date can be a holiday once (holiday_exists).

Holidays apply to every schedule, in every site of the tenant. Adding or deleting one sends a new configuration to every controller of the tenant. Each configuration carries the holidays from the day before up to 90 days ahead. Holidays further ahead reach the controllers by themselves as they come within those 90 days.

Time zones​

Controllers apply schedules in local time:

  1. the time zone of the controller's site (Sites);
  2. for a controller without a site, the tenant's Default time zone (Tenant settings);
  3. otherwise UTC.

Changing a site's or the tenant's time zone sends a new configuration to the controllers concerned.

Deleting a schedule​

Open the schedule and choose Delete. A schedule that access groups use cannot be deleted (schedule_in_use): pick another schedule for those doors first. Used by on the schedule's page shows how many group doors use it.

Limits​

  • One controller can hold at most 255 schedules: the schedules of all the access group doors on that controller. With more, its configuration fails with too_many_schedules (Configuration sync).
  • 64 windows per schedule.