Руководство по установке плагинов биометрии

ВНИМАНИЕ! Biometria 2.0 РАБОТАЕТ С iiko 7.4.6 + так как поддерживается API v7 Preiwie на чем и разработан плагин 

Перед установкой плагина необходимо создать заявку (https://pyrus.com/t#uf565461 )на добавление клиента в централизованный сервер!
НЕ ВАЖНО БЫЛА ЛИ У КЛИЕНТА БИОМЕТРИЯ ДО ЭТОГО, ПОЖАЛУЙСТА СОЗДАЙ ЗАЯВКУ.
Необходимо прислать следующую информацию:

• Наименование организации клиента.
• Адрес сервера клиента и порт.
• Логин и пароль от учетной записи(с правами администратора) от iiko
  После этого будет выдан пароль от апи клиента централизованного сервера(он нужен при настройке).

1. Установка плагина для iiko Office

Свежие плагины можно брать тут https://repo.open-s.info/projects/iiko/Biometric/

Драйвер необходимо установить на все компьютеры которые будут общаться с контроллерами (т.е. и на фронтовые терминалы и на компьютер с бэком) В архиве Drivers лежат две папки и установщик, тут очень важно делать все в описанном порядке!

Если вы не используете механизм авторизации с iikoOffice с помощью биометрии:

• Распаковываем папку ThirdParty заходим в ThirdParty\64bit, если у вас 64х разрядная система, или в ThirdParty\32bit, если у вас 32х разрядная система. Запускаем от имени Администратора, соответственно, Register_SDK_x64.bat или Register_SDK_x86. Дожидаемся регистрации всех dll;

• Устанавливаем драйвер ZKOnline (тоже от имени Администратора);

  
  

  2. Установка плагина для iiko Office

  ---

  • Архив BeOpen.iiko.Back.Biometric распаковываем в папку «C:\Program Files\iiko\iikoRMS\Office\Plugins»

    выглядит это вот так!
  • Так же необходимо в корень папки(C:\Program Files\iiko\iikoRMS\Office) положить ZK.exe и ZK.exe.config

  3. Установка плагина для iiko Front

  ---

  BeOpen.iiko.Front.Biometric

  • Копируем папку с плагином в «C:\Program Files\iiko\iikoRMS\Front.Net\Plugins»

  • Так же необходимо поставить cardslideemulator и StrokeIt:

    https://www.tcbmi.com/strokeit/downloads.shtml

  4. Конфигурация back и front плагинов

  ---

  • Необходимо зайти в backoffice. Слева, в меню, появится вкладка BeOpenBiometric, необходимо зайти в нее, нажать на кнопку «Сотрудники».

  

  • После этого необходимо нажать "Изменить настройки" и  появится окно:

    

    Левая колонка относится к back плагину, здесь :

    1. Логин и пароль (тот что мы выдали тебе в заявке).
    2. Адрес чейна или рмс(если используется функция проброса явок на сервер). 

Правая колонка относится к front плагину, здесь:

1. Порог - пороговый процент распознавания отпечатка(% совпадения отпечатка для корректного срабатывания. Если у вас плохо читается отпечаток, можно его понизить).

2. Количество попыток - Максимальное количество попыток прикладывания пальца к сканеру.

3. Количество минут на синхронизацию - настройка периодичности синхронизации в минутах.

4. Ключ Sentry - SSH ключ багтрекера. Не менять.

5. Адрес сервера iiko

6. Имя пользователя - Имя пользователя front и back

7. Пароль - Пароль пользователя front и back
   
   

   Конфигурация iikoFront

   
   Значение TimeControl по умолчанию false, если необходимо пробрасывать явки на прямую в чайн(либо в другой рмс), то ставим значение true, функция разблокировки iikoFront по пальцу доступна не будет. Данное решение предназначено только для учета рабочего времени сотрудников.

   

   Для использования этого функционала в конфиге BeOpen.iiko.Front.Biometric.dll.config необходимо выставить значение SetDefaultDepartment true и TimeControl true.

   Если вы уверены в том, что вам необходим данный функционал, то производим данную настройку и  запускаем iikoFront.
   Прикладываем палец сотрудника для открытия явки.

   
   Когда сотрудник будет заканчивать смену необходимо приложить палец повторно и явка будет закрыта.

   

   Так же для данного решения используется лицензия REST API
   
   

Перенос данных со старого сервера

Если необходим перенос данных, то необходимо нажать кнопку "Перенести настройки", в первую строку ввести адрес старого сервера например http://rr9.open-s.info:8110/bio/, во вторую строку ввести номер сервера(выдается из заявки на регистрацию клиента). Если у клиента много отпечатков пальцев перенос может занять какое то время, дождитесь когда окно закроется.

Руководство по использованию плагина биометрии.

1.Регистрация отпечатка сотрудника

• Заходим в бэкофис;

• Вкладку видно только пользователям с ролью администратор или кастомной ролью ACS;

• 

• Заходим в пункт «Сотрудники» на вкладке Biometric;

• Далее выбираем сотрудника и кликаем по ячейке «Отпечатки», как показано на рисунке;

• Ждем открытия второго окна, выбираем палец и плотно прикладываем его 3 раза пока не загорится зеленая галочка. Если она не загорится то надо снова выбрать палец и попробовать еще раз. Можно занести несколько пальцев для одного сотрудника;
  Если в утилите выходит ошибка что сканер не обнаружен, необходимо проверить все ли драйвера установлены, так же если используются и фронт и бэк плагины на одной машине, то фронт с плагином при внесении пальцев должен быть выключен, так как он занимает сканер. 

• После этого у сотрудника появится галочка в графе «Отпечатки»;

• Если карты у сотрудника не было то необходимо сохранить автоматически сгенерированную карту во вкладке Сотрудники;

2.Использование решения на фронте

• После регистрации сотрудников, на фронте необходимо нажать кнопку «Синхронизировать устройства»;

• С помощью маленького считывателя происходит авторизация сотрудника на кассе;

  Инструкция для сотрудников по использованию системы учета рабочего времени BeOpen Biometric(при использовании сетевого сканера)

  В начале смены сотрудник должен приложить палец, который ранее заносил в систему. Прикладывать нужно до тех пор, пока сканер не издаст 2 коротких звуковых сигнала и индикатор не загорится зеленым цветом. Прикладывать необходимо всю крайнюю фалангу пальца не очень сильно. Если сканер не распознает палец, то нужно попробовать приложить другой, который также должен быть внесен в систему. В конце смены также необходимо повторить процедуру.

  Лицензии

  ---

  Для работы продукта необходимы лицензии:

  • Необходима лицензия APIServer(при использовании TimeControl)