Внешние печатные формы — пакетная печать и один запрос на данные

Правило

Внешняя печатная форма (ВПФ):

• Реализует стандартный интерфейс печати БСП: регистрация с видом «ПечатнаяФорма», назначение на конкретные документы, команды с идентификаторами, экспортная процедура Печать(МассивОбъектов, КоллекцияПечатныхФорм, ОбъектыПечати, ПараметрыВывода).
• Обрабатывает массив ссылок, а не одну: пользователь выделяет в списке 50 документов и печатает разом. Данные для всех — одним запросом по массиву (см. запросы в цикле).
• Заполняет ОбъектыПечати (УправлениеПечатью.ЗадатьОбластьПечатиДокумента) — без этого ломаются комплекты и печать по одному документу из пакета.
• Макет лежит внутри ВПФ. Типовые макеты и модули конфигурации ради печатной формы не изменяются — иначе теряется весь смысл ВПФ как обновляемо-независимой доработки.
• Форма проверяется на граничных документах: непроведённый, с пустой табличной частью, с табличной частью на несколько страниц.

Зачем

ВПФ — самый частый заказ «на вчера», и самые частые грабли в ней одинаковые: форму писали и проверяли на одном документе, а пользователь печатает пачку — и получает либо запрос в цикле на каждый документ (минута ожидания на 100 накладных), либо один общий лист без разбиения по документам, потому что ОбъектыПечати никто не заполнил. А доработка типового макета «заодно» снимает конфигурацию с поддержки ради одной печатной формы.

Неправильно

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

    ТабДок = Новый ТабличныйДокумент;
    Для Каждого Документ Из МассивОбъектов Цикл
        Запрос = Новый Запрос;                    // запрос в цикле:
        Запрос.УстановитьПараметр("Ссылка", Документ); // 100 документов = 100 запросов
        // ... выборка и вывод только этого документа
    КонецЦикла;
    // ОбъектыПечати не заполнены — комплекты и разбиение по документам не работают

КонецПроцедуры

Правильно

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

    ТабДок = Новый ТабличныйДокумент;
    Макет = ПолучитьМакет("МакетСчета"); // макет — внутри ВПФ

    Запрос = Новый Запрос;               // ОДИН запрос по всему массиву
    Запрос.УстановитьПараметр("Ссылки", МассивОбъектов);
    Запрос.Текст = "ВЫБРАТЬ ... ГДЕ Документ.Ссылка В (&Ссылки) УПОРЯДОЧИТЬ ПО ...";
    Выборка = Запрос.Выполнить().Выбрать(ОбходРезультатаЗапроса.ПоГруппировкам);

    Пока Выборка.Следующий() Цикл
        НомерСтрокиНачало = ТабДок.ВысотаТаблицы + 1;
        // ... вывод областей макета для одного документа
        УправлениеПечатью.ЗадатьОбластьПечатиДокумента(
            ТабДок, НомерСтрокиНачало, ОбъектыПечати, Выборка.Ссылка);
    КонецЦикла;

    // регистрация результата в коллекции печатных форм по идентификатору команды
КонецПроцедуры

Когда не применять

• Своя конфигурация не на поддержке, и форма нужна всем постоянно — печатную форму можно встроить в конфигурацию штатно; ВПФ ценна там, где типовую конфигурацию нельзя или дорого менять.
• Форма по замыслу печатается строго по одному документу (например, из собственной обработки с отдельным сценарием) — требование пакетности снимается, но один запрос на данные и макет внутри ВПФ остаются.

См. также

• Внешние отчёты и обработки — подключение через БСП, версия, безопасный режим
• Не выполнять однотипные запросы в цикле

• Не выполнять однотипные запросы в цикле
• Внешние отчёты и обработки — подключение через БСП