Почему внешняя печатная форма 1С работает через Файл-Открыть, но выводит пустой макет при встраивании в конфигурацию?

← На главную

Разработка внешних печатных форм (ВПФ) — одна из самых частых задач программиста 1С. Однако начинающие разработчики часто сталкиваются с ситуацией, когда форма идеально работает при ручном запуске через Файл -> Открыть, но после регистрации в справочнике Дополнительные отчеты и обработки выводит только «шапку» макета без данных. В этой статье мы разберем, почему так происходит, проанализируем механизмы передачи параметров в современных конфигурациях и приведем правильные примеры кода для корректной работы печати.

Разбор причины: СсылкаНаОбъект против МассивОбъектов

Главная причина описанной проблемы кроется в архитектуре Библиотеки стандартных подсистем (БСП), которая используется в большинстве современных конфигураций (Бухгалтерия предприятия 3.0, Управление торговлей 11, ERP и др.). Рассмотрим ситуацию подробнее.

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

Система не открывает форму обработки.
Система обращается напрямую к экспортному методу Печать() в модуле объекта обработки.
В качестве входного параметра БСП передает не одну ссылку, а массив ссылок, даже если вы печатаете всего один документ.

В результате переменная СсылкаНаОбъект, на которую рассчитывал автор темы, оказывается пустой (или неопределенной), запрос не находит данных по «пустой» ссылке, и макет выводится незаполненным. Давайте выясним, как это исправить.

Шаг 1. Правильная структура модуля объекта

Проанализируем стандартную сигнатуру процедуры печати, которую ожидает БСП. Она должна быть расположена в модуле объекта вашей внешней обработки и иметь модификатор Экспорт. Рассмотрим обязательные параметры:


Процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода) Экспорт
    // Здесь начинается логика формирования печатной формы
КонецПроцедуры

Параметр МассивОбъектов — это именно тот список документов, которые пользователь выбрал в списке или открыл для печати. Именно его нужно использовать для получения данных.

Шаг 2. Корректировка запроса для получения данных

Рассмотрим пример кода из обсуждения. Изначально автор использовал условие в запросе ГДЕ Ссылка = &Ссылка. Это в корне неверно для встраиваемой печатной формы, так как форма должна поддерживать групповую печать. Если пользователь выделит в списке 10 документов и нажмет «Печать», ваша форма должна обработать их все за один вызов сервера.

Проанализируем правильный подход к построению запроса:


Запрос = Новый Запрос;
Запрос.Текст = 
    "ВЫБРАТЬ РАЗРЕШЕННЫЕ
    |    ТаблицаТовары.НомерСтроки КАК НомерСтроки,
    |    ТаблицаТовары.Номенклатура КАК Номенклатура,
    |    ТаблицаТовары.Количество КАК Количество,
    |    ТаблицаТовары.Ссылка КАК СсылкаНаДокумент
    |ИЗ
    |    Документ.ПеремещениеВЭксплуатации.Товары КАК ТаблицаТовары
    |ГДЕ
    |    ТаблицаТовары.Ссылка В (&МассивОбъектов)
    |УПОРЯДОЧИТЬ ПО
    |    СсылкаНаДокумент,
    |    НомерСтроки";

Запрос.УстановитьПараметр("МассивОбъектов", МассивОбъектов);
РезультатЗапроса = Запрос.Выполнить();

Важный момент: использование оператора В (&МассивОбъектов) вместо равенства позволяет запросу эффективно выбрать данные для всех переданных ссылок сразу. Это значительно повышает производительность системы.

Шаг 3. Обработка результатов запроса и вывод в макет

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

Рассмотрим пример цикла обработки:


ВыборкаПоДокументам = РезультатЗапроса.Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам);

Пока ВыборкаПоДокументам.Следующий() Цикл
    
    // Номер страницы или разделитель, если документ не первый
    Если ТабличныйДокумент.ВысотаТаблицы > 0 Тогда
        ТабличныйДокумент.ВывестиГоризонтальныйРазделительСтраниц();
    КонецЕсли;
    
    НачалоОбласти = ТабличныйДокумент.ВысотаТаблицы + 1;
    
    // Вывод шапки документа
    ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
    ОбластьШапка.Параметры.Заполнить(ВыборкаПоДокументам);
    ТабличныйДокумент.Вывести(ОбластьШапка);
    
    // Вывод строк документа
    ВыборкаСтрок = ВыборкаПоДокументам.Выбрать();
    Пока ВыборкаСтрок.Следующий() Цикл
        ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
        ОбластьСтрока.Параметры.Заполнить(ВыборкаСтрок);
        ТабличныйДокумент.Вывести(ОбластьСтрока);
    КонецЦикла;
    
    // Регистрируем область печати для формирования содержания (необязательно, но полезно для БСП)
    УправлениеПечатью.ЗадатьОбластьПечатиДокумента(ТабличныйДокумент, НачалоОбласти, ОбъектыПечати, ВыборкаПоДокументам.СсылкаНаДокумент);
    
КонецЦикла;

Как отладить встроенную печатную форму?

Автор вопроса справедливо спрашивает: «Как такое отладить?». Отладка внешних обработок в 1С имеет свои нюансы, так как при запуске из справочника Дополнительные отчеты и обработки код выполняется во временном файле на сервере.

Разберем основные методы отладки:

Метод «Заглушка» (самый простой): В коде процедуры Печать в самом начале добавьте проверку. Если код запущен не из БСП (например, массив объектов не определен), инициализируйте его вручную.


Если МассивОбъектов = Неопределено Тогда 
    // Этот блок сработает только при запуске через Файл-Открыть
    МассивОбъектов = Новый Массив;
    МассивОбъектов.Добавить(СсылкаНаТестовыйДокумент); 
КонецЕсли;

Использование внешних инструментов: Существуют специальные отладочные обработки (например, «Отладка внешних печатных форм»), которые имитируют поведение системы и вызывают метод Печать вашей обработки, позволяя останавливаться на точках останова в конфигураторе.
Остановка в серверном коде: Чтобы отладчик «поймал» выполнение кода во встроенной ВПФ, необходимо:
- Включить отладку на сервере (параметр запуска -debug).
- В конфигураторе зайти в Отладка -> Подключение -> Автоматическое подключение и установить флажок Фоновые задания.
- Использовать метод УстановитьТочкуОстанова() или просто поставить точку в модуле объекта, предварительно загрузив актуальную версию обработки в базу.