Изменения документа Считывание QR-кодов

Редактировал(а) admin 2026/09/21 18:18

От версии 3.1
отредактировано admin
на 2026/09/21 16:51
Изменить комментарий: К данной версии нет комментариев
К версии 16.2
отредактировано admin
на 2026/09/21 18:18
Изменить комментарий: Short URL code assigned

Сводка

Подробности

Свойства страницы
Содержимое
... ... @@ -10,13 +10,22 @@
10 10  
11 11  1. Настроить сканер QR-кодов для работы в режиме клавиатуры;
12 12  1. Установить сервис обмена данными между физическим оборудованием (сканером QR-кодов) и веб-приложением Платформы НЕЙРОСС через протокол WebSocket;
13 -1. Настроить формы владельца пропуска с функционалом ввода данных с QR-кода.
13 +1. Настроить шаблон формы владельца пропуска с функционалом ввода данных с QR-кода.
14 14  
15 15  (% class="box infomessage" %)
16 16  (((
17 -Проверка проводилась на сканере АТОЛ SB2108 Plus,  настроенном в режим работы «виртуальный последовательный порт USB».
17 +Проверка проводилась на сканере АТОЛ SB2108 Plus,  настроенном в режим работы «виртуальный последовательный порт USB».
18 18  )))
19 19  
20 +
21 +
22 +
23 +
24 +**Окружение**
25 +
26 +(% class="wikigeneratedid" %)
27 +Обеспечивается работа на рабочем месте АРМ НЕЙРОСС Доступ под управлением ОС семества Linux. Сервис считывания QR-кодов устанавливается непосредственно на рабочем месте оператора и работает локально.
28 +
20 20  == Настройка сканера QR-кодов ==
21 21  
22 22  Порядок настройки зависит от используемого оборудования и осуществляется согласно инструкции производителя. Важно настроить работу сканера в режиме клавиатуры. Требуется поддержка передачи данных данных в формате vCard. Для проверки правильности настройки рекомендуется:
... ... @@ -23,7 +23,8 @@
23 23  
24 24  1. Открыть любой текстовой редактор;
25 25  1. Отсканировать QR-код;
26 -1. Проверить соответствие полученных данных образцу:
35 +1. Проверить соответствие полученных данных образцу ниже.
36 +
27 27  {{code}}
28 28  BEGIN:VCARD
29 29   VERSION:4.0
... ... @@ -33,11 +33,112 @@
33 33   BIRTHPLACE:гор. Ленинград
34 34   TITLE:Грузчик Оператор Перронной Техники
35 35   ADR:г Санкт-Петербург, р-н Фрунзенский, ул Будапештская, д 1 к 1, кв 1
36 - NATIONALITY:RU
46 + NALITY:RU
37 37   ORG:ООО "ВОЗДУШНЫЕ ВОРОТА СЕВЕРНОЙ СТОЛИЦЫ"
38 38   TEL:+79215555555
39 39   X-PASSPORT-NUMBER:4013770000
40 - X-PASSPORT-ISSUED:2014-01-01
41 - X-PASSPORT-AUTHORITY:ТП № 000 ОУФМС России по Санкт-Петербургу и Ленинградской обл. в Центральном районе г. Санкт-Петербурга
50 + X-PASSPORT-ISSUED:2014-02-04
51 + X-PASSPORT-AUTHORITY:ТП № 139 ОУФМС России по Санкт-Петербургу и Ленинградской обл. в Центральном районе г. Санкт-Петербурга
42 42  END:VCARD
43 43  {{/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"]]
QR-form_template.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +8.1 KB
Содержимое
QR-reader-error.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +4.0 KB
Содержимое
QR-reader-service.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +44.7 KB
Содержимое
QR-reading.png
Автор
... ... @@ -1,0 +1,1 @@
1 +XWiki.admin
Размер
... ... @@ -1,0 +1,1 @@
1 +4.2 KB
Содержимое
XWiki.ShortUrlClass[0]
Short URL code
... ... @@ -1,0 +1,1 @@
1 +2a9d2
Last known target (debug)
... ... @@ -1,0 +1,1 @@
1 +neyross.setup.access-control.QR-code-reader.WebHome

Платформа НЕЙРОСС