1с драйвер сканера штрих кода native api



1с драйвер сканера штрих кода native api

Использован релиз 1.6.23

Сканер штрихкода – устройство, которое считывает штрихкод, нанесенный на упаковку товара (к примеру), и передает эту информацию в компьютер.

Сканеры штрихкода удобно использовать на рабочих местах кассира для быстрого добавления товаров в чек, активации подарочных сертификатов и дисконтных карт. Также сканер будет незаменим для комплектации заказов на складе и идентификации материалов в производстве. Сканеры позволяют работать с маркированной продукцией – алкоголем, табачной продукцией, обувью и мн. другим.

    Для использования сканера штрихкода установите в настройках флажок «Подключаемое оборудование» (раздел: Продажи – Настройки – Подключаемое оборудование) (рис. 1).
    Станут доступны ссылки «Подключаемое оборудование» и «Рабочие места».

Перейдите по ссылке «Подключаемое оборудование». В открывшейся форме «Подключение и настройка оборудования» выберите тип оборудования «Сканеры штрихкода» и добавьте в табличную часть подключаемые экземпляры оборудования по кнопке «Создать» (рис. 2).

  • В открывшейся форме заполните и проверьте реквизиты для экземпляра подключаемого оборудования (рис. 3):
    • флажок «Устройство используется» устанавливается автоматически;
    • в поле «Тип оборудования» значение заполняется автоматически на основании значения, выбранного в одноименном поле в шапке формы (см. пункт 2);
    • в поле «Драйвер оборудования» выберите из списка драйвер «1С:Сканеры штрихкода (NativeApi)»;
    • поля «Рабочее место» и «Наименование» заполняются автоматически по данным других полей;
    • в поле «Серийный номер» можно ввести заводской номер, указанный на корпусе устройства (поле заполнять не обязательно).

    Сохраните информацию о подключаемом экземпляре оборудования по кнопке «Записать и закрыть». Для оборудования станет доступна кнопка «Настроить», нажмите на нее (рис. 4).

    Установите драйвер устройства «1С:Сканер штрихкодов (NativeApi)» по кнопке «Установить драйвер» (рис. 5). Установка потребуется, только если ранее драйвер не был установлен.
    После успешной установки драйвера откроется окно настроек.

  • Настройки драйвера «1С:Сканер штрихкодов (NativeApi)» будут заполнены автоматически.
  • Так как на рынке торгового оборудования представлено множество различных моделей сканеров штрихкодов, важно проверить, что настройки соответствуют техническим характеристикам модели и согласованы между собой.

    Для проверки настроек сканера нажмите на кнопку «Тест подключения» (рис. 6).

      Откроется окно «Тест устройства». При выполнении теста драйвер постарается подключить все доступные устройства (только для Windows и Linux), т. е. как клавиатуру, так и COM устройства, и будет ожидать от них данных (рис. 7).

    Считайте штрихкод, изображенный на рисунке ниже, с помощью подключенного сканера.

    Результат сканирования тестового штрихкода отобразится в окне теста оборудования (рис. 9).

    В конце основных данных добавлен символ ‘CR’ – это суффикс, который вставляет сканер. Он дает программе понять, что полученный от оборудования текст является штрихкодом.

    1. Проверьте параметры подключения. Значения, полученные в результате сканирования с помощью подключенного устройства, должны совпадать с указанными в основном окне настроек драйвера (рис. 10).
      • поле «Порт»:
        Узнать нужный порт можно по результатам тестирования (см. п. 7). При выполнении тестирования данные считываются со всех устройств (клавиатуры и COM-портов), строка с результатом сканирования выводится напротив порта, к которому подключен сканер.
      • поля «Префикс» и «Суффикс»:
        Префикс и суффикс в окне настроек драйвера представлены в формате: Номер символа в кодировке (символ). Например «13 (CR)» означает суффикс CR. означает, что префикс или суффикс отсутствует.
        Различные модели сканеров штрихкодов поддерживают широкие настройки префикса и суффикса, в том числе и многосимвольные. Для успешной работы с драйвером «1С:Сканер штрихкодов (NativeApi)» настройки в сканере и драйвере должны быть согласованы между собой (вне зависимости от режима).

    Смотрите также

    Не пропускайте последние новости — подпишитесь
    на бесплатную рассылку сайта:

    • десятки экспертов ежедневно мониторят изменения законодательства и судебную практику;
    • рассылка бесплатная, независимо от наличия договора 1С:ИТС;
    • ваш e-mail не передается третьим лицам;

    Источник

    Внешняя компонента «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)


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



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

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

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

    Название Возможные значения Описание
    Порт Параметр задает порт оборудования, через который данные от оборудования должны поступать к компоненте. В случае «Клавиатура», компонента в качестве источника данных будет воспринимать клавиатурные события в системе. В случае «COM1-N», компонента в качестве источника данных будет оживать данные от соответствующего COM-порта в системе.
    Бит данных (только для «COM1-N») Параметр задает количество бит данных (параметр должен совпадать с тем, который указан при конфигурировании сканера).
    Стоп-бит (только для «COM1-N») Параметр задает количество стоп-бит (параметр должен совпадать с тем, который указан при конфигурировании сканера).
    Скорость (только для «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-порта Параметр устанавливает кодировку входящего потока данных
    Символ GS (только для «Клавиатуры») Параметр устанавливает клавишу которой сканером будет передаваться символ GS (#29)
    Тип выходных данных Параметр устанавливает тип выходных данных. В случае Строка данные будут передаваться без изменений. В случае Base64 данные будут передаваться в виде строки содержащей данные кодированные в Base64.

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

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


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

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

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

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

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

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

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

    Источник

    Внешний компонент «1С:Сканер штрихкода» (Native) версия для платформы «1С Предприятие 8.3».

    Внешний компонент «1С:Сканер штрихкода» (Native) для платформы «1С Предприятие 8.3» поставляется в составе «Библиотеки подключаемого оборудования» (далее — БПО). «1С:Библиотека подключаемого оборудования для мобильных приложений» (далее — МБПО) и предназначен для использования ТОЛЬКО в их составе. Самостоятельное использование внешнего компонента не предусмотрено. Компонент предназначен для получения данных от оборудования – сканеров штрихкодов (далее – ШК) и передаче их в платформу «1С: Предприятие».

    Основные возможности

    Внешний компонент «1С:Сканер штрихкода» (Native) (далее – ВК или «1С:Сканер штрихкода») позволяет получать данные от подключенных сканеров штрихкодов и передавать их в платформу «1С:Предприятие». Компонент поддерживает следующие операционные системы (далее – ОС): Windows x32/x64, Linux (x32/x64), Android (arm, arm64, x86, x86_64), MacOS(x64). Компонент поддерживает следующие режимы подключения к сканирующему оборудованию: клавиатурный (все ОС), virtual COM (все ОС), Bluetooth (Android, Mac), Broadcast (Android).

    Схема взаимодействия с оборудованием

    Драйвер реализует следующую схему получения и обработки данных от оборудования: данные от устройства поступают в процессор сообщений, который приводит сообщения к стандартизованному виду, после чего, если сообщение соответствует заданным при настройке драйвера критериям, то оно передается в платформу «1С: Предприятие», в противном случае игнорируется.

    Клавиатурный режим

    В отличие от остальных режимов взаимодействия, клавиатурный режим имеет ряд особенностей, которые отличают его от остальных. В Android, Windows и MacOS клавиатуры в отличие от остальных устройств, представлены общей очередью клавиатурных сообщений. Это приводит к тому, что работа с очередью сообщений на этих системах затрагивает пользовательский ввод. Так же требуется отдельный подход при подключении нескольких обработчиков, работающих с оборудованием в клавиатурном режиме. Поэтому, в случае клавиатурного режима взаимодействие с оборудованием выглядит несколько иначе. ОС формирует очередь клавиатурных сообщений от всех клавиатурных устройств, ВК «изымает» сообщения из системной очереди сообщений, после чего предоставляет их «слушателям» – подключенным экземплярам компонента «1С:Сканер штрихкода» с клавиатурным режимом взаимодействия. Если хотя бы один слушатель принимает переданные сообщения, то в очередь они не возвращаются, а слушатель продолжает обработку и передает данные в платформу 1С. В противном случае, если сообщения остались не востребованы в пределах таймаута, указанного в настройках, ВК возвращает их обратно в очередь сообщений, и они доставляются изначальным адресатам.

    Примечание :
    Для того чтобы слушатель «принял» сообщения они должны соответствовать критериям (суффиксу и префиксу) указанным в настройках.

    Также стоит отметить, что учитывая неоднородность в скорости передачи клавиатурных сообщений у разных моделей сканеров (особенно при передаче «больших», более 40-50 символов, ШК), ВК в качестве таймаута использует время, прошедшее с получения последнего клавиатурного сообщения (тем не менее, если в сообщениях удается обнаружить суффикс, то обработка начинается «досрочно», не дожидаясь истечения таймаута).

    Это позволяет получать большие ШК даже от сканеров с низкой скоростью передачи сообщений. Отрицательным моментом может быть, то, что при подключенной ВК с большими значениях таймаута при быстром наборе с клавиатуры может создаваться впечатление «заторможенного» ввода. В этом случае рекомендуется уменьшить таймаут клавиатуры в настройках драйвера так, чтобы скорость ввода была комфортной, но сообщения от сканера при этом считывались корректно.

    Ограничения клавиатурного режима

    Преимуществами клавиатурного режима является его доступность. Он является умолчанием практически для всех моделей сканеров и доступен на всех ОС. Также его легко проверить, подключив сканер и считав какой-нибудь ШК в текстовый редактор. Однако у этого режима есть и ограничения. На большинстве современных клавиатур от

    80 до 110 клавиш, тем не менее, ШК может кодировать последовательность байт каждый из которых может принимать значения от 0 до 255. Т.е., в общем случае, количества клавиш на клавиатуре недостаточно для того чтобы передать данные любого ШК. Для того чтобы обойти это ограничение некоторые сканеры используют Ctrl+X или Alt+X нотацию, которые поддержаны в ВК «1С:Сканер штрихкода». Однако не все модели сканеров предоставляют такие возможности и в случае «нестандартных» значений байт данных в ШК (как правило, значения байт 127) либо не передают никаких данных, либо передают их не стандартизованной последовательностью клавиатурных событий. Поэтому, если необходимо работать со штрихкодами, содержащими не латинские символы или каким-либо образом кодированные данные (больничные листы и т.д.), то лучше воспользоваться подключением по COM, если сканер это позволяет.

    «Auto CRLF»

    Как правило «по умолчанию» сканеры в клавиатурном режиме настроены с суффиксом ‘CR’ (клавиша Enter), но не для всех моделей сканеров это так. Иногда суффиксом может быть ‘LF’ или ‘CRLF’. Для обобщения всех этих случаев в ВК, кроме обычных односимвольных суффиксов, предусмотрен специальный суффикс «Auto CRLF», который обозначает, что последовательность, состоящая из CRLF в любом сочетании считается суффиксом. Это может облегчить работу с настройками для некоторых моделей сканеров.

    Окно «Тест»

    Для проверки работы со сканером на Windows и Linux, есть возможность воспользоваться встроенным в ВК окном «Тест». Для этого нужно нажать кнопку «Тест устройства» в форме настроек компонента. Внешний вид окна представлен на следующем рисунке.

    Окно тест делает попытку подключения всего доступного оборудования с заданными в форме настроек параметрами. После чего можно сканировать различные ШК, данные полученные с них будут отображаться в поле данных. Получаемая от оборудования информация может быть представлена в окне «Тест» в 3-х режимах: «Тестовом», «Рабочем» и «Отладка клавиатуры». «Тестовый» режим показывает данные от оборудования с заменой непечатаемых символов на их названия, а также названия специальных клавиш, если данные получены от клавиатуры.

    «Рабочий» режим отображает данные, так как они передаются в платформу «1С: Предприятие». Если то или иное сообщение, пришедшее от оборудования, не соответствует критериям в настройках (допустим, не совпадает суффикс и/или префикс), то оно не будет отображено в «Рабочем» режиме и не будет передано в платформу «1С: Предприятие».

    Режим «Отладка клавиатуры», показывает всю последовательность переданных клавиатурных сообщений, которые были переданы в компоненту. Нажатия клавиш в этом случае отображаются как KEY в случае нажатия функциональной клавиши key в случае высвобождения функциональной клавиши и symbol_ _symbol в случае нажатия и высвобождения клавиши печатаемого символа.

    Также для проверки правильности настроек сканера на форме Тест расположен проверочный ШК, отсканировав который можно понять правильность настройки сканера. В случае если настройки сканера и ВК «1С:Сканер штрихкода» настроены одинаково (совпадают настройки суффикса, префикса и специальных клавиш на сканере и в ВК), то в поле данных будет выведено «Ваш сканер настроен правильно» («Your scaner configured correctly»). В случае, когда неправильно настроен суффикс и/или префикс будет выведено соответственно «Данные соответствуют проверочным частично.»(«The data correspond to the verification partly.»), «Неверно настроен суффикс»(«Suffix configured wrong»), «Неверно настроен префикс»(«Prefix configured wrong»).

    Android Braodcast

    На Андроид устройствах с поддержкой функции сканирования ШК (в том числеТСД) появилась возможность получать результаты сканирования через механизм Broadcast (https://developer.android.com/guide/components/broadcasts), для устройств, которые поддерживают такой механизм передачи результатов сканирования. Для того чтобы, на Android устройстве подключить этот вариант взаимодействия необходимо настроить само устройство на передачу данных по Broadcast. В настройках ВК в поле Устройство необходимо указать Broadcast и настроить поля intent.action intent.category intent.extra intent extra type. Поля intent.action intent.category intent.extra имеют то же значение, что и в документации Android (https://developer.android.com/guide/components/intents-filters?hl=ru) и должны совпадать с теми, что перечислены на устройстве. Для примера приведем настройки ТСД Атол Smart.Lite.

    Установленные настройки ВК в МБПО на ТСД Атол Smart.Lite

    Настройки ТСД Атол Smart.Lite на Broadcast

    Свойства

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

    Методы


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

    Настройки ВК

    Начиная с 10-ой редакции драйвера «1С: Сканер штрихкодов» большинство настроек драйвера унифицировано и может быть представлено следующей таблицей. Различия составляют только специфические моменты, связанные с особенностями конкретной ОС.

    Название параметра
    RU/EN

    Диапазон значений Значение по умолчанию Комментарий Порт/Port Клавиатура Параметр определяет канал, по которому ВК ожидает данные от сканирующего устройства. Клавиатура, доступные COM/Bluetooth порты перечислены в этом параметре Префикс/Prefix Символы от 0(NUL)…127(DEL) -1(NONE) Указывает символ префикс сообщения от устройства. По умолчанию префикс отсутствует Суффикс/Suffix Символы от 0(NUL)…127(DEL) 13(CR) Указывает символ суффикс сообщения от устройства. По умолчанию суффикс CR (обычно передается клавишей ENTER). ТипВыходныхДанных/ OutputDataType Строка, Base64 Строка Задает формат передачи данных от ВК к платформе «1С: Предприятие» Символ GS/GS symbol Спец. клавиши F1..F12, INSERT, TAB и т.д. NONE Задает клавишу, которой передается символ GS в GS1 штрихкодах Таймаут клавиатуры (мс)/ Timeout keyboard (ms) 25(Windows)/75 (остальные ОС и веб клиент) Таймаут клавиатуры, после истечения которого начинается обработка принятых клавиатурных сообщений Бит данных / Data bits 1..8 8 Бит данных при передаче по COM порту Стоп бит / Stop bits 1,2 1 Стоп бит при передаче по COM порту Четность / Parity Четно
    Нечетно
    Нет Нет Четность передачи по COM порту Скорость / Speed 110
    300
    600
    1200
    2400
    4800
    9600
    14400
    19200
    38400
    56000
    57600
    115200
    128000
    256000 9600 Скорость передачи по COM порту Кодировка COM-порта / Serial encoding
    UTF-8 Кодировка принятых по COM/Bluetooth/Broadcast сообщений Регенерация сообщений / Message regeneration Да
    Нет Нет Склейка сообщений переданных по COM/Bluetooth в случае низкой скорости передачи, когда сообщение доставляется разорванным на 2-е и более части Тип лога / Log type В файл
    В системный журнал NONE Тип лога компоненты Лог файл / Log file Путь к файлу лога при выборе параметра «Тип лога» «в файл» Windows Игнорировать состояние клавиатуры / Ignore keyboard state Нет Если настройка включена, то ВК игнорирует состояние клавиши «CAPS LOCK», на основной клавиатуре. Linux HID устройство / HID device Выбор HID идентификатора устройства сканера, для монопольного доступа к нему Android Устройство / Device Эквивалент настройки Порт на Desktop платформах Standard android.intent.action. NONE
    Standard android.intent.category NONE
    Standard Intent Extra NONE Стандартный ключ intent.extra Пользовательсктй Intent Extra/User Intent Extra Пользовательский ключ intent.extra (из настроек ТСД) Пользовательское Intent Action/User Intent Action Пользовательский intent.action (из настроек ТСД) Пользовательская Intent Category/User Intent Category Пользовательский intent.category (из настроек ТСД) Тип данных/Extra data type

    String Тип данных используемого ключа intent.extra

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

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

    Источник

    You may also like...