Справочник
На этой странице
Исчерпывающие таблицы по 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 | Все двери объекта, области доступа, отдельные двери или их сочетания; в пределах политики приоритет имеют исключения |
| When | Anytime или объединённые по ИЛИ окна 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 секунд |
| Режим обслуживания | Normal | Normal / Force open / Force closed |
| Звук открытия двери | Выкл. | Вкл. / Выкл. |
| Метка расположения двери | — | Произвольный текст, не более 64 символов |
| Значок | Door | 10 вариантов (см. ниже) |
| Расписание автоматического открытия | Выкл. | Часы присутствия персонала на объекте или 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 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 | Изменение относится к человеку, у которого здесь нет строки |
Эксплуатационные ограничения
| Ограничение | Значение |
|---|---|
| Импорт 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 на день недели |
| Идентификатор окна или источника, метка, ключ области | 120 символов |
| Access Policies на объект | 100 |
| Всего окон политик | 500 |
| Название / идентификатор Access Policy | 120 символов |
| Описание Access Policy | 500 символов |
| Конфигурация Access Policy | 300 KiB UTF-8 |