Как вставить штрихкод в макет 1С

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

В типовых конфигурациях (Управление торговлей, ERP, Комплексная автоматизация, Розница) компонента уже встроена, и для вывода штрихкода достаточно нескольких строк кода в модуле менеджера печати. В самописных и старых конфигурациях компоненту иногда приходится подключать отдельно.

Ниже разобраны оба сценария: вставка штрихкода непосредственно в макет табличного документа и программное формирование картинки штрихкода с выводом в область печатной формы. Инструкции применимы к платформе 1С:Предприятие 8.3 в управляемых и обычных формах.

Проверка наличия компоненты печати штрихкодов

Перед изменением макета убедитесь, что в конфигурации есть механизм формирования штрихкодов. В типовых решениях на БСП (Библиотека стандартных подсистем) за это отвечает общий модуль МенеджерОборудованияВызовСервера или подсистема «Печать этикеток и ценников», а сама компонента хранится в макете конфигурации (обычно с именем вида «КомпонентаПечатиШтрихкодов»).

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

Способ 1: картинка типа «Штрих-код» прямо в макете

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

1. 1
   Откройте конфигуратор, найдите нужный макет (например, у документа в ветке «Макеты») и откройте его.
2. 2
   Выделите ячейку, в которой должен быть штрихкод, и через меню «Таблица → Рисунки → Вставить рисунок» добавьте картинку.
3. 3
   Откройте свойства рисунка и установите свойство «Тип» в значение «Штрих-код».
4. 4
   Укажите «Тип штрихкода» (EAN13, Code128, QRCode и др.) и в свойстве «Штрихкод» или через параметр задайте источник данных.
5. 5
   Задайте имя рисунка, например «Штрихкод», чтобы обращаться к нему из кода.
6. 6
   Сохраните макет и проверьте печать документа.

Чтобы подставить в штрихкод данные документа, в модуле формирования печатной формы обратитесь к рисунку области:

ОбластьМакета = Макет.ПолучитьОбласть("Шапка");
ОбластьМакета.Рисунки.Штрихкод.Штрихкод = "4601234567890";
ТабличныйДокумент.Вывести(ОбластьМакета);

Обратите внимание: значение должно соответствовать формату выбранного типа. Для EAN13 это 13 цифр (либо 12, если контрольная цифра рассчитывается автоматически), для Code128 допустимы буквы и цифры. При несоответствии формата штрихкод не выводится или выводится с ошибкой.

Способ 2: программное формирование через компоненту

Если штрихкод нужно формировать динамически — с настройкой размера, угла поворота, отображения текста под кодом — используется программный вызов компоненты. В конфигурациях на БСП есть готовая функция:

// Параметры: тип штрихкода, значение, ширина, высота и др.
ПараметрыШтрихкода = ГенерацияШтрихкода.ПараметрыГенерацииШтрихкода();
ПараметрыШтрихкода.Ширина = 200;
ПараметрыШтрихкода.Высота = 100;
ПараметрыШтрихкода.ТипКода = 1; // EAN13
ПараметрыШтрихкода.Штрихкод = "4601234567890";
ПараметрыШтрихкода.ОтображатьТекст = Истина;

Результат = ГенерацияШтрихкода.ИзображениеШтрихкода(ПараметрыШтрихкода);
Если Результат.Результат Тогда
Картинка = Результат.Картинка; // двоичные данные изображения
КонецЕсли;

Полученную картинку помещают в макет: либо в заранее добавленный рисунок типа «Картинка», либо вставляют в ячейку табличного документа:

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

В конфигурациях без БСП компоненту подключают напрямую через ПодключитьВнешнююКомпоненту с указанием макета, где хранится компонента, и затем создают объект Новый COMОбъект или объект компоненты для генерации изображения. Точный синтаксис зависит от версии компоненты, поэтому ориентируйтесь на примеры в поставке вашей конфигурации.

ОбластьМакета.Рисунки.Штрихкод.Штрихкод = СокрЛП(Номенклатура.Штрихкод);

Выбор типа штрихкода

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

Проверка результата и читаемости сканером

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

Проверьте размеры: у слишком маленького штрихкода сканер не различает узкие полосы. Для EAN13 не рекомендуется делать ширину меньше примерно 25–30 мм. Также оставляйте свободные поля (тихие зоны) слева и справа от кода — текст или рамка вплотную к штрихкоду мешают считыванию.

Типичные ошибки и их устранение

Самая частая проблема — пустое место вместо штрихкода. Причины: не подключена компонента, неверное имя рисунка в коде (обращение идёт к «Штрихкод», а рисунок назван «Рисунок1»), либо значение не соответствует формату. Проверяйте имя рисунка в свойствах макета и журнал регистрации на ошибки формирования печатной формы.

Вторая распространённая ситуация — ошибка «Недопустимое значение штрихкода» при EAN13. Часто в базе штрихкод хранится с пробелами или без контрольной цифры. Очищайте значение функцией СокрЛП и проверяйте длину перед выводом.

Где размещать доработку: макет, расширение или внешняя печатная форма

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

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

Частые вопросы