1с сканер штрих кода native api настройка
1с сканер штрих кода native api настройка
Использован релиз 1.6.23
Сканер штрихкода – устройство, которое считывает штрихкод, нанесенный на упаковку товара (к примеру), и передает эту информацию в компьютер.
Сканеры штрихкода удобно использовать на рабочих местах кассира для быстрого добавления товаров в чек, активации подарочных сертификатов и дисконтных карт. Также сканер будет незаменим для комплектации заказов на складе и идентификации материалов в производстве. Сканеры позволяют работать с маркированной продукцией – алкоголем, табачной продукцией, обувью и мн. другим.
Так как на рынке торгового оборудования представлено множество различных моделей сканеров штрихкодов, важно проверить, что настройки соответствуют техническим характеристикам модели и согласованы между собой.
Для проверки настроек сканера нажмите на кнопку «Тест подключения» (рис. 6).
Результат сканирования тестового штрихкода отобразится в окне теста оборудования (рис. 9).
В конце основных данных добавлен символ ‘CR’ – это суффикс, который вставляет сканер. Он дает программе понять, что полученный от оборудования текст является штрихкодом.
Смотрите также
Настройка USB сканера штрихкодов в 1С:Розница
Версия конфигурации: 2.1.7.14
Дата публикации: 27.08.2015
Для начала заходим в раздел Администрирование, слева выбираем Настройки подключаемого оборудования. Ставим галочку (если не стоит) Использовать подключаемое оборудование и переходим в раздел Подключаемое оборудование.
Открывается новое окно Подключение и настройка оборудования в этом окне выбираем Сканеры штрихкода и нажимаем кнопку Создать.
Откроется небольшое окно в котором основными пунктами будут:
1. Галочка Устройство используется
2. Тип оборудования: Сканеры штрихкодов
3. Драйвер оборудования: 1С:Сканеры штрихкода (NativeApi)
4. Нажимаем на изображение дискеты (Сохранить)
5. И нажимаем кнопку Настроить
Теперь нам надо добавить какому либо товару штрихкод. Заходим в справочник Номенклатура и Заходим в карточку номенклатуры. В левом меню выбираем штрихкоды и добавляем штрихкод.
Теперь переходим в РМК(рабочее место кассира) и просто пробиваем штрихкод, без дополнительных нажатий клавиш. Штрихкод сразу должен считаться и добавиться в список.
Как уже говорилось ранее, этот способ удобен для быстрой настройки сканера штрихкодов для работы в РМК под Управляемыми формами. Для данной настройки был использован сканер штрихкодов Metrologic Eclipse MS 5145 USB без предустановленных драйверов.
Подключение и настройка сканера штрихкода
Подключаемое оборудование
В «1С:Управление аптечной сетью» в разделе Настройки подключаемого оборудования (Администрирование – Подключаемое оборудование) должен быть установлен флажок Использовать подключаемое оборудование.
Чтобы сохранить экземпляр необходимо нажать кнопку Записать и закрыть.
Рис. 1. Создание нового экземпляра подключаемого оборудования
Внешняя компонента «Сканер Штрихкода»
После сохранения элемента необходимо нажать на появившуюся на форме кнопку Настроить. В открывшейся форме все реквизиты будут заполнены автоматически.
Рис. 2. Окно настроек драйвера (Windows)
В таблице ниже представлены общие замечания по заполнению данных для Windows и Linux.
Доступные серийные (COM) порты
Устанавливает канал связи, по которому драйвер ожидает поступления данных. В случае Клавиатуры, драйвер будет ожидать событий клавиатуры. В случае одного из доступных COM-портов системы, он будет ожидать данных от него
HID клавиатурного устройства
Имеет смысл, только если в качестве Порта выбрано Клавиатура
Бит данных при передаче по COM порту
(имеет смысл, только если в качестве Порта выбрано COM устройство )
Стоп бит данных при передаче по COM порту
(имеет смысл, только если в качестве Порта выбрано COM устройство )
Диапазон значений от 110 до 256000
Скорость при передаче по COM порту
(имеет смысл, только если в качестве Порта выбрано COM устройство )
код символа от 0 до 127
Символ префикса, передаваемый сканером перед данными штрихкода
код символа от 0 до 127
Символ суффикса, передаваемый сканером после данных штрихкода
Время с начала ввода, за которое ожидается получение клавиатурных событий от сканера
Время с начала ввода, за которое ожидается получение данных от COM порта
Кодировка символов передаваемых сканером (как правило, UTF-8)
клавиша клавиатуры на выбор
Клавиша, нажатием которой, передается символ GS1 (#029)
Тип выходных данных
Тип выходных данных
Строка – данные как они получены от устройства
Base64 – данные полученные от устройства, преобразованные в Base64
Игнорировать состояние клавиатуры
Тест подключения
Чтобы понять, как сейчас настроен сканер, нужно нажать кнопку Тест подключения.
Рис. 3. Тест устройства (выделены подключенные устройства)
На Рис. 5 представлен результат сканирования тестового штрихкода в клавиатурном режиме. В конце основных данных добавлен символ ‘CR’ (#013) – это суффикс, который вставляет сканер после прочитанных данных штрихкода.
Рис. 6. Тест устройства после считывания штрихкода сканером в режиме COM-порта
Возможность подключения нескольких сканеров одновременно
Может быть подключено до 64 COM устройств (если они доступны, каждое устройство может быть подключено только один раз), и одно клавиатурное устройство.
Может быть подключено до 64 COM устройств (если они доступны, каждое устройство может быть подключено только один раз), и до 64 клавиатурных устройство с уникальным HID.
Штрихкоды, содержащие спецсимволы и символы GS1
Пример штрихкода в HRI (Human Readable Interpretation) форме GS1:
Рис. 8. Результат сканирования штрихкода для проверки клавиатурным сканером
Большинство сканеров передают символ GS1 либо нажатием клавиши F8, либо сочетанием клавиш Alt(down)+0+0+2+9+Alt(up) (поведение по умолчанию).
Если это не так, то можно настроить сканер и драйвер 1С:Сканер штрихкодов таким образом, чтобы их настройки были согласованы между собой. В этом случае, при сканировании штрихкода с Рис. 7. необходимо получить тот же результат, что и на Рис. 8. В противном случае, вместо ‘GS’ в результате будет отображена другая последовательность символов.
Однако, данные, которые могут быть кодированы некоторыми типами штрихкодов, не ограничиваются только наличием символа GS1, они могут содержать символы произвольного алфавита, как показано на Рис. 9.
Рис. 9. Результат сканирования в COM режиме штрихкода, содержащего данные кодированные последовательностью символов со сложным алфавитом
Закодированная последовательность символов содержит символы ‘NUL’ (#000), STX (#002), ESC (#027) и т.д. Естественно, что не все типы сканеров (устройств) содержат таблицы и другие механизмы для того, чтобы преобразовать произвольную последовательность символов в валидную последовательность клавиатурных событий. Как правило, использование сканеров (устройств) такого типа приводит к потерям данных, в виду того, что либо для символа нет сопоставления с клавиатурным событием внутри сканера (устройства), либо оно выполняется неизвестной последовательностью клавиатурных событий.
При работе с такими типами штрихкодов рекомендуется использование режима COM.
Тип выходных данных
В компоненте 1СCканер шрихкодов версии 9.х поддерживаются несколько типов исходящих данных:
Тип Строка предназначен для большинства случаев, поскольку, как правило, данные, полученные от сканера, состоят из символов ограниченного и известного алфавита (например, коды EAN8, EAN13 – только цифры, Code93 – цифры и латинские буквы и т.д.).
Тип Base64 предназначен для случаев, когда данные могут содержать неожиданные, непечатаемые спецсимволы. К таким типам штрихкодов можно отнести: PDF417 ОМС полиса, DataMatrix больничного листа, DataMatrix S1 (контрольные марки продукции, маркируемой средствами идентификации). К специальным символам так же относится и символ с кодом 0, который из-за ограничений технологии NativeApi нельзя передать между внешней компонентой и «1С:Предприятием». Подробнее о таких штрихкодах см. в разделе Штрихкоды, содержащие спецсимволы и символы GS1.
Настройка COM соединения
Стандартные настройки COM соединения драйвера 1С:Cканер штрихкодов отражают стандартные настройки COM большинства сканеров. Однако, в каких-то конкретных случаях это может не так. В таких ситуациях нужно воспользоваться инструкцией настройки своего сканера (устройства) и изменить настройки драйвера 1С:Сканер шрихкодов таким образом, чтобы они были согласованы. При правильной настройке в момент чтения тестовых штрихкодов в режиме COM будут получены результаты, как было показано на рисунках выше.
Android. Сканеры мобильных устройств
Настройка сканера на мобильных устройствах имеет свои особенности. Подключение внешних сканирующих устройств рекомендуется производить заранее в операционной системе.
Устройства, подключаемые через Bluetooth, могут определяться операционной системой по-разному: мультимедийное устройство ввода, внешняя клавиатура, Bluetooth-устройство и пр.
Рис. 10. Bluetooth-устройства, определенные операционной системой, как: мультимедийное устройство ввода, внешняя клавиатура, Bluetooth-устройство
Если сканер подключается, в режиме эмуляции клавиатуры, то в его настройках должен быть включен параметр Устройство ввода.
Рис. 11. Настройка для устройств ввода
Далее необходимо указать драйвер 1С:Сканер штрихкода (Native).
В параметрах подключения нужно выбрать значение Клавиатура для устройств, которые эмулируют режим Клавиатура:
Для внешних сканеров, подключаемых через Bluetooth, но не являющихся устройством ввода, необходимо в параметрах подключения выбрать само устройство.
Рис. 15. Настройка подключения Bluetooth-устройства
Чтобы такие сканеры не переключались в режим энергосбережения («спящий» режим) драйвером каждый 5 секунд производится опрос устройства.
Тестирование мобильной версии 1С:Сканер штрихкодов можно выполнить на тех же штрихкодах, что указаны выше.
Native Api 1C для сканер штрих кода
Самым простым и удобным способом установки сканера штрих кода в 1С является подключение с помощью технологии Native API. Она используется не только для создания сканера штрих кода, но и для других внешних компонентов. Благодаря ей возможно создавать программы, которые будут часто взаимодействовать с системой 1С. Ниже описана подробная инструкция, как это сделать.
Первый шаг
Изначально необходимо скачать сам драйвер Native Api. Это можно сделать по ссылке или найти и скачать в интернете. Но будьте внимательны и проверяйте файлы из неизвестных сайтов на вирусы.
Собственный интерфейс, такой как Native API может быть установлен на операционные системы Linux и Windows. Установка и использование бесплатны.
Второй шаг
Теперь необходимо разархивировать его. Открыть папку и нажать на файл установки. Следуйте подсказкам, которые появляются при каждом последующем шаге установки.
Этот драйвер дает возможность подключать сканер штрих кода через Com-порт или USB.
Третий шаг
Как только установка завершена, вы можете приступить к непосредственному соединению сканера штрих кода и используемой программой 1С на вашем персональном компьютере. Для этого необходимо подключить сканер любым удобным способом и открыть 1С.
Четвертый шаг
В программе откройте вкладку «Администрирование» и в ней зайдите в «Поиск оборудования». Найдите строку «Использовать подключаемое оборудование» и установите галочку напротив нее.
Теперь открывается новая вкладка под названием «Подключаемое оборудование», в которую необходимо зайти для дальнейшего подключения.
Пятый шаг
Перед вами открылось новое окно. В нём нужно выбрать тип оборудования, в нашем случае это «Сканеры штрих кода». Для создания пары с устройством нажимаете кнопку «Создать».
Шестой шаг
Во всплывшем окне ставите галочку рядом с пунктом «Устройство используется». Напротив строки «Драйвер оборудования» выбираете тот, у которого в скобочках написано «Native API». Далее сохраняете введенные данные, но окно не закрываете.
Седьмой шаг
В следующем этапе требуется нажать на вкладку «Настроить…» в этом же окне, после чего, программа выведет запрос на установку драйвера. Здесь обязательно нужно выбрать «Установить».
Восьмой шаг
В новом окне сверьте данные:
Сохраните введенные данные и закройте окно.
Это был последний шаг, после которого вы можете использовать сканер штрих кода. Для установки сканера штрих кода на иные операционные системы необходимо использовать другой драйвер. Настоятельно рекомендуем, для подключения сканера штрих-кода по технологии Native API обратиться к квалифицированным специалистам.
Как подключить сканер штрихкодов в типовых программах 1С
Для работы с маркированным товаром всем предприятиям торговли, как оптовым, так и розничным, потребуется сканер штрихкодов. В этой статье на примере сканера Mindeo MD6600-HD расскажем, как подключить устройство к типовой программе 1С.
Очень короткая инструкция по подключению сканера к компьютеру.
На странице сканера в разделе Документация есть инструкция с настроечными штрихкодами. По умолчанию сканер может читать все необходимые в торговле форматы штриховых кодов GS1 DataMatrix, EAN-8/13/ITF-14, PDF-14, QR и инверсионные коды на пачках сигарет.
Подключение сканера в программе
Сначала проверим работоспособность устройства. При подключении сканера к компьютеру должен прозвучать мелодичный звук, а при нажатии на «курок» – подсветиться поле считывания.
Далее в программе 1С нужно найти раздел Администрирование – Подключаемое оборудование. Там устанавливаем флажок Использовать подключаемое оборудование и переходим к списку Подключаемое оборудование. Для каждого экземпляра оборудования создается новая настройка – нажмите кнопку Создать и проверьте, что все нужные поля заполнены:
Устройство используется – должен быть установлен флажок;
Тип оборудования – должно быть указано значение Сканеры штрихкода;
Драйвер оборудования – выбрать из списка драйвер 1С:Сканеры штрихкода (NativeApi);
Рабочее место и Наименование – будут заполнены автоматически данными из системы;
Серийный номер – вводить не обязательно. Но для удобства учета оборудования в этом поле можно сохранить заводской номер устройства.
Сохраняем запись нажатием на «дискетку» и переходим к настройке сканера (кнопка Настроить). При открытии формы мы увидим, что основные настройки заполнены значениями по умолчанию, которые в большинстве случаев обеспечивают работу сканера.
Канал поступления информации определятся параметром Порт. Возможны два режима работы сканера – в режиме эмуляции клавиатуры – это когда компьютер воспринимает символы, поступающие из сканера так же, как если бы мы набирали штрихкод на клавиатуре, и режим работы com-порт. Некоторое время назад компьютеры оснащались разъемами RS-232, как на картинке слева.
Современные сканеры выпускаются с другим стандартом подключения – USB (на картинке справа), а работа с последовательным com-портом эмулируется с помощью программ-эмуляторов.
Допустим, в настройках выбран режим Клавиатура. В этом случае доступны еще несколько настроек:
Таймаут клавиатуры определяет интервал времени, который программа ожидает поступление информации от сканера.
Флажок Игнорировать состояние клавиатуры означает, что при работе сканера в операционной среде Windows данные от сканера не будут зависеть от состояния переключателя CAPS LOCK в момент считывания кода.
Откроем окно «Тест подключения» и считаем какой-либо штрихкод. Например, лекарственного препарата с рисунка ниже.
Штрихкод должен отобразиться в окне в машиночитаемом виде – то есть отобразятся все символы, в том числе и служебные. Если в окне ничего нет, то попробуем считать код в текстовый файл, например, в приложении «Блокнот» или в текстовые поля таблицы Excel. Если и так не получается, то придется заняться настройкой сканера, обратившись к альбому настроечных штрихкодов.
Настройка сканера производится путем считывания специальных настроечных штрихкодов из руководства к сканеру. Чаще всего сначала считывается штрихкод, вводящий сканер в режим настройки, затем штрихкоды нужной настройки и в завершении – штрихкод, переводящий сканер в рабочий режим. Но есть модели, настройка которых производится без начального и финального штрихкодов.
Если вы не уверены, что сканер прежде, чем попал к вам в руки, не подвергался каким-либо настройкам, то сначала считайте штрихкод заводских настроек, таким образом, переведя сканер в первоначальное состояние. Заводские настройки сканера Mindeo – это режим клавиатуры, для других моделей может понадобиться считать штрихкод перевода сканера в режим эмуляции клавиатуры.
Снова считываем контрольный штрихкод в окно «Тест подключения».
Если этого не произошло, считайте штрихкод добавления суффикса ‘CR’ из альбома настройки сканера. Проверьте также, чтобы в настройке Суффикс в программе 1С тоже было выбрано значение 13(CR).
Если вы продаете маркированные товары, полезно проверить правильность настройки сканера, считав в окно теста подключения штрихкод, например, марки лекарственного препарата с рисунка ниже.
В коды маркировки в формате GS1 входит несколько параметров. Содержимое параметров определяется кодом группы применения. В нашем примере код марки представляет собой последовательность:
01 03582910094982 21 1382DGN9F3MN5’F12′ 91 EE06’F12′ 92 hOGMqk4C1xzKJbdu+o5VR9tiI9zl1Gz0qd9EL9F82qY=’CR’, коды применения – подчеркнуты.
В случае, если предполагается считывать штриховые коды, содержащие кириллицу, например, QR-коды больничных листов, необходимо подключить сканер в режиме эмуляции работы COM-порта.
Для этого потребуется выполнить несколько шагов:
1. Скачать с сайта производителя или поставщика драйвер эмуляции COM-порта и разместить его в файловой системе компьютера, например в папке С:\Drivers. В нашем случае это USB VCOM drivers v.1.6, любезно предоставленный службой техподержки.
2. Далее нужно, обратившись к документации на сканер, найти и считать штриховой код команды перевода сканера в режим эмуляции com-порта. Присоединить сканер к компьютеру и открыть Диспетчер устройств Windows. В нашем случае сканер определяется как неизвестное устройство. Но иногда бывает и как вторая клавиатура.
Открываем запись и обновляем драйвер, указав его местоположение в файловой системе компьютера.
3. После успешного завершения процесса, необходимо проверить в диспетчере устройств, определился ли com-порт, посмотреть настройки порта и убедиться, что настройки Бит данных, Стоп бит, Скорость сканера совпадают с указанными на странице настройки сканера в программе 1С.
Наконец считываем какой-либо штрихкод в форме Тест подключения программы 1С.
Не расстраивайтесь, если не получится настроить сканер с первого раза – сбросьте настройки на заводские и повторите все сначала.
Продолжим настройку. Чтобы правильно распознать кириллицу должна быть выбрано значение Windows-1251 в поле Кодировка com-порта.
Наконец, вне зависимости от того, как и в какой среде подключен сканер штрихкодов, если предполагается работа с кодами маркировки, в том числе формирование чеков на кассовом аппарате, настройка Тип выходных данных должна быть выбрана Base64. Это позволит получать от сканера и передавать в кассовый аппарат через платформу 1С данные без каких-либо потерь.
Настройка сканера в ОС Linux и Android
В операционной среде Linux может быть подключено до 64 COM-устройств и до 64 клавиатурных устройств с уникальным HID. Параметр HID-устройство на форме настройки сканера в программе 1С определяет, какому именно каналу соответствует данный сканер.
Следует также учитывать, что в среде Linux символ окончания штрихкода кодируется последовательностью ‘LF’, и для Android – ‘CR’ и настроить сканер соответствующим образом.
В зависимости от параметров телефона или планшета под управлением ОС Android, сканер может определиться как внешняя клавиатура, мультимедийное устройство или Bluetooth-устройство. Если планируется использовать сканер в режиме клавиатуры, в настройках нужно установить параметр подключения Устройство ввода.
Затем перейти в программу 1С и выполнить настройку сканера – создать запись в справочнике Подключаемое оборудование, выбрав тип устройства Устройство ввода, и драйвер – 1С:Сканер штрихкодов (NativeAPI). В параметрах подключения сканера нужно выбрать значение Клавиатура параметра Устройство. По умолчанию в режиме клавиатуры подключаются сканеры, встроенные в Терминалы сбора данных, сканеры, подключенные через USB, а также те сканеры, которые при сопряжении были определены пользователем, как устройство ввода.
Для сканера, подключенного по протоколу Bluetooth, в настройках драйвера нужно для параметра Устройство вместо значения Клавиатура выбрать из списка само устройство.
Если планируется сканировать штрихкоды маркировки, необходимо настроить Тип выходных данных и Символ GS, аналогично тому, как это показано выше для среды Windows.
Подобрать сканер можно здесь. Если затрудняетесь с выбором или нужна консультация по продукту, выберите оборудование, которое кажется вам наиболее подходящим и оставьте заявку – с вами свяжется партнер 1С из вашего региона и ответит на все вопросы.