Как добавить новую печатную форму в 1С УНФ

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

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

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

Подготовка к разработке и анализ требований

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

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

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

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

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

Разработка визуальной части документа происходит в редакторе макетов. Вы можете создать новый макет в составе объекта документа или вынести его в общие макеты, если планируется повторное использование. Для начала найдите нужный документ в дереве метаданных и добавьте новый элемент в ветку Макеты. Имя макета должно быть уникальным и понятным, например, МакетАктУслугНовый.

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

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

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

Разница между Табличным Документом и СКД

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

Регистрация печатной формы в системе

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

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

Также важно прописать форму в справочнике видов печатных форм, если такой механизм предусмотрен в вашей версии УНФ. Это позволяет пользователю выбирать новый бланк из выпадающего списка в интерфейсе "1С:Предприятие". Без этой регистрации даже идеально работающий код останется недоступным для обычного бухгалтера или менеджера.

Этап регистрации	Объект конфигурации	Действие разработчика
Создание макета	Документ/ОбщийМакет	Рисование таблицы, настройка параметров
Логика выбора	ОбщийМодуль/Обработка	Написание кода на встроенном языке
Интерфейс	СправочникВидыПечатныхФорм	Добавление новой записи в список
Тестирование	Режим Предприятия	Проверка вывода на экран и принтер

Написание кода для формирования данных

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

Для заполнения полей используется метод Параметры.Вставить(). Вы передаете имя параметра, которое задали в макете, и значение переменной из документа. Например: Параметры.Вставить("НомерДок", Документ.Номер). Если вы работаете с табличной частью документа (список товаров или услуг), потребуется цикл для заполнения строк таблицы в макете.

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

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

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

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

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

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

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

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

Частые ошибки и способы их устранения

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

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

• 📉 Пустые реквизиты: Проверьте, заполнены ли соответствующие поля в самом документе перед печатью.
• 🔒 Ошибки прав доступа: Убедитесь, что роль пользователя включает права на чтение используемых справочников и регистров.
• 🖨️ Проблемы с принтером: Проверьте настройки полей и ориентацию страницы в диалоге печати.

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

Почему после обновления пропала форма?

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

Вопросы и ответы по печатным формам

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

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

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

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

Почему в печатной форме неверная сумма НДС?

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

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

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