29.05.2019

Внешняя компонента "1С:Сканер штрихкода" для платформы "1С:Предприятие 8.3"

Внешняя компонента "1С:Сканер штрихкода" для платформы "1С:Предприятие 8.3" поставляется в составе Библиотеки подключаемого оборудования.

Общие сведения

Для работы 1С:Предприятия со сканерами штрихкодов применяется внешняя компонента системы 1С:Предприятие "1С:Сканер штрихкода", версия 9.0.х. Она принимает от сканера прочитанный им штрихкод и передает его для обработки в 1С:Предприятие. Компонента также может использоваться для работы с другими устройствами, способ передачи данных которыми аналогичен способу передачи данных сканером штрихкодов. Компонента "1С:Сканер штрихкода", версия 9.0.х разработана по технологии NativeAPI.

Свойства

Компонента не содержит свойств.

Методы

Название (алиас) Параметры Возвращаемое значение Описание
ПолучитьНомерВерсии(GetVersion) - - Метод возвращает строку текущей версии компоненты.
ПолучитьОписание (GetDescription) - - Метод возвращает описание компоненты
ПолучитьОшибку (GetLastError) - - Метод возвращает последнюю ошибку при работе компоненты.
ПолучитьПараметры (GetParameters) - - Метод возвращает XML документ с описанием настроечных параметров компоненты, передаваемых через метод УстановитьПараметр (SetParameter).
УстановитьПараметр (SetParameter) - - Метод устанавливает значение одного из параметров, список которых может быть получен методом ПолучитьПараметры (GetParameters).
Подключить (Open) - - Метод подключает устройство
Отключить (Close) - - Метод отключает устройство.
ТестУстройства (DeviceTest) - - Метод запускает тест устройства

Настройка компоненты (Windows,Linux)

Настройка компоненты происходит при помощи формы настройки (Рис. 1.), доступ к которой может быть получен средствами БПО.

Рис. 1. Форма настройки компоненты "1С: Сканер штрихкода"(Native)

Параметры настройки (Windows,Linux)

Название Возможные значения Описание
Порт

-Клавиатура (по умолчанию)

-COM1-N

Параметр задает порт оборудования, через который данные от оборудования должны поступать к компоненте. В случае "Клавиатура", компонента в качестве источника данных будет воспринимать клавиатурные события в системе. В случае "COM1-N", компонента в качестве источника данных будет оживать данные от соответствующего COM-порта в системе.
Бит данных (только для "COM1-N")

-1

-2

-3

-4

-5

-6

-7

-8 (по умолчанию)

Параметр задает количество бит данных (параметр должен совпадать с тем, который указан при конфигурировании сканера).
Стоп-бит (только для "COM1-N")

-1 (по умолчанию)

-1.5

-2

Параметр задает количество стоп-бит (параметр должен совпадать с тем, который указан при конфигурировании сканера).
Скорость (только для "COM1-N") -110
-300
-600
-1200
-2400
-4800
-9600 (по умолчанию)
-14400
-19200
-38400
-56000
-57600
-115200
-128000
-256000
Параметр задает скорость передачи данных (параметр должен совпадать с тем, который указан при конфигурировании сканера).
Префикс (только для Windows) Один из кодов символов от 0 до 127 или NONE (по умолчанию) Параметр устанавливает один из кодов символов, как символ префикса, который сигнализирует компоненте о том, что со следующего символа начинаются символы штрихкода (параметр должен совпадать с тем, который указан при конфигурировании сканера).
Суффикс Один из кодов символов от 0 до 127 (по умолчанию  13 (CR)). Параметр устанавливает один из кодов символов, как символ суффикса, который сигнализирует компоненте о том, что символы штрихкода окончены (параметр должен совпадать с тем, который указан при конфигурировании сканера).
Таймаут клавиатуры Число (по умолчанию 75 (мс)) Параметр устанавливает максимальную задержку между последовательно идущими символами при работе в режиме "Клавиатуры"
Таймаут COM-порта Число (по умолчанию 5 (мс)) Параметр устанавливает максимальную задержку между последовательно идущими символами при работе в режиме "COM1-N"
Кодировка COM-порта

-UTF-8 (по умолчанию)

-Windows-1251

Параметр устанавливает кодировку входящего потока данных
Символ GS (только для "Клавиатуры")

-NONE (по умолчанию)

-F1
-F2
-F3
-F4
-F5
-F6
-F7
-F8
-F9
-F10
-F11
-F12
-INSERT
-DELETE
-HOME
-END
-PgUp
-PgDn
-CAPSLOCK
-RIGHT_ALT
-NUMPAD_ENTER

Параметр устанавливает клавишу которой сканером будет передаваться символ GS (#29)
Тип выходных данных

-Строка (по умолчанию)

-Base64

Параметр устанавливает тип выходных данных. В случае Строка данные будут передаваться без изменений. В случае Base64 данные будут передаваться в виде строки содержащей данные кодированные в Base64.

 

ВАЖНО!
Настройки драйвера должны совпадать с настройками сканера

Параметры настройки (Android)

Название Возможные значения Описание
Устройство

-Клавиатура (по умолчанию)

-Список зарегистрированных  Bluetooth устройств

Параметр задает устройство, через которое данные должны поступать к компоненте. В случае "Клавиатура", компонента в качестве источника данных будет воспринимать клавиатурные события в системе. В случае одного из Bluetooth, компонента в качестве источника данных будет оживать данные от соответствующего Bluetooth устройства.
Тип выходных данных

-Строка (по умолчанию)

-Base64

Параметр устанавливает тип выходных данных. В случае Строка данные будут передаваться без изменений. В случае Base64 данные будут передаваться в виде строки содержащей данные кодированные в Base64.

 

ВАЖНО!
Настройки драйвера должны совпадать с настройками сканера

Возвращаемые события

В случае успешного получения данных от устройства компонента кодирует их соответствующим образом (Строка, Base64) и передает в 1С:Предприятие в виде одного из следующих событий

Название Описание
Штрихкод В случае русской локали "1С: Предприятие", Типа оборудования "Сканер" и "Типа выходных данных" Строка
ШтрихкодBase64 В случае русской локали "1С: Предприятие", Типа оборудования "Сканер" и "Типа выходных данных" Base64
ДанныеКарты В случае русской локали "1С: Предприятие", Типа оборудования "Считыватель карт" и "Типа выходных данных" Строка
ДанныеКартыBase64 В случае русской локали "1С: Предприятие", Типа оборудования "Считыватель карт" и "Типа выходных данных" Base64
Barcode В случае английской локали "1С: Предприятие", Типа оборудования "Сканер" и "Типа выходных данных" Строка
BarcodeBase64 В случае английской локали "1С: Предприятие", Типа оборудования "Сканер" и "Типа выходных данных" Base64
TrackData В случае английской локали "1С: Предприятие", Типа оборудования "Считыватель карт" и "Типа выходных данных" Строка
TrackDataBase64 В случае английской локали "1С: Предприятие", Типа оборудования "Считыватель карт" и "Типа выходных данных" Base64