Справочник

На этой странице

Исчерпывающие таблицы по 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 не нацелена на эту дверь для данного запросаДобавьте дверь или её область доступа в политику либо используйте цель «все двери»
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."Телефон не передал пригодное местоположениеУчастник включает для приложения Location (Precise)
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Все двери объекта, области доступа, отдельные двери или их сочетания; в пределах политики приоритет имеют исключения
WhenAnytime или объединённые по ИЛИ окна Weekly и One-time
Другие пути доступаПостоянные разрешения и окна, выданные администратором или интеграцией, остаются отдельными и суммируются
БезопасностьПроверки удалённых, отключённых или заблокированных синхронизацией пользователей, удаления или блокировки двери, режима обслуживания, геозоны, ограничений частоты и контроллера по-прежнему действуют
Существующая конфигурацияАвтоматически импортируется в эквивалентные именованные политики с явными Who, Where и When

Атрибуция политик

Журналы доступа указывают подходящую политику по названию и могут показывать её аудиторию, цель и расписание. Для совпадений по расписанию также могут указываться конкретные начало и конец активного окна.

Справочник по Access Time Window

СвойствоЗначение
АвторизацияОкна расписания политики являются её параметром When; окна, выданные администратором или интеграцией, — отдельные суммирующиеся пути доступа
Абсолютная границаЦелочисленные моменты UTC в секундах Unix, [from, to)
Абсолютный часовой поясМетаданные для отображения и аудита; не сдвигает метки времени
Граница WeeklyМестные блоки HH:mm с невключаемым концом
Часовой пояс WeeklyДопустимый часовой пояс IANA, определяющий местные день и время, а также переход на летнее время
Пределы WeeklyНеобязательные начало и окончание действия в секундах Unix; конец не включается
Через полночь / пересечениеНе допускается; разделяйте ночные периоды по дням и не допускайте пересечения блоков
Владение у пользователяОкна администратора и каждого источника интеграции изолированы; одно не может стереть другое
Область интеграцииСтабильный ключ источника scope_key, по умолчанию default, сопоставляемый с целями в PH; неизвестные или несопоставленные ключи приводят к отказу
Актуальность источникаНастраивается в соответствии с частотой обновления каждой интеграции; поведение при устаревшем источнике должно быть задано явно
БезопасностьНикогда не обходит проверки отключённых, удалённых или конфликтующих пользователей, blockAllAccess, режима обслуживания, геозоны, ограничений частоты и контроллера

Начальные ограничения: 50 окон на один контейнер политики, разрешения или источника; максимальная абсолютная продолжительность — 90 дней; 120 символов для идентификаторов, меток и ключей областей; восемь недельных блоков в день; вновь записываемые записи не могут быть просрочены более чем на один час.

Параметры, значения по умолчанию и диапазоны

Параметры двери

ПараметрПо умолчаниюДиапазон / варианты
Время удержания10 секунд1–30 секунд
Режим обслуживанияNormalNormal / Force open / Force closed
Звук открытия двериВыкл.Вкл. / Выкл.
Метка расположения двери—Произвольный текст, не более 64 символов
ЗначокDoor10 вариантов (см. ниже)
Расписание автоматического открытияВыкл.Часы присутствия персонала на объекте или Custom schedule, часовой пояс объекта
Время Unlock / Lock для автоматического открытияAt opening / At closingAt opening / At closing или за 5, 10, 15, 30, 45, 60, 90 либо 120 минут до или после
Автоматическое открытие в государственные праздникиIgnore holidaysFollow the facility's holiday hours / Stay locked all day / Ignore holidays
Авторизация доступа (для двери)Access PoliciesСписок подходящих политик и возможность blockAllAccess
Геозона (для двери)Inherit from facilityInherit 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 m50–5000 m (шаг 10 m; предустановки 50 / 200 / 500 / 1000 m)
Запас точности25 m—
Require GPS accuracy better than100 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-prompting5 минутAlways prompt / 1 min / 5 min / 15 min / 30 min / 1 hour
Поведение при нескольких объектах—Блокировка обязательна, если её требует любой привязанный объект; используется самый короткий льготный период среди таких объектов

Контакты поддержки

РежимПоведение
Smart (default)Отображаются автоматически, когда дверь не в сети или в интерфейсе недостаточно информации
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 символов
Мобильный телефон / адрес электронной почтыОбязательно хотя бы одно из них (используется для входа по одноразовому коду); номера телефонов приводятся к международному формату
Теги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 (а также любые значения из вашей исходной системы)
Шаблоны областей доступа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Изменение относится к человеку, у которого здесь нет строки

Эксплуатационные ограничения

ОграничениеЗначение
Импорт CSV200 пользователей за один импорт
Массовые приглашенияОтправляются пакетами по 50
Образец предварительного просмотра массового удаленияПоказываются первые 50 пользователей
Запрос журналов доступаДо 500 последних событий на одно окно
Хранение событий доступа~13 месяцев, затем удаляются автоматически
Срок действия команды открытия администратором30 секунд (если команда не доставлена, она истекает)
Контрольный сигнал дверного контроллераПримерно каждые 30 секунд; не в сети после 5 минут молчания
Запросы кода для входа5 в час на один телефон или адрес электронной почты (ограничение безопасности, снять нельзя)
Распространение выхода из приложенияДоступ отзывается немедленно; полное завершение активного сеанса занимает до 15 минут
Сохранение настроек двериПерезагружает контроллер — обычно 10–15 секунд
Хранение No visit recorded~13 месяцев
Сопоставления Access Time Window50 на интеграцию
Access Time Windows на контейнер50
Продолжительность окна One-time90 дней
Недельные блоки8 на день недели
Идентификатор окна или источника, метка, ключ области120 символов
Access Policies на объект100
Всего окон политик500
Название / идентификатор Access Policy120 символов
Описание Access Policy500 символов
Конфигурация Access Policy300 KiB UTF-8