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

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

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

Основные типы макетов и их назначение

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

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

📊 Табличный документ: используется для счетов, накладных и сложных аналитических отчетов.
📄 Текстовый документ: оптимален для логов, простых списков и выгрузки в TXT.
🌐 HTML-макет: необходим для создания писем электронной почты и веб-отчетов.
🖼️ Графический макет: применяется для генерации изображений и схем.

Стоит отметить, что макеты могут быть общими или принадлежать конкретному объекту метаданных. Это влияет на область их видимости и способ обращения к ним из кода модуля.

Создание макета в окне Конфигуратора

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

После создания перед вами откроется редактор, интерфейс которого напоминает упрощенную версию Excel или Word, в зависимости от выбранного типа. Здесь вы задаете статическую часть вашего будущего документа: шапку, подвал, логотипы и постоянные тексты. Важно сразу настроить параметры макета, если вы планируете передавать в него данные из программы.

⚠️ Внимание: При создании макета в составе объекта (например, внутри Документа) он будет виден только в коде этого объекта. Для глобального доступа лучше использовать ветку "Общие макеты".

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

💡

Используйте именованные области в макете (например, ОбластьШапка, ОбластьТовары), чтобы программно обращаться к ним, не привязываясь к номерам строк и столбцов. Это защитит код от ошибок при изменении верстки.

Работа с областями и параметрами

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

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

Тип области	Назначение	Частота использования
Шапка	Константные данные документа	1 раз на документ
Строка	Повторяющиеся данные табличной части	N раз (по количеству строк)
Подвал	Итоговые суммы и подписи	1 раз в конце
Колонтитул	Нумерация страниц, дата печати	На каждой странице

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

☑️ Проверка настройки областей

Заданы уникальные именаОбласти не пересекаютсяИмена понятны разработчикуПараметры объявлены в свойствах

Выполнено: 0 / 4

Программное заполнение и вывод макета

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

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

Макет = Объект.ПолучитьМакет("МакетПечатнойФормы");
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьСтрока = Макет.ПолучитьОбласть("СтрокаТовара");

Шапка.Параметры.Номер = Документ.Номер;
Шапка.Параметры.Дата = Документ.Дата;

ТабДок = Новый ТабличныйДокумент;
ТабДок.Вывести(Шапка);

Для Каждого СтрокаТЧ Из Документ.Товары Цикл
Строка.Параметры.Номенклатура = СтрокаТЧ.Номенклатура;
Строка.Параметры.Количество = СтрокаТЧ.Количество;
ТабДок.Вывести(Строка);
КонецЦикла;

Использование параметризированного вывода через структуру Параметры является более современным и предпочтительным подходом по сравнению с прямым обращением к ячейкам по координатам. Это делает код более читаемым и устойчивым к изменениям в дизайне макета.

💡

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

Особенности макетов оформления и стилей

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

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

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

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

Как сбросить стиль ячейки?

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

Частые ошибки и методы отладки

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

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

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

Для отладки используйте режим отладчика 1С. Вы можете пошагово выполнять код и в окне "Выражение" смотреть содержимое объекта ТабличныйДокумент в любой момент времени. Также полезно выводить промежуточные макеты во временные файлы для визуальной проверки.

FAQ: Вопросы по работе с макетами

Как перенести макет из одной конфигурации в другую?

Вы можете выгрузить макет в файл формата .mxl через контекстное меню в Конфигураторе, а затем загрузить его в другой базе. Также можно использовать обработку выгрузки и загрузки конфигурации в файлы XML.

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

Да, если макет расположен в ветке "Общие макеты", он доступен для всех объектов конфигурации. Это удобно для создания единых бланков счетов или актов для разных типов документов.

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

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

В чем разница между макетом и схемой компоновки данных (СКД)?

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

Руководство по созданию макетов в 1С Предприятие