Исходный код вики Считывание QR-кодов
Редактировал(а) admin 2026/09/21 18:18
Последние авторы
| author | version | line-number | content |
|---|---|---|---|
| 1 | В данном разделе приведены сведения о настройке сервиса ввода данных посредством считывателя QR-кодов. | ||
| 2 | |||
| 3 | == Общие сведения == | ||
| 4 | |||
| 5 | Платформа НЕЙРОСС обеспечивает считывание QR-кодов. Передача информации из внешней системы посредством QR-кодов предпочтительна в ситуации наличия жестких сетевых ограничений и политик безопасности. Посредством QR-кода информация может быть передана из внешнего контура системы безопасности во внутренний без нарушения изоляции контуров друг от друга, тем самым нивелировав возможность взлома системы извне. Так например, может быть передана информация о владельце пропуска от внешней заявочной пропускной системы в АРМ НЕЙРОСС Доступ, исключив прямую передачу персональных данных. | ||
| 6 | |||
| 7 | **Порядок действий** | ||
| 8 | |||
| 9 | Для реализации возможности ввода данных владельца пропуска посредством считывания QR-кода вам потребуется: | ||
| 10 | |||
| 11 | 1. Настроить сканер QR-кодов для работы в режиме клавиатуры; | ||
| 12 | 1. Установить сервис обмена данными между физическим оборудованием (сканером QR-кодов) и веб-приложением Платформы НЕЙРОСС через протокол WebSocket; | ||
| 13 | 1. Настроить шаблон формы владельца пропуска с функционалом ввода данных с QR-кода. | ||
| 14 | |||
| 15 | (% class="box infomessage" %) | ||
| 16 | ((( | ||
| 17 | Проверка проводилась на сканере АТОЛ SB2108 Plus, настроенном в режим работы «виртуальный последовательный порт USB». | ||
| 18 | ))) | ||
| 19 | |||
| 20 | |||
| 21 | |||
| 22 | |||
| 23 | |||
| 24 | **Окружение** | ||
| 25 | |||
| 26 | (% class="wikigeneratedid" %) | ||
| 27 | Обеспечивается работа на рабочем месте АРМ НЕЙРОСС Доступ под управлением ОС семества Linux. Сервис считывания QR-кодов устанавливается непосредственно на рабочем месте оператора и работает локально. | ||
| 28 | |||
| 29 | == Настройка сканера QR-кодов == | ||
| 30 | |||
| 31 | Порядок настройки зависит от используемого оборудования и осуществляется согласно инструкции производителя. Важно настроить работу сканера в режиме клавиатуры. Требуется поддержка передачи данных данных в формате vCard. Для проверки правильности настройки рекомендуется: | ||
| 32 | |||
| 33 | 1. Открыть любой текстовой редактор; | ||
| 34 | 1. Отсканировать QR-код; | ||
| 35 | 1. Проверить соответствие полученных данных образцу ниже. | ||
| 36 | |||
| 37 | {{code}} | ||
| 38 | BEGIN:VCARD | ||
| 39 | VERSION:4.0 | ||
| 40 | FN:Иванов Иван Иванович | ||
| 41 | N:Иванов Иван Иванович | ||
| 42 | BDAY:1968-01-02 | ||
| 43 | BIRTHPLACE:гор. Ленинград | ||
| 44 | TITLE:Грузчик Оператор Перронной Техники | ||
| 45 | ADR:г Санкт-Петербург, р-н Фрунзенский, ул Будапештская, д 1 к 1, кв 1 | ||
| 46 | NALITY:RU | ||
| 47 | ORG:ООО "ВОЗДУШНЫЕ ВОРОТА СЕВЕРНОЙ СТОЛИЦЫ" | ||
| 48 | TEL:+79215555555 | ||
| 49 | X-PASSPORT-NUMBER:4013770000 | ||
| 50 | X-PASSPORT-ISSUED:2014-02-04 | ||
| 51 | X-PASSPORT-AUTHORITY:ТП № 139 ОУФМС России по Санкт-Петербургу и Ленинградской обл. в Центральном районе г. Санкт-Петербурга | ||
| 52 | END:VCARD | ||
| 53 | {{/code}} | ||
| 54 | |||
| 55 | == Настройка сервиса COM-порта == | ||
| 56 | |||
| 57 | {{warning}} | ||
| 58 | Сервис устанавливается и настраивается на компьютере, к которому подключен считыватель QR-кодов, и на котором установлено приложение АРМ НЕЙРОСС Доступ. | ||
| 59 | {{/warning}} | ||
| 60 | |||
| 61 | Сервис поставляется в виде dep-пакета. | ||
| 62 | |||
| 63 | {{code}} | ||
| 64 | neyross-com-to-websocket-1.0.79.deb | ||
| 65 | {{/code}} | ||
| 66 | |||
| 67 | Номер версии может отличаться. | ||
| 68 | |||
| 69 | Установите и запустите сервис. При работе в среде ОС Ubuntu используйте следующий набор команд: | ||
| 70 | |||
| 71 | {{code}} | ||
| 72 | sudo dpkg -i package_name.deb | ||
| 73 | sudo systemctl enable com-to-websocket-service.service | ||
| 74 | sudo systemctl start com-to-websocket-service.service | ||
| 75 | sudo systemctl status com-to-websocket-service.service | ||
| 76 | {{/code}} | ||
| 77 | |||
| 78 | |||
| 79 | Настройка сервиса осуществляется посредством веб-интерфейса. доступном по порту## 3002##. | ||
| 80 | |||
| 81 | Введите в адресной строке браузера: | ||
| 82 | |||
| 83 | {{code}} | ||
| 84 | localhost:3002 | ||
| 85 | {{/code}} | ||
| 86 | |||
| 87 | Откроется окно интрерфейса. | ||
| 88 | |||
| 89 | [[image:QR-reader-service.png||height="444" width="900"]] | ||
| 90 | |||
| 91 | По умолчанию настройка сервиса не требуется, но при необходимости вы можете выполнить требуемые настройки. | ||
| 92 | |||
| 93 | Настройки сохраняются в файле ##config.yaml ##в директории приложения: | ||
| 94 | |||
| 95 | {{code}} | ||
| 96 | usr/share/neyross-com-to-websocket/ | ||
| 97 | {{/code}} | ||
| 98 | |||
| 99 | Формат файла приведен ниже. | ||
| 100 | |||
| 101 | {{code language=" python"}} | ||
| 102 | # Пример конфигурационного файла для com-to-websocket-service | ||
| 103 | |||
| 104 | # Настройки COM-порта | ||
| 105 | com: | ||
| 106 | # Путь к COM-порту (для Linux: /dev/ttyACM0) | ||
| 107 | port: /dev/ttyACM0 | ||
| 108 | # Скорость передачи данных (baud rate) | ||
| 109 | baudrate: 115200 | ||
| 110 | # Таймаут чтения из COM-порта (в миллисекундах) | ||
| 111 | timeout: 100 | ||
| 112 | |||
| 113 | # Настройки HTTP сервера | ||
| 114 | server: | ||
| 115 | # Хост, на котором будет запущен сервер | ||
| 116 | # По умолчанию: 127.0.0.1 (только локальные подключения) | ||
| 117 | # Для доступа с других машин: 0.0.0.0 | ||
| 118 | host: 127.0.0.1 | ||
| 119 | # Порт сервера | ||
| 120 | port: "3002" | ||
| 121 | {{/code}} | ||
| 122 | |||
| 123 | (% class="box warningmessage" %) | ||
| 124 | ((( | ||
| 125 | При изменении номера порта потребуется скорректировать шаблоны форм. | ||
| 126 | ))) | ||
| 127 | |||
| 128 | == Настройка шаблонов формы владельца пропуска == | ||
| 129 | |||
| 130 | Шаблон формы поставляется в виде готового файла формата JSX. Загрузите полученный файл шаблона для требуемой группы пропусков ~[[[Готовый шаблон формы>>doc:neyross.setup.access-control.input-forms.form-template.WebHome]]]. | ||
| 131 | |||
| 132 | [[image:QR-form_template.png]] | ||
| 133 | |||
| 134 | == Сканирование данных == | ||
| 135 | |||
| 136 | Запустите АРМ НЕЙРОСС Доступ. | ||
| 137 | |||
| 138 | Выберите группу пропусков, для которой настроен шаблон формы. | ||
| 139 | |||
| 140 | Нажмите на кнопку **Создать владельца пропуска**. | ||
| 141 | |||
| 142 | В форме нажмите на кнопку **Сканировать QR-код**. Отобразится окно ожидания данных. | ||
| 143 | |||
| 144 | [[image:QR-reading.png||height="208" width="400"]] | ||
| 145 | |||
| 146 | Считайте код с помощью сканера. | ||
| 147 | |||
| 148 | Проверьте и, при необходимости, откорректируйте/дополните полученные данные. | ||
| 149 | |||
| 150 | Сохраните изменения. | ||
| 151 | |||
| 152 | Если сканер отключен и/или сервис недоступен отобразится окно ошибки. | ||
| 153 | |||
| 154 | [[image:QR-reader-error.png||height="209" width="400"]] |