Интеграция ClubIS с системой контроля доступа Hikvision: синхронизация клиентов, фото и автомобилей, приём событий проходов и восстановление пропущенных посещений.
Настройки открываются в Администратор → Интеграции → Биометрия → Hikvision.
После сохранения ClubIS сам отправляет изменения клиентов (фото, карты, доступ, автомобили) в Hikvision в фоне. Кнопка Синхронизировать ставит задание сверки: ClubIS проверяет, у кого в Hikvision нет фото, устарели сроки доступа клиента или данные по автомобилям, и догоняет недостающее.
При включённой интеграции в шаблоне на вкладке Доступ доступен флажок Доступ по группе Hikvision: клиенты по этому шаблону выгружаются в выбранную организацию Hikvision.
Путь: Менеджер → Настройки → Шаблоны → нужный шаблон → Доступ.
Если у интервала включён Доступ отдельно от шаблона, ту же настройку можно задать на интервале.
Пока служба web-service работает, изменения из анкеты не зависят от того, доступен ли Hikvision в момент сохранения: задание попадает в очередь и выполняется позже.
Сроки доступа клиента в Hikvision берутся из действующего договора (начало и дата с учётом заморозки). При продлении, смене дат или заморозке договора ClubIS ставит в очередь обновление клиента; после записи сверяет сроки в Hikvision с договором — задание считается выполненным только когда даты совпадают. Если во время отправки договор снова изменился, это изменение не теряется и уходит следующим заданием.
Задание считается выполненным, когда данные приняты сервером Hikvision. Проливка на отдельные контроллеры доступа — зона самой системы Hikvision. Если часть приборов не отвечает или не принимает доступ, это нужно смотреть и чинить в Hikvision; в очереди ClubIS из‑за таких приборов задания с ошибкой не появляются.
Очередь обрабатывается по приоритету: сначала анкеты и фото, затем повторная выгрузка, затем автомобили, затем сверка. Большое число задач по автомобилям не должно задерживать выгрузку клиентов.
В блоке Hikvision доступны:
Дополнительно можно указать:
Если фото сохранили в анкете при недоступном Hikvision, после восстановления связи очередь сама догонит отправку. При необходимости используйте Догнать недостающих фото или Повторить failed.
Чтобы разобраться, у кого именно зависла или упала синхронизация, откройте монитор очереди одним из способов:
В мониторе видно:
Строки с ошибкой подсвечены красным, задания в работе — жёлтым, ожидающие — голубым.
Удобные фильтры:
Действия:
Перед массовым повтором посмотрите тип задания и текст ошибки. Если много ошибок по автомобилям с текстом вроде «already exists» или «vehicle is exist» (номер уже есть в Hikvision), сначала разберите конфликт в Hikvision или в анкете и повторяйте точечно через Повторить выбранные. Иначе Повторить все ошибки снова заполнит очередь теми же сбоями.
В таблице показывается до 5000 заданий текущего фильтра. Если записей больше, сузьте фильтр по статусу или по тексту ошибки.
ClubIS передаёт в Hikvision номер автомобиля и срок действия вместе с доступом клиента. Сроки доступа клиента и автомобиля берутся из действующего договора (начало и дата с учётом заморозки) и после синхронизации должны совпадать с тем, что видно в Hikvision.
Если номер уже есть в Hikvision, ClubIS находит эту запись, обновляет её и при необходимости заново связывает с анкетой — дубликат не создаётся.
Если номер в Hikvision уже занят так, что ClubIS не может безопасно обновить запись, задание по автомобилю завершается с ошибкой и не блокирует выгрузку анкет и фото. Такие случаи разбирают в мониторе очереди (см. выше).
В поле URL приёма событий укажите адрес службы web-service, на который Hikvision будет отправлять события проходов, например:
https://host:port/hikvision
где host и port — адрес и порт службы web-service.
После настройки ClubIS принимает события проходов в реальном времени и дополнительно подтягивает пропущенные события, если кратковременно пропала связь.
Если за период накопилось много пропущенных проходов, их можно восстановить вручную.
Период догона не должен превышать 31 день. Одновременно выполняется только одно задание догона.
После завершения ClubIS покажет результат: сколько событий получено, сколько посещений записано, сколько оказалось дубликатами или непарными.
Непарные события (например, вход без выхода) остаются без записи посещения и отображаются в итоге задания.
Соответствия кодов для интеграции настраиваются в справочнике Коды для Hikvision.