Драйвер весов в 1С: подключение внешней компоненты и выгрузка товаров из своей обработки

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

Что такое драйвер весов для 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, пустые цены и слишком длинные коды проще показать пользователю понятным текстом, чем разбирать код ошибки, который вернули весы.

Интеграция и веб-сервисы

1С-ЭДО, 1С-Отчётность и КриптоПро CSP 5.0: что нужно для электронной подписи в 1С

Что нужно для электронной подписи в 1С: КЭП, КриптоПро CSP 5.0 и его лицензии, настройка программ и сертификатов, подключение 1С-ЭДО и 1С-Отчётности, МЧД сотрудников и разбор частых ошибок.

Торговое оборудование, Алгоритмы

Штрихкод весового товара: структура EAN-13, префиксы 20–29 и настройка в 1С

Структура штрихкода весового товара EAN-13: префикс, код товара, вес и контрольная цифра. Как согласовать схему на весах, в 1С и на кассе, и функции 1С для разбора и формирования такого штрихкода.

Торговое оборудование, Алгоритмы

Автоматическая выгрузка товаров в весы по расписанию из 1С

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

Торговое оборудование, УТ 11.3

Подключение весов CAS LP по Ethernet: конвертер RS-232, IP-адрес, порт и проверка связи

Как работают весы CAS LP в сети через конвертер RS-232–Ethernet: настройка IP-адреса и порта, согласование скорости и адреса весов, проверка связи и разбор ошибок драйвера.