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

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

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

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

Типы макетов и выбор метода создания

Прежде чем писать код, необходимо определиться с типом макета, который будет создан. Платформа поддерживает два основных типа: макеты компоновки данных (СКД) и обычные табличные макеты. Макеты компоновки данных являются стандартом де-факто для сложных отчетов, так как они позволяют разделять логику выборки данных и их визуального представления.

Обычный табличный макет представляет собой простую сетку ячеек, аналогичную листу Excel. Он подходит для простых документов, таких как накладные или счета-фактуры, где структура жестко фиксирована и не требует сложной группировки или иерархии. Создание такого макета программно осуществляется через объект ТабличныйДокумент или путем клонирования пустого макета из хранилища.

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

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

Инициализация объекта макета и работа с областями

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

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

Рассмотрим пример получения области из макета компоновки данных.

Макет = Документы.РеализацияТоваровУслуг.ПолучитьМакет("ПечатнаяФорма");
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьТовары = Макет.ПолучитьОбласть("Товары");
ОбластьПодвал = Макет.ПолучитьОбласть("Подвал");

После получения области вы можете манипулировать её содержимым. Вы можете заменять параметры, указанные в макете, на реальные значения из базы данных. Это делается через объект ПараметрыКомпоновкиДанных или прямой присваивание значений ячейкам табличного документа, если макет был выведен в него.

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

Наполнение макета данными и параметрами

Самый ответственный этап — заполнение макета реальными данными. Для макетов компоновки данных этот процесс автоматизирован через механизм КомпоновщикНастроекКомпоновкиДанных. Однако при программном создании часто требуется ручное заполнение параметров.

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

• 📄 Используйте структуру Структура или Соответствие для хранения параметров перед выводом.
• 🔢 Проверяйте типы данных: строковые параметры не должны получать числа без явного преобразования.
• 🎨 Для форматирования дат используйте строковые представления в нужном формате, например Формат(Дата, "ДФ=dd.MM.yyyy").

Если вы формируете табличный документ вручную, вам предстоит работать с ячейками напрямую. Вы можете обращаться к ячейке по координатам или по имени области. Значение ячейки устанавливается свойством Текст или Значение.

⚠️ Внимание: При присваивании значений убедитесь, что тип данных соответствует ожидаемому в макете. Попытка записать объект типа "СправочникСсылка" в ячейку, ожидающую строку, может привести к выводу служебного представления объекта или ошибке выполнения.

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

Работа с табличным документом как выводной формой

Конечной точкой формирования макета чаще всего является объект ТабличныйДокумент. Именно он отображается на экране пользователя или отправляется на принтер. Макет сам по себе является лишь шаблоном, а табличный документ — это результат его обработки.

Процесс вывода макета в табличный документ называется компоновкой. Для макетов СКД используется объект ПроцессорКомпоновкиДанных. Он принимает макет, набор данных и настройки, а затем генерирует результат.

Процессор = Новый ПроцессорКомпоновкиДанных;
Процессор.Инициализировать(Макет, Настройки, Данные);
Процессор.СоздатьОбъектКомпоновки();
Результат = Процессор.РезультатКомпоновки;
ТабДок = Результат.Вывести(Новый НастройкиВыводаКомпоновкиДанных);

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

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

Сложное форматирование и условное оформление

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

В табличном документе каждая ячейка имеет свойства ЦветФона, Шрифт, ТолькоПросмотр и другие. Изменяя их в цикле, можно создать "тепловую карту" продаж или выделить просроченные задолженности.

Свойство	Тип значения	Описание	Пример использования
ЦветФона	Цвет	Устанавливает цвет фона ячейки	Ячейка.ЦветФона = Цвет.Красный
Шрифт	Шрифт	Определяет гарнитуру и стиль текста	Ячейка.Шрифт = Новый Шрифт("Arial", 12, Жирный)
ГоризонтальноеВыравнивание	Перечисление	Положение текста по горизонтали	Ячейка.ГоризонтальноеВыравнивание = ПоЦентру
АвтоМасштаб	Булево	Автоматический подбор размера шрифта	Ячейка.АвтоМасштаб = Истина

При использовании условного оформления в СКД вы описываете правила в объекте ЭлементУсловногоОформления. Там указывается условие (например, "Сумма > 1000") и оформляемые поля (цвет, шрифт). Это более декларативный подход, который удобнее поддерживать.

⚠️ Внимание: Интерфейс и свойства объектов форматирования могут незначительно отличаться в разных версиях платформы 1С. Всегда проверяйте синтаксис-помощник для вашей конкретной версии платформы, особенно при работе с новыми типами цветов или шрифтов.

Не забывайте про объединение ячеек. Метод ОбъединитьЯчейки() позволяет создавать сложные заголовки таблиц, занимая несколько строк или столбцов. Это критически важно для создания профессионально выглядящих печатных форм.

Сохранение, печать и экспорт макета

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

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

Как отправить макет на принтер без показа окна?

Используйте метод ТабДок.Показать(ПараметрыВывода), где в параметрах укажите режим вывода "ТолькоПечать". Окно предпросмотра не откроется, документ сразу уйдет на принтер по умолчанию.

Если требуется программное сохранение в файл, используйте метод Записать(). Он поддерживает множество форматов: MXL (родной формат 1С), PDF, XLSX, ODS. Выбор формата зависит от требований пользователя.

ПараметрыЗаписи = Новый ПараметрыЗаписиТабличногоДокумента;
ПараметрыЗаписи.ТипФайла = ТипФайлаТабличногоДокумента.PDF;
ПараметрыЗаписи.ИмяФайла = "C:\Reports\Отчет.pdf";
ТабДок.Записать(ПараметрыЗаписи);

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

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

Как получить доступ к макету из внешнего отчета?

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

Почему макет не видит параметры, которые я передаю?

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

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

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

Как добавить картинку в макет программно?

Для этого нужно получить ячейку, предназначенную для изображения, и присвоить ей свойство Картинка. Значением свойства должен быть объект типа ХранениеКартинки, который можно загрузить из файла или из базы данных.