Внешний компонент «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С:Предприятие в виде одного из следующих событий:

Источник

Порядок работы со сканерами штрихкодов для платформы «1С:Предприятие 8.1»

Штрихкодирование

Штрихкодирование является, пожалуй, самым распространённым на сегодняшний день методом автоматической идентификации товара (разумеется, штрихкодирование может использоваться и используется и в других областях). Первый патент на алгоритм штрихового кодирования был выдан Джозефу Вудленду (Joseph Woodland) и Бернарду Силверу (Bernard Silver) 7 октября 1952 года в США. Символ штрихкода (Bull’s eye), изобретённого Вудлендом и Силвером, состоял из набора концентрических окружностей. 26 июня 1974 года была осуществлена первая продажа с использованием устройства считывания (сканера) штрихкодов. Первым товаром, который был продан с использованием сканера штрихкодов, оказалась упаковка жевательной резинки Wrigley’s Juicy Fruit. В настоящее время подобная упаковка выставлена в музее Американской Истории.

В задачи устройства считывания штрихового кода помимо, собственно, считывания, входит также декодирование считанного штрихкода. Таким образом сканеры отличаются набором алгоритмов, которые они поддерживают. Также они отличаются типом излучения (светодиод, лазер), количеством плоскостей сканирования (одно- и многоплоскостные) и способом подключения к ПК.

Независимо от типа физического интерфейса (RS232, PS/2, USB, IrDa и т.д.) сканеры можно разделить по способу подключения на два типа: последовательный интерфейс и разрыв клавиатуры (при подключении через USB, например, может эмулироваться один из двух перечисленных интерфейсов).

Разрыв клавиатуры (keyboard wedge, KBW)

Для подключения сканера такого типа к конфигурациям можно использовать драйвер «АТОЛ: Драйвер устройств ввода». Драйвер распространяется бесплатно для системы программ 1С:Предприятие. В других случаях драйвер является платным и для работы с ним потребуется приобрести электронный ключ защиты в компании «АТОЛ технологии». Без ключа защиты драйвер будет работать в демонстрационном режиме, в котором можно считывать и передавать в ПК только 8-разрядные штриховые коды. Для использования драйвера в терминальной сессии необходима многопользовательская версия.

Последовательный интерфейс (COM)

Порядок настройки драйвера «1С: Сканер штрихкода»

Настоятельно рекомендуется установить последнюю версию драйвера, который расположен в соответствующем разделе на диске ИТС.

Установка драйвера «1С: Сканер штрихкода»

Для установки драйвера необходимо запустить файл ScanOpos.exe и далее следовать инструкциям на экране.

Настройка конфигурации

Настройка драйвера

В случае, если Вам известен номер последовательного порта (физического или виртуального) и его параметры, то их можно задать сразу.

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

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

После нажатия кнопки «Закрыть» указать полученные номер порта и префикс в форме настроек. Закончив настройку параметров сканера нажмите кнопку «Ок».

Порядок настройки драйвера «АТОЛ: Драйвер устройств ввода»

Настоятельно рекомендуется получить последнюю версию указанного драйвера у его производителя. На момент подготовки настоящего раздела к публикации последняя версия драйвера могла быть получена по данному адресу.

Установка драйвера «АТОЛ: Драйвер устройств ввода»

Для запуска процесса установки необходимо запустить файл Setup.exe и далее следовать инструкциям на экране.

Настройка конфигурации

Настройка драйвера для работы со сканером

Если Вам известен номер COM-порта (или виртуального порта, если сканер имеет физический интерфейс USB или другой) и его параметры, то можно их указать. В противном случае следует воспользоваться сервисом поиска оборудования в тесте драйвера, входящем в поставку драйвера.

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

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

В соответствии с этими результатами необходимо установить настройки драйвера (тест драйвера можно закрыть).

Далее следует нажать кнопку «ОК». Настройка закончена.

Источник

Настройка префикса «F7» и суффикса «Enter» для сканера Honeywell Voyager 1430/1450g/1452g/1450g2DHR

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

При подключении сканера в «разрыв клавиатуры» работа в 1С происходит по следующему алгоритму: в документе нажимается клавиша F7, открывается окно ввода штрихкода, сканером считывается штрихкод с этикетки, нажимается кнопка «ОК» (или клавиша «Enter»), 1С находит товар по штрихкоду и добавляет его в табличную часть документа. Если в документ необходимо добавить несколько товаров или есть необходимость отойти со сканером от компьютера (подбор товара в зале, инвентаризация), то данный алгоритм работы вызывает ряд неудобств. Чтобы избежать данной ситуации, можно запрограммировать сканер штрихкодов на выполнение автоматических действий при одном нажатии на кнопку сканера. В этом случае сканер будет выдавать следующую последовательность:

где [F7] – префикс штрихкода, [Штрихкод] – штрихкод товара на этикетке, [Enter] – суффикс штрихкода.

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

Настройка префикса «F7» и суффикса «Enter» для сканера Honeywell Voyager 1430/1450g/1452g/1450g2DHR

1. Сканируем системный штрихкод, который сбросит настройки сканера на заводские настройки (при необходимости).

2. Сканируем системный штрихкод, ответственный за программирование префикса.

3. Сканируем набор кодов, соответствующих клавише F7: 9, 9, 1, С, сохраняем данные

4. Сканируем штрихкод, ответственный за программирование суффикса «Enter»

На этом настройка сканера завершена.

Кроме описанного способа программирования сканера, можно воспользоваться утилитой EZConfig (подробная информация по настройке сканера и использованию утилиты EZConfig содержится в инструкции по программированию на сайте производителя оборудования Honeywellaidc).

Источник

Настройка сканера штрихкода в 1С и других программах

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

1. Возможность эмулировать COM порт

2. Возможность передачи префикса

3. Возможность передачи суффикса

4. Возможность передачи кнопки ENTER

Механизмы встроенные в 1С для работы со штрих-кодами

И так самое главное, что вы должны понимать то, что сама программа 1С имеет встроенный функционал для работы со сканерами штрих кода за которые отвечают специальные обработки. Эти обработки в последнее время встроены в конфигурации 1С, предназначенные для торговли и реализованные на управляемых формах (в 1С на обычных формах, данные обработки нужно отдельно инсталлировать с диска ИТС). Если у вас конфигурация 1С Бухгалтерия, то, конечно, у вас не будет встроенных обработок и доставить их с диска тоже не возможно, так как функционал этой конфигурации не предусматривает работу со штрих кодами. Вот, к примеру, в нашей учетной программе это выглядит вот так:

Драйвера для сканера штрих кода для 1С – это отдельные программы, которые после инсталляции взаимодействуют с данными обработками. Зачастую драйвера можно скачать БЕСПЛАТНО и установить с диска ИТС идущего в комплекте с приобретенной вами лицензией или же с официального сайта 1С при наличии ОПЛАЧЕННОЙ подписки. Итак, для того, чтобы начать установку сканера штрих кода с 1Ской, вы:

— Устанавливаете драйвер и в обработке указываете, что именно этот драйвер нужно использовать

Теперь ваша 1С готова принимать штрих код.

Зачем использовать нестандартные драйвера 1С для сканера штрихкода

а драйвера можно скачать на нашем сайте в разделе техподдержки, а так же они доступны на официальном сайте производителя или идут на диске укомплектованном в коробку со сканером. На данный момент практически все сканеры штрих кода с ценой выше 50 USD имеют функцию эмуляции компорта и поэтому, приобретая устройство в таком ценовом диапазоне, вы на 99% можете быть уверены, что он заработает с вашей 1С-кой (но все же лучше уточните у менеджера этот момент).

ПОЛНАЯ ВИДЕО ИНСТРУКЦИЯ ПО ПЕРЕВОДУ СКАНЕРОВ DATALOGIC В РЕЖИМ ЭМУЛЯЦИИ КОМ-ПОРТА

Вывод: Установив стандартные 1С-ные драйвера и обработки и, купив сканер способный эмулировать COM порт, У ВАС ВСЕ ПОЛУЧИТСЯ, при этом это будет наиболее правильный путь, который рекомендуют разработчики 1С.

ВАЖНО: Использование сканера без эмуляций освобождает вас от установки дополнительных драйверов USB to COM и программирования сканера

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

Как работает сканер штрихкода с 1С по USB с эмуляцией клавиатурного ввода

Например в нашей программе поиск по штрих коду в расходной накладной реализован через нажатие клавиши F7, вот ее нажатие и эмулирует атоловский драйвер. В нашей учетной программе это выглядит вот так:

и называется это ПРЕФИКС по аналогии с префиксом при изучении строения слова. Здесь стоит также отметить момент, что многие программы для торговли в магазинах в наше время используют как раз юсб сканера с эмуляцией клавиатуры и уже не заморачиваются на счет давно забытых КОМ портов и эмуляций. Исходя из изложенного выше, становится очевидным, что даже если сканер не умеет эмулировать компорт, то вы все равно сможете «заюзать» его с 1C, а тем более с любой другой программой для автоматизации торговли.

Расширенные настройки сканеров штрих кодов для 1С

Если вы внимательно читали статью, то должны были заострить внимание на двух основных моментах: для работы с 1С-кой нужны префиксы и второй момент заключается в том, что сканеры должны что-то эмулировать. Эмуляция компортов и клавиатуры программировалась в сканерах и в дальнейшем подхватывалась драйверами устройств ввода, после чего через драйвер задавался префикс. На сегодняшний день мы хотим сказать вам, что все это можно сделать без использования 1С-овских драйверов вовсе, а с помощью программирования самого сканера штрих кода. Любой уважающий себя производитель давно позаботился об этом функционале. Все сканера по умолчанию работают в режиме клавиатурного ввода будь то «дешевый китаец», или же это брендовый Datalogic, Motorola или Honeywell. Так вот у брендовых устройств всегда имеется руководство пользователя (USER GUIDE или USER Manual), которые доступны на нашем сайте и официальных сайтах производителей, и в этих источниках вы всегда можете изучить поочередность действий для программирования префиксов, суфиксов, либо каких-нибудь других информационных данных, требующихся для ваших целей и, передающихся вместе со штрих кодом. Это означает, что эмуляцию нажатия кнопки F7 или любой другой кнопки служащей для поиска товара по штрих коду в вашей конфигурации, мы можем запрограммировать в сам сканер. Такая РАБОТА СКАНЕРА штрих кода предполагает использования устройства БЕЗ 1С-ных ДРАЙВЕРОВ, БЕЗ 1Сных Обработок и БЕЗ ЭМУЛЯЦИЙ. Это реализовано следующим образом: открыв документ в программе 1С и став в табличную его часть, вы просто считываете штрих код и префикс F7 передается перед ним, и вызывает окно поиска товара по штрих коду без использования 1С-овского драйвера. В инструкциях у разных производителей это выглядит по-разному и реализовано с помощью считывания управляющих штрих кодов, но все же практически любой админ или же 1С-ник должен справится с программирования префикса через руководство пользования к сканеру штрих кода. Вот так, к примеру, это выглядит у торговой марки Datalogic:

для того, чтобы запрограммировать это, нужно провести следующие манипуляции со сканером:

1. войти в режим программирования

2. считать штрих код, означающий цифру 8

Источник