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

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

Встречаются драйверы трёх видов:
| Вид | Как подключается | Где встречается |
|---|---|---|
| Native API | Архив с библиотеками, подключается ПодключитьВнешнююКомпоненту | Современные драйверы по требованиям 1С, работают на клиенте и сервере |
| COM | Регистрируется в Windows (regsvr32), создаётся Новый COMОбъект | Старые драйверы и библиотеки производителей, только Windows |
| Драйвер для библиотеки подключаемого оборудования | Устанавливается в справочник оборудования, вызывается через типовые модули | Драйвер CAS для 1С, драйвер АТОЛ в УТ 11 и Рознице |
К COM-библиотекам относилась, например, CASLP.DLL от LavrSoft для весов CAS LP, к современным — CL Driver от CAS. Методы и параметры у каждой библиотеки свои, их описывает руководство программиста, которое поставляется вместе с драйвером.
Подключение компоненты из кода
Native API-компоненту удобно хранить в макете обработки или конфигурации в виде ZIP-архива. Тогда её не нужно раскладывать по рабочим местам вручную:
// Подключает компоненту из общего макета. Имя "ДрайверВесов" — ваше, класс — из документации драйвера. Функция ПодключитьДрайверВесов() Экспорт Местоположение = "ОбщийМакет.КомпонентаДрайвераВесов"; Если НЕ ПодключитьВнешнююКомпоненту(Местоположение, "ДрайверВесов", ТипВнешнейКомпоненты.Native) Тогда ВызватьИсключение "Не удалось подключить драйвер весов. Проверьте разрядность и состав архива компоненты."; КонецЕсли; Возврат Новый("AddIn.ДрайверВесов.ScaleDriver"); КонецФункции
COM-библиотеку сначала регистрируют на компьютере, где выполняется код, а потом создают объект по его программному идентификатору:
Функция СоздатьCOMДрайверВесов(ProgID) Экспорт Попытка Возврат Новый COMОбъект(ProgID); Исключение ВызватьИсключение "COM-объект " + ProgID + " не создан: " + ОписаниеОшибки() + ". Проверьте регистрацию библиотеки и разрядность клиента 1С."; КонецПопытки; КонецФункции
Клиент или сервер, 32 или 64 бита
- Компонента подключается там, где выполняется код. Выгрузка с кнопки на форме может работать на клиенте, регламентное задание — только на сервере 1С.
- Разрядность библиотеки должна совпадать с разрядностью процесса: 64-битный клиент или сервер не загрузит 32-битную COM-библиотеку. Старые драйверы часто бывают только 32-битными — для них нужен 32-битный клиент 1С.
- Если весы стоят в магазине, а сервер 1С в другом городе, выгружайте с клиента в магазине или ставьте на месте отдельный компьютер для обмена.
Подготовка товаров к выгрузке
Большинство ошибок обмена возникают не в драйвере, а в данных: два товара с одним PLU, пустая цена, слишком длинное название. Проверяйте таблицу до вызова драйвера — так ошибка будет понятна пользователю, а не превратится в загадочный код от весов.
// Таблица: PLU, КодТовара, Наименование, Цена, СрокГодности, Состав Функция ПроверитьТоварыДляВесов(Товары, МаксДлинаИмени = 28) Экспорт Ошибки = Новый Массив; ЗанятыеPLU = Новый Соответствие; Для Каждого Строка Из Товары Цикл Если Строка.PLU <= 0 Тогда Ошибки.Добавить(СтрШаблон("%1: не назначен PLU", Строка.Наименование)); ИначеЕсли ЗанятыеPLU[Строка.PLU] <> Неопределено Тогда Ошибки.Добавить(СтрШаблон("PLU %1 занят товарами «%2» и «%3»", Строка.PLU, ЗанятыеPLU[Строка.PLU], Строка.Наименование)); Иначе ЗанятыеPLU.Вставить(Строка.PLU, Строка.Наименование); КонецЕсли; Если Строка.Цена <= 0 Тогда Ошибки.Добавить(СтрШаблон("%1: нет цены", Строка.Наименование)); КонецЕсли; Если СтрДлина(Строка.КодТовара) > 5 Тогда Ошибки.Добавить(СтрШаблон("%1: код %2 не помещается в штрихкод", Строка.Наименование, Строка.КодТовара)); КонецЕсли; Строка.Наименование = Лев(СокрЛП(Строка.Наименование), МаксДлинаИмени); КонецЦикла; Возврат Ошибки; КонецФункции
Многие драйверы принимают товары одним пакетом в XML или JSON. Пакет удобно собирать отдельной функцией — её можно вызвать без весов и посмотреть результат глазами:
Функция ТоварыВXML(Товары) Экспорт Запись = Новый ЗаписьXML; Запись.УстановитьСтроку("UTF-8"); Запись.ЗаписатьОбъявлениеXML(); Запись.ЗаписатьНачалоЭлемента("Goods"); Для Каждого Строка Из Товары Цикл Запись.ЗаписатьНачалоЭлемента("Item"); Запись.ЗаписатьАтрибут("PLU", Формат(Строка.PLU, "ЧГ=0")); Запись.ЗаписатьАтрибут("Code", Строка.КодТовара); Запись.ЗаписатьАтрибут("Name", Строка.Наименование); Запись.ЗаписатьАтрибут("Price", Формат(Строка.Цена, "ЧДЦ=2; ЧРД=.; ЧГ=0")); Запись.ЗаписатьАтрибут("ShelfLife", Формат(Строка.СрокГодности, "ЧГ=0; ЧН=0")); Запись.ЗаписатьКонецЭлемента(); КонецЦикла; Запись.ЗаписатьКонецЭлемента(); Возврат Запись.Закрыть(); КонецФункции
Имена элементов и атрибутов здесь условные: точный формат пакета задаёт драйвер, его описание есть в руководстве программиста.
Вызов драйвера и обработка ошибок
Изолируйте вызовы конкретного драйвера в одной функции. Если весы заменят на другую модель, придётся переписать только её, а подготовка данных и журнал останутся прежними.
Функция ВыгрузитьВВесы(Драйвер, Товары, ПараметрыСвязи) Экспорт Ошибки = ПроверитьТоварыДляВесов(Товары); Если Ошибки.Количество() > 0 Тогда Возврат Новый Структура("Успех, Ошибки", Ложь, Ошибки); КонецЕсли; Пакет = ТоварыВXML(Товары); Попытка // Здесь — методы вашего драйвера: установка параметров связи, открытие соединения, // передача пакета и закрытие. Их имена и коды возврата берутся из руководства программиста. Результат = ВызватьМетодыДрайвера(Драйвер, ПараметрыСвязи, Пакет); Исключение Результат = Новый Структура("Успех, Ошибки", Ложь, ОписаниеОшибки()); КонецПопытки; ЗаписьЖурналаРегистрации("Обмен с весами", ?(Результат.Успех, УровеньЖурналаРегистрации.Информация, УровеньЖурналаРегистрации.Ошибка), , , СтрШаблон("Весы %1, товаров %2, результат: %3", ПараметрыСвязи.Адрес, Товары.Количество(), Результат.Успех)); Возврат Результат; КонецФункции
Перед первой выгрузкой проверьте драйвер на одном товаре: запишите PLU, прочитайте его обратно и сравните поля. Так сразу видно проблемы с кодировкой, ценой и длиной названия.
Когда своя обработка не нужна
Если конфигурация типовая и весы поддерживаются драйвером CAS для 1С или драйвером АТОЛ, свой код обычно не нужен: выгрузка, правила обмена и частичная выгрузка уже есть в форме обмена с офлайн-оборудованием. Как её настроить, описано в статье о загрузке товаров в весы CAS из 1С, а как запускать без участия пользователя — в статье об автоматической выгрузке по расписанию.
Актуальность для новых версий
Методы подключения внешних компонент (ПодключитьВнешнююКомпоненту, Новый COMОбъект) работают на всех актуальных версиях платформы 8.3. В веб-клиенте и на Linux COM-компоненты недоступны — для них нужны Native API-драйверы.
Частые вопросы
Чем Native API отличается от COM-компоненты?
Native API-компонента подключается из архива средствами платформы и работает на клиенте и сервере, в том числе на Linux. COM-компонента регистрируется в Windows и работает только там.
Почему 1С не создаёт COM-объект драйвера весов?
Чаще всего библиотека не зарегистрирована на этом компьютере или её разрядность не совпадает с разрядностью клиента 1С. 32-битная библиотека не загрузится в 64-битный процесс.
Где взять имена методов драйвера весов?
В руководстве программиста, которое поставляется с драйвером. У разных производителей методы и формат данных различаются.
Можно ли выгружать в весы из регламентного задания?
Да, если драйвер подключается на сервере 1С и его разрядность совпадает с разрядностью сервера. Весы должны быть доступны с сервера по сети.
Зачем проверять товары до вызова драйвера?
Повторяющиеся PLU, пустые цены и слишком длинные коды проще показать пользователю понятным текстом, чем разбирать код ошибки, который вернули весы.