Экспорт данных в СКУД «Орион Про» (Болид) (XML/SOAP)
Модуль передачи данных в Систему контроля и управления доступом (СКУД) Сервиса по оформлению заявок на пропуск на объекты транспортной инфраструктуры операторов морских портов и аэропортов (далее «Сервис») предназначен для автоматической передачи данных об оформленных заявках на пропуск из Сервиса в СКУД. Модуль получает данные от Сервиса через стандартный механизм передачи данных во внешние информационные системы, а затем передает их дальше в СКУД через специфические протоколы, свойственные конкретной СКУД.
В данном разделе описывается механизм интеграции со СКУД «Орион Про» (Болид) через XML/SOAP WEB-сервис. Сервис интеграции разработан на основании документации, представленной разработчиком СКУД «Орион Про» (Болид).
Для обеспечения безопасности передачи данных между серверами Сервиса и СКУД устанавливается защищенное VPN соединение (VPN-сервер на стороне СКУД, VPN-клиент на стороне Сервиса).
Настройка доступа
Для передачи данных в СКУД «Орион Про» (Болид) на стороне СКУД должен быть подключен и настроен модуль интеграции «Орион Про». Стоит обратить внимание, что порт по умолчанию (8090) может блокироваться некоторыми провайдерами, поэтому рекомендуется его поменять на какой-нибудь другой.
Для настройки доступа нужно запустить программу Администратор базы данных (АБД), входящую в состав СКУД «Орион Про» (Болид). В ней перейти в экран «Пароли». В нижней части экрана нажать кнопку «Добавить». В поле «Сотрудник» выбрать сотрудника, от имени которого будет работать сервис «Конверста», в поле «Тип кода» указать «Удаленное управление». В поле «Логин» ввести имя пользователя (например, konversta). Затем нажать на поле «Код» и в появившемся диалоговом окне установить пароль и нажать на кнопку «ОК». Затем установить необходимый уровень доступа и нажать на кнопку «Сохранить» в нижней части экрана.
Сервис авторизовывается в СКУД с помощью метода GetLoginToken. Токен автоматически продлевается через заданный промежуток времени методом ExtendTokenExpiration (обычно данный параметр соответствует значению TokenLifeTime, заданному в настройках СКУД уменьшенному на одну секунду).
Из сервиса в СКУД передаются следующие данные из заявки на пропуск:
Организации
Сервис берет организацию из заявки на пропуск и вначале ищет данную организацию в СКУД по наименованию (методом SearchCompany) и, если такая организация не найдена, добавляет ее в СКУД (методом CreateCompany). Организации могут передаваться в СКУД либо из секции «Заявитель» (организация, от имени которой подавалась заявка), либо из секции «Посетители» (если такая организация задана для посетителя и отличается от организации-заявителя).
В СКУД в наименование организации можно добавлять ИНН, например, ООО "НАИМЕНОВАНИЕ" – 7812345678 (определяется настройками).
В сервисе также можно настроить нормализацию наименований организаций: с кавычками / без кавычек (ООО "НАИМЕНОВАНИЕ" / ООО НАИМЕНОВАНИЕ), форма собственности в начале / в конце (ООО НАИМЕНОВАНИЕ / НАИМЕНОВАНИЕ ООО).
Должности
Сервис вначале ищет должность посетителя в справочнике должностей в СКУД (методом SearchPosition) и, если такая должность не найдена, добавляет ее в СКУД (методом CreatePosition).
Посетители
Сервис вначале ищет в СКУД посетителя по внутреннему идентификатору сервиса «Конверста» методом GetPersonByExternalId. Если посетитель с таким идентификатором не найден, то поиск осуществляется по фамилии, имени отчеству, дате рождения, серии и номеру документа методом GetPersons. Если посетитель с заданными параметрами найден, то повторно в СКУД он не передается, данные по нему не обновляются. Если не найден, то посетитель передается в СКУД методом AddPerson. В СКУД передаются фамилия, имя, отчество, дата рождения, серия и номер, дата выдачи, дата окончания срока действия документа, удостоверяющего личность, код и наименование подразделения, выдавшего документ, организация, должность, а также фотография посетителя, если она была загружена в заявку на пропуск.
Понятия «посетитель» и «сотрудник» в СКУД «Орион Про» (Болид) несколько отличаются от общепринятых понятий для объектов транспортной инфраструктуры. В частности, в СКУД «Орион Про» (Болид) посетитель не может быть привязан к какой-либо организации. Поэтому чтобы не потерять привязку посетителя к организации все посетители по умолчанию передаются в СКУД со статусом «Служащий» (Status=6), а не со статусом «Посетитель» (Status=6). Если для отдельных категорий посетителей (для сотрудников ОТИ или сотрудников ГКО) нужно передавать иной статус, такую особенность нужно согласовать с оператором сервиса в процессе настройки модуля интеграции.
Транспортные средства
Сервис получает из СКУД список транспортных средств методом GetCars и ищет в нем нужное транспортное средство (ТС) по государственному регистрационному знаку ТС. Если ТС найдено, то повторно в СКУД оно не добавляется, информация по нему не обновляется. Если ТС не найдено, то оно передается из Сервиса в СКУД методом AddCar. Заполняются поля «Номер» (государственный регистрационный знак), «Модель» (в него записывается марка и модель ТС из Сервиса через пробел) и «Цвет». Поле «VIN» не заполняется. Также в СКУД передается привязка транспортного средства к посетителю методом AddPersonCar.
Дополнительные поля
Для каждого посетителя в СКУД можно добавить дополнительные поля. Сервис может передавать в каждое дополнительное поле одно или несколько полей (комбинацией констант и полей сервиса из заданной структуры). В какое дополнительное поле СКУД какую комбинацию полей Сервиса нужно передавать, задается настройками Сервиса (настраивается оператором сервиса на этапе подключения и настройки сервиса).
Например, в дополнительное поле СКУД можно передать строку «срок действия пропуска» в виде «с 01.02.2025 по 28.02.2025» путем комбинации строковых констант (предлогов «с» и «по») и полей сервиса «дата начала действия» и «дата окончания действия».
Пропуск (заявка на пропуск)
Перед настройкой Сервиса оператору сервиса нужно сообщить, какой уровень доступа нужно присваивать тем или иным посетителям в зависимости от параметров заявки (например, территорий посещения).
...