К статье
Практический материал

Другое · 7 мин

Как не выводить область в макете 1С

Как не выводить область в макете 1С: условия вывода, проверка имён, типичные ошибки и безопасное управление печатью без риска для данных и отчётов.

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

Способ управления зависит от типа макета и от того, из какой процедуры происходит печать. В табличных документах чаще используется вызов метода вывода области по имени, в текстовых и HTML-макетах — подстановка параметров и блоков. Если имя области указано неверно или условие не выполнено, область просто остаётся вне итогового документа.

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

Что такое область макета и где она управляется

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

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

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

Когда область не попадает в результат

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

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

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

Порядок действий
  1. 1
    Найти модуль, который отвечает за печать нужной формы
  2. 2
    Убедиться, что имя области в коде совпадает с именем в макете
  3. 3
    Проверить условие, при котором вызывается вывод области
  4. 4
    Печатать тестовый документ и сверить наличие или отсутствие фрагмента

Управление выводом через условия и параметры

Чтобы область не выводилась при определённых данных, оберните её вывод в условие. Например, выводить блок скидок только если сумма скидки больше нуля, а блок серийных номеров — только для товаров с учётом серий. Условие проверяется перед вызовом вывода, поэтому при `Ложь` область просто пропускается.

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

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

Имя областиСовпадает ли с кодом

Сравните имя в свойствах макета и строке вызова

Условие выводаВыполнено или нет

Проверьте значения параметров перед печатью

РезультатЕсть или нет фрагмент

Сравните тестовый печатный документ с ожиданием

Проверка перед печатью и отладка

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

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

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

Ограничения и риски при изменении макетов

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

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

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

Альтернативы и частые ошибки

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

Типичные ошибки
01
Опечатка в имени области в коде приводит к отсутствию фрагмента без сообщения об ошибке
02
Изменение типового макета без расширения усложняет обновление конфигурации
03
Скрытие области в печати не заменяет проверку обязательности заполнения данных

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

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

Итог

Что важно запомнить

Область не попадает в результат без явного вывода по имени и выполненного условия; проверяйте имена, параметры и все модули печати перед изменением рабочей базы.

Можно ли просто удалить область из макета?

Да, если область больше не нужна ни в одном отчёте. Перед удалением убедитесь, что ни один модуль не вызывает её по имени, иначе код может работать некорректно или вызывать ошибку при выполнении.

Почему область не выводится, хотя есть в макете?

Наличие области в редакторе недостаточно. Нужно явное обращение по имени в коде печати и выполнение условия отбора. Также проверьте совпадение имён и отсутствие других процедур, которые перекрывают вывод.

Безопасно ли править типовой макет напрямую?

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

Как проверить, что область действительно скрыта?

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