29.05.2019
Для работы 1С:Предприятия со сканерами штрихкодов применяется внешняя компонента системы 1С:Предприятие "1С:Сканер штрихкода", версия 9.0.х. Она принимает от сканера прочитанный им штрихкод и передает его для обработки в 1С:Предприятие. Компонента также может использоваться для работы с другими устройствами, способ передачи данных которыми аналогичен способу передачи данных сканером штрихкодов. Компонента "1С:Сканер штрихкода", версия 9.0.х разработана по технологии NativeAPI.
Компонента не содержит свойств.
| Название (алиас) | Параметры | Возвращаемое значение | Описание |
|---|---|---|---|
| ПолучитьНомерВерсии(GetVersion) | - | - | Метод возвращает строку текущей версии компоненты. |
| ПолучитьОписание (GetDescription) | - | - | Метод возвращает описание компоненты |
| ПолучитьОшибку (GetLastError) | - | - | Метод возвращает последнюю ошибку при работе компоненты. |
| ПолучитьПараметры (GetParameters) | - | - | Метод возвращает XML документ с описанием настроечных параметров компоненты, передаваемых через метод УстановитьПараметр (SetParameter). |
| УстановитьПараметр (SetParameter) | - | - | Метод устанавливает значение одного из параметров, список которых может быть получен методом ПолучитьПараметры (GetParameters). |
| Подключить (Open) | - | - | Метод подключает устройство |
| Отключить (Close) | - | - | Метод отключает устройство. |
| ТестУстройства (DeviceTest) | - | - | Метод запускает тест устройства |
Настройка компоненты происходит при помощи формы настройки (Рис. 1.), доступ к которой может быть получен средствами БПО.
Рис. 1. Форма настройки компоненты "1С: Сканер штрихкода"(Native)
| Название | Возможные значения | Описание |
|---|---|---|
| Порт |
-Клавиатура (по умолчанию) -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 |
Параметр устанавливает клавишу которой сканером будет передаваться символ GS (#29) |
| Тип выходных данных |
-Строка (по умолчанию) -Base64 |
Параметр устанавливает тип выходных данных. В случае Строка данные будут передаваться без изменений. В случае Base64 данные будут передаваться в виде строки содержащей данные кодированные в Base64. |
| ВАЖНО! Настройки драйвера должны совпадать с настройками сканера |
| Название | Возможные значения | Описание |
|---|---|---|
| Устройство |
-Клавиатура (по умолчанию) -Список зарегистрированных 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 |