PDF417 в 1С: установка компоненты и вывод штрихкода

Двумерный штрихкод PDF417 в 1С чаще всего требуется для печати квитанций на оплату (по ГОСТ Р 56042-2014), транспортных накладных, регистрационных документов и форм для госорганов. В типовых конфигурациях он либо уже есть в составе подсистемы печати штрихкодов, либо подключается через внешнюю компоненту Native API — например, «1С:Библиотека подключаемого оборудования» или стороннюю DLL вроде Barcode.dll.

Проблема в том, что «установить PDF417» можно тремя разными способами: активировать готовый макет компоненты в типовой конфигурации, зарегистрировать внешнюю DLL через COM, либо сформировать картинку штрихкода программно без компонент вообще. Выбор зависит от версии платформы, разрядности клиента и того, кто будет формировать код — сервер или клиентское рабочее место.

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

Что нужно проверить перед установкой

Прежде чем искать и устанавливать компоненту, уточните три вещи. Во-первых, есть ли в конфигурации подсистема печати штрихкодов: в БСП-совместимых конфигурациях (УТ 11, ERP, БП 3.0, ЗУП 3.1) она называется «Генерация штрихкодов» или входит в модуль МенеджерОборудованияВызовСервера. Во-вторых, разрядность клиента 1С: 32-разрядная DLL не загрузится в 64-разрядный клиент и наоборот. В-третьих, где выполняется код — на тонком клиенте, толстом или на сервере: внешняя компонента должна быть доступна именно в том процессе, который формирует изображение.

Полезная проверка: откройте любую печатную форму, где штрихкод уже предусмотрен (например, этикетку в УТ), и посмотрите, выводится ли он. Если типовой механизм работает — отдельная установка не нужна, достаточно вызвать готовую функцию с типом «PDF417».

Способ 1. Использовать встроенную компоненту типовой конфигурации

В конфигурациях на Библиотеке стандартных подсистем компонента печати штрихкодов хранится в общем макете (обычно КомпонентаПечатиШтрихкодов) и поддерживает типы EAN-13, Code39, Code128, QR и PDF417. Устанавливать ничего не нужно — компонента подключается автоматически при первом обращении.

Для вывода PDF417 на печатную форму добавьте в макет табличного документа область-картинку, а в коде сформируйте изображение и поместите его в параметр. Типовой вызов выглядит примерно так:

ДанныеШтрихкода = Новый Структура;
ДанныеШтрихкода.Вставить("Штрихкод", СтрокаДляКодирования);
ДанныеШтрихкода.Вставить("ТипКода", 16); // 16 — PDF417 в типовой нумерации БСП
ДанныеШтрихкода.Вставить("Ширина", 400);
ДанныеШтрихкода.Вставить("Высота", 150);

Результат = ГенерацияШтрихкодов.ДанныеQRКода(ДанныеШтрихкода); // имя метода зависит от версии БСП

Точное имя общего модуля и номер типа кода смотрите в своей версии конфигурации: в разных релизах БСП интерфейс отличается. Найдите в конфигураторе функцию, формирующую двоичные данные картинки штрихкода, и перечисление типов — там будет строка «PDF417».

Способ 2. Подключить внешнюю компоненту Native API

Если конфигурация самописная или типовой подсистемы нет, используется внешняя компонента по технологии Native API. Она поставляется в виде ZIP-архива с DLL для разных платформ и подключается без регистрации в системе — это самый чистый способ, не требующий прав администратора.

1. 1
   Получите ZIP-архив компоненты (из поставки БПО, от разработчика компоненты или собранный самостоятельно)
2. 2
   Добавьте архив в конфигурацию как общий макет с типом «Двоичные данные»
3. 3
   В коде выполните УстановитьВнешнююКомпоненту() с указанием макета, затем ПодключитьВнешнююКомпоненту()
4. 4
   Создайте объект компоненты через Новый("AddIn.ИмяОбъекта") и вызовите метод формирования картинки
5. 5
   Сохраните полученные двоичные данные во временный файл и выведите в картинку табличного документа

Пример подключения:

Местоположение = "ОбщийМакет.КомпонентаPDF417";
УстановитьВнешнююКомпоненту(Местоположение);
Подключено = ПодключитьВнешнююКомпоненту(Местоположение, "PDF417", ТипВнешнейКомпоненты.Native);
Если Подключено Тогда
Компонента = Новый("AddIn.PDF417.Barcode");
Компонента.ЗначениеКода = СтрокаДанных;
ДвоичныеДанные = Компонента.ПолучитьШтрихкод();
КонецЕсли;

Имена свойств и методов у каждой компоненты свои — берите их из документации к конкретной DLL. Общий принцип одинаков: задать значение, параметры размера и получить картинку в виде двоичных данных или файла.

Способ 3. Регистрация COM-компоненты (Barcode.dll и аналоги)

Старые решения используют COM-объекты — например, «1С:Печать штрихкодов» (Barcode.ocx) или сторонние библиотеки. Такой вариант требует регистрации в операционной системе и прав администратора, а на 64-разрядном клиенте 32-разрядная COM-библиотека работать не будет.

Регистрация выполняется командой в командной строке с правами администратора:

regsvr32 "C:\Components\Barcode.dll"

После регистрации объект создаётся в коде через Новый COMОбъект("Barcode.Barcode"). Учтите ограничения: COM-объект работает только на том компьютере, где зарегистрирован, не работает в веб-клиенте и создаёт проблемы при обновлении платформы. Для серверного выполнения библиотеку нужно регистрировать на сервере 1С, а не на клиентских машинах.

Вывод штрихкода на печатную форму

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

Рисунок = ОбластьМакета.Рисунки.РисунокШтрихкода;
Рисунок.Картинка = Новый Картинка(ДвоичныеДанныеШтрихкода);

Для PDF417 критичны пропорции: это стековый код, у которого высота строки должна быть заметно меньше ширины, а общая ширина — достаточной для размещения всех колонок данных. На практике для квитанций по ГОСТ Р 56042-2014 ширина кода обычно составляет десятки миллиметров; если сжать картинку до маленького прямоугольника, сканер код не прочитает. Печатайте тестовый экземпляр и проверяйте чтение реальным сканером или приложением на смартфоне до запуска в работу.

Типичные ошибки и их решение

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

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

Альтернатива: генерация картинки без компонент

Если установка компоненты невозможна (например, ограничения безопасности на сервере или работа через веб-клиент), есть обходной путь: сформировать изображение PDF417 на стороннем сервисе или в отдельном скрипте и получить его в 1С через HTTP-запрос как готовый PNG. Это снимает вопрос разрядности и регистрации, но добавляет зависимость от внешнего сервиса и требует контроля передаваемых данных — в штрихкоде квитанции содержатся персональные и платёжные реквизиты.

FAQ