Как в 1С создать новую печатную форму

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

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

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

Подготовка макета печатной формы в конфигураторе

Первым этапом разработки является создание визуального шаблона. Для этого необходимо открыть конфигуратор и найти нужный объект метаданных, например, документ РеализацияТоваровУслуг. В дереве метаданных выберите свойство «Макеты» и создайте новый элемент. Имя макета должно быть уникальным в рамках объекта, например, МакетПечатнойФормыСчет.

⚠️ Внимание: При создании макета убедитесь, что выбран тип «Макет табличного документа». Использование других типов макетов (например, макет оформления) приведет к ошибке при попытке вывода данных на печать.

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

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

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

Написание кода модуля документа

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

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

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

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

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

Работа с областями и вывод данных

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

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

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

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

Как обрабатывать отсутствие данных в полях?

Если какое-либо поле может быть пустым (например, адрес или телефон), используйте условное форматирование или проверку в коде. Можно скрывать целые строки макета, если соответствующие реквизиты не заполнены, чтобы документ не содержал лишних пустот.

Интеграция с формой документа и командами

Чтобы пользователь мог воспользоваться новой формой, её нужно добавить в интерфейс. В форме объекта документа размещается кнопка, которая будет запускать процедуру печати. В современных версиях 1С (УТ 11, ERP, БСП) часто используется механизм команд панели навигации или командной панели формы.

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

Элемент интерфейса	Назначение	Метод вызова
Кнопка «Печать»	Запуск формирования	Обработчик Нажатие
Командная панель	Группировка действий	Команда интерфейса
Меню «Еще»	Дополнительные опции	Вложенная команда
Панель навигации	Быстрый доступ	Ссылка на отчет

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

Использование СКД для сложных отчетов

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

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

• 🔸 Гибкая настройка структуры отчета пользователем.
• 🔸 Автоматическое формирование итогов и промежуточных сумм.
• 🔸 Встроенные возможности вариативного оформления.

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

⚠️ Внимание: При выборе между классическим макетом и СКД оцените требования к жесткости формы. Если документ должен строго соответствовать утвержденному бумажному образцу, используйте табличные макеты. Если важна аналитика — выбирайте СКД.

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

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

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

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

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

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

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

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

Что делать, если данные не выводятся в макет?

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

Как скрыть нулевые значения в таблице?

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