¶ Использование QR-кодов и штрихкодов
Вы можете генерировать QR и штрих-коды, которые ссылаются на запись в базе. Вывести на форму записи эти коды или отобразить их в создаваемых документах из озмы.
Например, вы можете печатать наклейки на товары, а потом перемещать эти товары со склада на склад, заводя в операцию перемещения товар, сканируя эти этикетки камерой или специальным сканером.
Можете вывести QR коды на накладные или акты, чтобы было проще найти в базе то, что распечатано на бумаге. Можно использовать эти коды, так как вам захочется. Нет никаких ограничений.
Пример с использованием генерации и считывания штрих и QR кодов вы можете найти прямо в демоверсии озмы, которая развернулась для вас автоматически.
Видеообзор складского модуля, который использует коды:
https://youtu.be/pespuewfJyg
¶ Интерфейсы ввода
¶ Внешний считыватель кодов
Устройство, считывающее штрихкод или иной код, нанесённый на упаковку товара или иной носитель, и передаёт эту информацию в систему. Имеет считывающий элемент.
Больше всего распространены сканеры, эмулирующие клавиатуру: сосканированная информация вставляется в виде строки в место, где установлен курсор пользователя.
¶ Встроенный в ozma сканер
В ozma встроен интерфейс, который позволяет распознавать QR и штрихкоды c помощью веб-камер на компьютерах или камер в телефонах пользователя.
Интерфейс распознает большинство штрихкодов и QR-коды.
¶ Генерация
¶ Штрихкоды (Barcodes)
Сейчас штрихкод в системе содержит в себе числовой идентификатор записи. т.е. просто число (например, 1054)
Планируются изменения формата внутреннего штрихкода
По умолчанию (без указания атрибута format) штрихкод в системегенерируется в формате CODE128
Поддерживаемые форматы баркодов (для атрибута format):
CODE128EANEAN-13EAN-8EAN-5EAN-2UPC (A)CODE39ITF-14MSIPharmacodeCodabar
Генерация штрихкода в юзервью для конкретной записи в системе:
SELECT
//...
product.id as barcode @{
control = 'barcode',
format = 'ITF-14',
caption = 'Штрихкод'
},
FROM
//...
¶ QR-коды (QR-сodes)
Сейчас QR-код в системе шифрует в себе строку, содержащую информацию о схеме сущности, сущности и id записи.
Строка имеет формат
1/<schema>/<entity>/<id>
Пример:
1/production/details/24
Генерация QR-кода в юзервью для конкретной записи в системе:
SELECT
//...
product.id as qrcode @{
control = 'qrcode',
caption = 'QR-код'
},
FROM
//...
- Сгенерировать штрихкод и QR-код можно из поля с типом
reference(schema.name). Подходит полеid(оно есть у любой записи) - Для штрихкода нужно использовать атрибут поля
controlсо значением'barcode' - Для QR-кода нужно использовать атрибут поля
controlсо значением'qrcode' - На форме код будет отображаться сразу, в таблице - при двойном клике на ячейку таблицы.
¶ Сканирование в поле ввода
Если для вставки информации в поле используется внешний сканер со считывающим элементом, то никакие дополнительные атрибуты не требуются. Необходимо лишь настроить сканер, чтобы он эмулировал клавиатуру и использовать его, установив фокус на определенное поле.
Если внешнего сканера нет, но на устройстве пользователя есть камера, то можно использовать встроенный распознаватель кодов.
Для добавления его в конкретное поле используется атрибут поля barcode_camera_input со значением true. Он используется для открытия интерфейса встроенного сканера.
SELECT
//...
external_number @{
barcode_camera_input = true,
},
FROM
//...
¶ Внутренние штрихкоды/QR-коды и их использование
Внутренние штрихкоды содержат в информацию об id записей. Их можно использовать для поиска и быстрого выбора в полях-ссылках:
При использовании внутреннего штрихкода в поле автоматически подставится запись с сосканированным идентификатором.
¶ Внешние штрихкоды/QR-коды и их использование
Сканирование внешних штрихкодов позволяет быстро вставить в нужное поле строку с информацией из штрихкода.
Внешние коды не получится использовать для поиска информации в системе.
¶ Сканирование в таблицу
При необходимости массового добавления данных в таблицу можно воспользоваться специальным функционалом массового сканирования.
Он позволяет сосканировать несколько кодов подряд, а затем произвести вставку в указанную таблицу новых строк, указав в какой колонке использовать считанный из внутреннего штрихкода/QR-кода идентификатор.
Это полезно, например, при фиксации нескольких типов товаров в складских операциях
¶ Внешний сканер кодов
Код таблицы, в которую будут вставляться записи (сканируется продукт в референс-поле product):
{ $id reference(storage.actions) }:
SELECT
@type = 'table',
@title = 'Продукты в операции',
products_in_actions.product @{
column_width = 300,
barcode_text_input = {
icon: 'qr_code_2',
tooltip: 'Text barcode scanner',
display: 'all'
},
},
products_in_actions.action @{ visible = false, default_value = $id },
products_in_actions.count @{ column_width = 155, caption = 'Единиц', text_align = 'right' },
goods.base_unit @{ column_width = 120 },
FROM storage.products_in_actions
LEFT JOIN production.goods
ON goods.id = products_in_actions.product
WHERE products_in_actions.action = $id
ORDER BY products_in_actions.id DESC
FOR INSERT INTO storage.products_in_actions
- Кнопка вызова интерфейса для массового сканирования добавляется в качестве атрибута поля, в которое будет происходить вставка.
- Поле должно иметь тип "ссылка" (
reference(schema.entity)) - Атрибут для сканирования с помощью камеры устройства -
barcode_camera_input. - Атрибут для сканирования добавляет кнопку в панель таблицы. Настройка кнопки:
- icon - материал-иконка или эмодзи. Иконки может не быть
- name - надпись на кнопке. Кнопка может быть без надписи
- tooptip - подсказка при наведении курсора
- display - где отображать кнопку:
all- на панели на всех устройствах,mobile- на панели в мобильной версии,desktop- на панели только на ПК версии.- если не указать этот атрибут - кнопка будет спрятана в кебаб-меню.
¶ Встроенный сканер камерой устройства
Код таблицы, в которую будут вставляться записи
{ $id reference(storage.actions) }:
SELECT
@type = 'table',
@title = 'Продукты в операции',
products_in_actions.product @{
column_width = 300,
barcode_camera_input = {
icon: 'qr_code_scanner',
tooltip: 'Camera barcode scanner',
display: 'mobile',
},
},
products_in_actions.action @{ visible = false, default_value = $id },
products_in_actions.count @{ column_width = 155, caption = 'Единиц', text_align = 'right' },
goods.base_unit @{ column_width = 120 },
FROM storage.products_in_actions
LEFT JOIN production.goods
ON goods.id = products_in_actions.product
WHERE products_in_actions.action = $id
ORDER BY products_in_actions.id DESC
FOR INSERT INTO storage.products_in_actions
- Кнопка вызова интерфейса для массового сканирования добавляется в качестве атрибута поля, в которое будет происходить вставка.
- Поле должно иметь тип "ссылка" (
reference(schema.entity)) - Атрибут для сканирования с помощью подключенного или встроенного сканера -
barcode_text_input - Атрибут для сканирования добавляет кнопку в панель таблицы. Настройка кнопки:
- icon - материал-иконка или эмодзи. Иконки может не быть
- name - надпись на кнопке. Кнопка может быть без надписи
- tooptip - подсказка при наведении курсора
- display - где отображать кнопку:
all- на панели на всех устройствах,mobile- на панели в мобильной версии,desktop- на панели только на ПК версии.- если не указать этот атрибут - кнопка будет спрятана в кебаб-меню.
Можно использовать два варианта ввода в одной таблице. Для этого нужны 2 кнопки для открытия обоих интерфейсов ввода и два атрибута, указывающих в какую колонку вводить данные
¶ Выполнение действия или поиск записи по QR-коду
Так как в QR-код помимо идентификатора зашита информация о таблице, то ее можно использовать в поиске информации в системе.
Например, можно сделать кнопку в главном меню, которая в зависимости от сосканированной сущности будет открывать разные вью или даже выполнять процедуры.
@panel_buttons = [{
name: 'Cканировать QR-код',
icon: 'qr_code_2',
qrcode: {
production: {
products: {
ref: &production.product_form,
target: 'top'
},
goods: {
ref: &production.good_form,
target: 'top'
}
},
public: {
users: {
action: {
schema: 'production',
name: 'check_employee_access'
}
}
}
}
}],
- При сканировании QR-кода с содержимым
1/production/products/24откроется формаproduct_formдля продукта с id = 24 - При сканировании QR-кода с содержимым
1/production/good/1098откроется формаgood_formдля товара с id = 1098 - При сканировании QR-кода с содержимым
1/public/users/8исполнится процедураproduction.check_employee_accessв которую будет передан id = 8
¶ Сводная таблица по атрибутам
| Действие | Штрихкод сканером | Штрихкод камерой | QR-код сканером | QR-код камерой |
|---|---|---|---|---|
| Генерация | control ='barcode', format = 'itf-14' |
control ='barcode', format = 'itf-14' |
control ='qrcode' |
control ='qrcode' |
| Вставка содержимого в одиночный инпут | не требуется | barcode_camera_input = true |
не требуется | barcode_camera_input = true |
| Поиск в референс-поле | не требуется | barcode_camera_input = true |
не требуется | barcode_camera_input = true |
| Массовая вставка в таблицу (поле) | barcode_text_input = { name: name } |
barcode_camera_input = { name: name } |
barcode_text_input = { name: name } |
barcode_camera_input = { name: name } |
| Поиск информации (кнопка) | 🚫 | 🚫 | qrcode: { schema: {entity: {ref: ref}}} |
qrcode: { schema: {entity: {ref: ref}}} |
| Вызов процедуры (кнопка) | 🚫 | 🚫 | qrcode: { schema: {entity: {action: ref}}} |
qrcode: { schema: {entity: {action: ref}}} |