Как расширить область в макете 1С

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

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

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

Что такое область макета и зачем её расширять

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

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

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

Как расширить область в конфигураторе вручную

Интерактивное расширение выполняется прямо в редакторе макета и не требует написания кода. Это основной способ при разовой доработке печатной формы.

1. 1
   Откройте конфигуратор и найдите нужный макет (Общие → Макеты или макет конкретного объекта).
2. 2
   Выделите область: кликните по её имени в серой рамке слева или сверху, либо выделите диапазон ячеек.
3. 3
   Откройте свойства области: правый клик → Свойства, либо меню Таблица → Имена → Имя строк/колонок.
4. 4
   Измените диапазон: увеличьте номер конечной строки или колонки в свойствах имени.
5. 5
   Либо просто перетащите границу области мышью за квадратный маркер на её углу.
6. 6
   Сохраните макет и обновите конфигурацию базы данных, если макет входит в состав конфигурации.

Есть и альтернативный путь: выделите нужный новый диапазон ячеек целиком, затем через меню Таблица → Имена → Назначить имя задайте то же имя области — старый диапазон будет заменён новым. Это удобно, когда область нужно не просто расширить, а сместить.

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

Программное расширение области через встроенный язык

Когда размер области зависит от данных — например, количество строк табличной части заранее неизвестно — границами управляют программно. В типовом подходе область-шаблон одной строки выводится в цикле, и «расширение» происходит за счёт многократного вывода, а не изменения самого макета.

Если же требуется изменить границы именованной области в готовом табличном документе, используется объект ОбластьЯчеекТабличногоДокумента: у него доступны свойства Верх, Низ, Лево, Право, которые определяют диапазон. Изменяя эти свойства, можно расширить область уже после того, как документ сформирован.

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

// Программное расширение области в готовом документе
Область = ТабДок.Область("R5C1:R7C4");
Область.Имя = "РасширеннаяОбласть";

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

Расширение области в макете СКД и внешних печатных формах

В макетах системы компоновки данных понятие области работает иначе: макет СКД строится из макетов группировок и ресурсов, и «расширение» там сводится к добавлению нового поля или ячейки в макет группировки. Прямого перетаскивания границ, как в табличном документе, нет — редактируется состав полей.

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

Проверка результата после расширения области

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

Отдельно проверьте печать на бумагу или предпросмотр: расширение по ширине может привести к тому, что документ перестанет помещаться на лист выбранного формата. В этом случае настройте масштаб, ориентацию страницы или параметры АвтоМасштаб табличного документа.

Типичные ошибки и ограничения

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

Когда расширять область, а когда создавать новую

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

Часто задаваемые вопросы