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

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

Внешний компонент «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

Свойства

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

Методы

Настройки ВК

Начиная с 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 bits1..88Бит данных при передаче по COM портуСтоп бит / Stop bits1,21Стоп бит при передаче по COM портуЧетность / ParityЧетно
Нечетно
НетНетЧетность передачи по COM портуСкорость / Speed110
300
600
1200
2400
4800
9600
14400
19200
38400
56000
57600
115200
128000
2560009600Скорость передачи по 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», на основной клавиатуре.LinuxHID устройство / HID deviceВыбор HID идентификатора устройства сканера, для монопольного доступа к немуAndroidУстройство / DeviceЭквивалент настройки Порт на Desktop платформахStandard android.intent.action.NONE
Standard Intent ExtraNONEСтандартный ключ 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С:Предприятие в виде одного из следующих событий:

Источник

Native Api 1C для сканер штрих кода

Самым простым и удобным способом установки сканера штрих кода в 1С является подключение с помощью технологии Native API. Она используется не только для создания сканера штрих кода, но и для других внешних компонентов. Благодаря ей возможно создавать программы, которые будут часто взаимодействовать с системой 1С. Ниже описана подробная инструкция, как это сделать.

Первый шаг

Изначально необходимо скачать сам драйвер Native Api. Это можно сделать по ссылке или найти и скачать в интернете. Но будьте внимательны и проверяйте файлы из неизвестных сайтов на вирусы.

Собственный интерфейс, такой как Native API может быть установлен на операционные системы Linux и Windows. Установка и использование бесплатны.

Второй шаг

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

Этот драйвер дает возможность подключать сканер штрих кода через Com-порт или USB.

Третий шаг

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

Четвертый шаг

В программе откройте вкладку «Администрирование» и в ней зайдите в «Поиск оборудования». Найдите строку «Использовать подключаемое оборудование» и установите галочку напротив нее.

Теперь открывается новая вкладка под названием «Подключаемое оборудование», в которую необходимо зайти для дальнейшего подключения.

Пятый шаг

Перед вами открылось новое окно. В нём нужно выбрать тип оборудования, в нашем случае это «Сканеры штрих кода». Для создания пары с устройством нажимаете кнопку «Создать».

Шестой шаг

Во всплывшем окне ставите галочку рядом с пунктом «Устройство используется». Напротив строки «Драйвер оборудования» выбираете тот, у которого в скобочках написано «Native API». Далее сохраняете введенные данные, но окно не закрываете.

Седьмой шаг

В следующем этапе требуется нажать на вкладку «Настроить…» в этом же окне, после чего, программа выведет запрос на установку драйвера. Здесь обязательно нужно выбрать «Установить».

Восьмой шаг

В новом окне сверьте данные:

Сохраните введенные данные и закройте окно.

Это был последний шаг, после которого вы можете использовать сканер штрих кода. Для установки сканера штрих кода на иные операционные системы необходимо использовать другой драйвер. Настоятельно рекомендуем, для подключения сканера штрих-кода по технологии Native API обратиться к квалифицированным специалистам.

Источник

Подключение сканера штрихкода через драйвер NativeAPI для типовых конфигураций

Потребность в данной обработке возникла в связи с огромным количеством моделей сканеров на рынке и проблемами в работе некоторых из них с распространенными обработками обслуживания. В результате тестов выяснилось, что более стабильным в плане работы решением является подключение технологии NativeAPI в более поздних версиях БПО, заточенных под управляемые формы. Было принято решение адаптировать компоненту под типовой механизм подключения и настройки торгового оборудования через обработку обслуживания.

За основу была взята версия ScanOPOSNative_8_1_7_10.

Компонента драйвера залита в макет обработки и устанавливается автоматически при её развертывании, не требуя дополнительных манипуляций.

После выбора обработки необходимо выбрать версию на форме параметров как указано на скриншоте.

Обработка прошла проверку временем и уже на протяжении нескольких лет не ставил ничего кроме неё при необходимости использования сканера.

Тестировал на конфигурациях Управлении торговлей 10 и Рознице в режиме совместимости с версией 8.2. Ввиду идентичного механизма должна работать и в УПП и КА.

Тестировалось на версиях платформ: 8.3.10.2650, 8.3.17.1549.

Скачать файлы

Специальные предложения

Обновление 18.09.21 08:00

См. также

Мобильный ТСД, Инвентаризация, Маркировка, Штрихкод Промо

Мобильный терминал сбора данных для смартфонов и ТСД. Синхронизация между Вашей 1С и мобильным приложением осуществляется через HTTP-сервис (http или https) или промежуточный файл. Приложение для тех, кому важна безопасность данных, так как промежуточные сервисы для обмена не используются.

27.12.2020 18884 326 1cspec 144

Если после обновления Розницы на версию 2.3.9.22 или более позднюю не определяются марки и некорректно работает сканер штрихкода

21.06.2021 3887 63 санясоку 19

Заполнение чека ККМ из Реализации или Заказа через штрихкод документа

30.04.2021 4087 6 Rustig 3

Интеграция торгового оборудования: сканер-весы Zebra MP7000

Подключение торгового оборудования Zebra MP7000 сканер-весы к 1С «Розничная торговля».

10.03.2021 1937 1 Goody 0

Simple WMS Client – это визуальный конструктор мобильного клиента для терминала сбора данных(ТСД) или обычного телефона на Android. Приложение работает в онлайн режиме через интернет или WI-FI, постоянно общаясь с базой посредством http-запросов (вариант для 1С-клиента общается с 1С напрямую как обычный клиент). Можно создавать любые конфигурации мобильного клиента с помощью конструктора и обработчиков на языке 1С (НЕ мобильная платформа). Вся логика приложения и интеграции содержится в обработчиках на стороне 1С. Это очень простой способ создать и развернуть клиентскую часть для WMS системы или для любой другой конфигурации 1С (УТ, УПП, ERP, самописной) с минимумом программирования. Например, можно добавить в учетную систему адресное хранение, учет оборудования и любые другие задачи. Приложение умеет работать не только со штрих-кодами, но и с распознаванием голоса от Google. Это бесплатная и открытая система, не требующая обучения, с возможностью быстро получить результат.

09.01.2019 61404 266 informa1555 234

Прайс-чекер для УТ 10.3

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

10.02.2021 3072 8 Timur001 27

Сканер штрихкода в подборе товаров

Расширение подключает сканер штрихкода в обработку «Подбор товаров».

22.12.2020 2117 5 The Ded 9

Мобильная платформа. Штрихкоды в Android.

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

14.09.2020 4199 4 kinan 19

Android беспроводной Bluetooth сканер 1D/2D штрихкода и терминал сбора данных для 1С Промо

Бесплатное приложение, превращающее Android-смартфон в беспроводной 1D/2D Bluetooth сканер и терминал сбора данных для 1С и прочих POS систем. Не требует драйверов и доработки конфигураций.

12.09.2017 49295 27 kuld 45

Сканер штрих-кода в документах Счет покупателю и Перемещение товаров

Данное расширение добавляет функционал работы со сканером штрих-кода в документах Счет покупателю и Перемещение товаров. Для Бухгалтерии предприятия 3.0.

10.08.2020 3436 8 GPetr 4

Возможность поиска документа по ШК для прикрепления к ним нераспознанных изображений, после потокового сканирования.

05.08.2020 4337 0 Steffan 0

Маркировка и ШтрихКодирование в Рознице, ред.2.3 (2.3.8.27) Апрель 2021

Адаптация и исправления для маркировки и штрихкодирования в Рознице, ред.2.3. Актуально на 22 апреля 2021 г. для релизов 2.3.6.27 и 2.3.8.27 В архиве содержатся расширения для соответствующих релизов.

03.08.2020 5719 13 Одинец 7

Маркировка: 2D Android Штрихкод сканер + драйвер устройства для 1С Промо

Драйвер торгового оборудования и приложение для Android, телефон или планшет в качестве стандартного штрихкод сканера для платформы 1С.

29.11.2016 54385 195 dreamadv 117

Исправление ошибки «Уточнение данных: обработка кода маркировки, невозможность сканирования штрих-кодов с префиксом 29. »

Расширение предназначено для версии 2.3.4.33, заодно исправляет ошибку невозможности продать обувь без кода маркировки (Строка№1: Код маркировки).

23.06.2020 7130 31 санясоку 12

Подбор товаров с помощью сканера штрихкода в БП 3.0

Расширение конфигурации Бухгалтерия предприятия 3.0 позволяет использовать сканер штрихкодов для заполнения документа «Отчет производства за смену», «Перемещение товаров», «Требование-накладная».

25.05.2020 3316 11 user725789 6

Android Java и NativAPI C++ внешняя компонента для широковещательных сообщений (отправка и прием). Подключаем сканер ШК и клавиатуру к «1С мобильное приложение»

15.04.2020 9207 68 SanyMaga 88

Компоненты распознавания и печати штрих-кодов Промо

Комплект программного обеспечения для реализации функций оптического распознавания штрих-кодов различных систем при помощи обычной web-камеры, а также их отображения в печатных формах. Программы могут работать в составе конфигураций, созданных на базе платформ «1С-Предприятие» версий 7.7, 8.2, 8.3. Компонент чтения кодов реализован в виде внешней компоненты 1С с COM-интерфейсом. Компонент отображения создан по стандартной технологии ActiveX для Windows, и может быть встроен в любое приложение, поддерживающее встраивание ActiveX элементов управления, например в документ Word или Excel, или форму VBA. P.S. Добавлена новая версия программы распознавания. Новые функции: обработка видео в реальном режиме (а не по таймеру, как раньше), добавлена возможность распознавания штрих-кодов из графических файлов JPEG, PNG, GIF, BMP, а также передавать для распознавания картинки из 1С, теперь можно получить в 1С захваченное с камеры или файла изображение, как с выделением мест, содержащих коды, так и без, а также отдельные фрагменты изображений, содержащие код. Добавлены новые свойства и методы для программирования. Обновлена документация.

10.07.2015 76436 91 igorberezhnov 113

Источник