Как не выводить область в макете 1С: практическое руководство

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

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

Как устроен вывод областей макета

Табличный документ в 1С формируется последовательно: разработчик получает область из макета методом ПолучитьОбласть("ИмяОбласти"), заполняет её параметры и выводит в результирующий документ. Макет при этом — только шаблон. Само наличие области в макете не означает, что она появится на печати: она появится только после явного вызова ТабДок.Вывести(Область).

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

Способ 1. Условный вывод области через Если

Самый распространённый сценарий — область нужна не всегда, а по условию. В этом случае получение и вывод области помещают внутрь условного оператора. Типичный пример — строка со скидкой в счёте или акте:

Если ЗначениеЗаполнено(Скидка) И Скидка > 0 Тогда
ОбластьСкидка = Макет.ПолучитьОбласть("СтрокаСкидка");
ОбластьСкидка.Параметры.СуммаСкидки = Скидка;
ТабДок.Вывести(ОбластьСкидка);
КонецЕсли;

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

Если ПоказыватьИтоги Тогда
    ОбластьИтоги = Макет.ПолучитьОбласть("Итоги");
    ОбластьИтоги.Параметры.ИтогоСумма = ИтогоСумма;
    ТабДок.Вывести(ОбластьИтоги);
КонецЕсли;

Условие по данным документа

Часто решение о выводе зависит от реквизитов объекта: заполнен ли договор, есть ли комментарий, выбран ли способ доставки. Проверяйте данные до вывода области и учитывайте, что ЗначениеЗаполнено() корректно отрабатывает для пустых строк, дат и ссылок, но не для нулевых чисел в некоторых сценариях — число 0 считается заполненным значением. Для числовых проверок используйте явное сравнение.

Условие по настройке печатной формы

Если видимость области должна управляться пользователем, добавьте параметр в команду печати или реквизит-флажок в форму настроек. В модуле менеджера печати значение передаётся в процедуру формирования, и область выводится только при установленном флаге. Это удобнее, чем правка макета под каждого клиента.

Способ 2. Удалить область из макета навсегда

Если область не нужна никогда, правильнее удалить её из макета, а не скрывать кодом. Откройте макет в конфигураторе, выделите строки области, удалите их и убедитесь, что имя области больше не используется в коде. Оставшийся вызов ПолучитьОбласть("УдалённоеИмя") вызовет ошибку при формировании печатной формы.

Перед удалением выполните поиск по всей конфигурации (Правка → Глобальный поиск) по имени области. Области нередко используются в нескольких процедурах: например, общий макет может обслуживать печать нескольких видов документов. Удаление области, которая где-то ещё выводится, приведёт к падению печати у пользователей.

Способ 3. Пропуск области в цикле по строкам

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

Для Каждого СтрокаТЧ Из Товары Цикл
Если СтрокаТЧ.Количество = 0 Тогда
Продолжить;
КонецЕсли;
ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
ЗаполнитьЗначенияСвойств(ОбластьСтрока.Параметры, СтрокаТЧ);
ТабДок.Вывести(ОбластьСтрока);
КонецЦикла;

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

Способ 4. Управление видимостью через параметры макета

Иногда область вывести нужно, но часть её содержимого должна быть пустой. Тогда в ячейках макета используются параметры, а код просто не заполняет ненужные. Однако это работает только для текста: границы ячеек, высота строки и оформление останутся. Если требуется убрать строку целиком, возвращайтесь к условному выводу области.

Альтернатива — несколько вариантов области в одном макете: например, «ПодвалПолный» и «ПодвалКраткий». Код выбирает нужную область по условию. Это чище, чем попытки «затереть» часть уже выведенной области, и упрощает поддержку макета.

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

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

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

Границы безопасной самостоятельной доработки

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

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