Другое · 6 мин
Печатная форма документа в 1С: создание и настройка
Пошагово: где в конфигураторе 1С создается макет печатной формы, как подключить процедуру печати к документу и проверить результат без риска для данных.
Печатная форма в 1С — это оформленный макет, который платформа выводит на печать или сохраняет в файл по команде из карточки документа. Она состоит из внешнего вида макета и программной логики, которая заполняет макет данными конкретного документа.
Разница между простым отчетом и печатной формой документа в привязке к экземпляру документа: форма знает, какой документ печатать, и подставляет его реквизиты, табличную часть и константы организации.
Работа ведется в конфигураторе: создается или правится макет, добавляется процедура печати, настраивается команда интерфейса. Основное ограничение — не править поставляемую типовою конфигурацию напрямую, если планируется обновление.
Перед любыми изменениями нужно сохранить резервную копию конфигурации и базы, а проверку проводить на отдельной копии, а не в рабочей базе.
Где в конфигураторе находится печатная форма
Печатные формы обычно оформляются через общие макеты конфигурации. В managed-приложении макет может быть табличным документом или внешней обработкой, а данные берутся из объекта документа, переданного в процедуру печати.
Если документ уже имеет стандартную форму, новая печатная форма не заменяет её автоматически. Нужно явно добавить команду «Печать» или расширить существующую, иначе пользователь не увидит новый вариант в интерфейсе.
Создание макета печатной формы
В конфигураторе откройте раздел общих макетов и создайте новый макет под подходящий тип. Для документов чаще используется табличный документ, где удобно располагать заголовок, реквизиты шапки и области строк табличной части.
Оформите макет так, чтобы поля соответствовали реквизитам документа: номер, дата, контрагент, договор, сумма, НДС и строки номенклатуры. Используйте области макета для повторяющихся блоков, например строк табличной части.
- 1Откройте раздел «Макеты» конфигурации
- 2Создайте макет типа табличный документ или внешняя обработка
- 3Оформите заголовок, поля реквизитов и области табличной части
- 4Сохраните макет и обновите конфигурацию
После сохранения макета проверьте его имя: именно это имя будет использоваться в программном коде при получении макета. Ошибка в имени или опечатка в регистре приведут к тому, что процедура печати не найдет шаблон.
Не дублируйте стандартные макеты без необходимости. Если типовая конфигурация обновляется, изменения в стандартных объектах могут быть перезаписаны или вызвать конфликты при сравнении конфигураций.
Программная процедура печати документа
Процедура печати принимает ссылку на документ или массив объектов, получает макет по имени и заполняет его значениями реквизитов. Результат выводится в табличный документ, который затем отправляется на печать или в файл.
Важно обработать ситуацию, когда документов нет или макет не найден. В этом случае процедура должна сообщать об ошибке понятным образом, а не прерывать работу неочевидным исключением.
Процедура Печать(МассивОбъектов, ОбъектПечати, ПараметрыВывода) Экспорт
Макет = ПолучитьМакет("МакетПечатиДокумента");
ТабДок = Макет.ПолучитьОбъект();
// заполнение реквизитов и табличной части
ТабДок.Вывести();
КонецПроцедурыКод выше приведен только для иллюстрации структуры процедуры. Реальные имена макетов, методов и свойств зависят от конфигурации и режима приложения, поэтому их нужно уточнять в синхронном объекте конфигурации.
Процедуру принято размещать в общем модуле или в модуле объекта документа, откуда она вызывается командой интерфейса. Выбор места зависит от того, используется ли печать только для одного документа или для нескольких однотипных документов.
Как добавить кнопку печати в карточку документа
В управляемом интерфейсе команда печати добавляется через команду формы или общую команду, связанную с документом. В командном интерфейсе указывается представление, картинка и обработчик, который вызывает процедуру печати.
Способы вызова печати
Подходит, если типовая конфигурация уже поддерживает нужный макет; ограничение — сложно изменить без доработки типа конфигурации.
Подходит для уникальных бланков и отчетов; ограничение — требует поддержки при обновлениях конфигурации.
Если нужно печатать из списка документов, команда настраивается для списка, а не только для карточки. В этом случае процедура получает массив выбранных объектов и может формировать одну или несколько печатных форм.
Проверка результата и типичные ошибки
После создания формы распечатайте документ с заполненными реквизитами и пустыми значениями. Проверьте, что поля не обрезаются, строки табличной части не убегают за границы страницы, а пустые реквизиты не выводят мусор.
Как проверить печатную форму
Команда активна и открывает форму
Команда отсутствует или неактивна
Реквизиты и строки соответствуют документу
Поля пустые, смещены или отсутствуют
Печатаются выбранные документы
Печатается только текущий или ни один
Обратите внимание на права доступа: пользователь должен иметь право на чтение документа и на использование команды печати. Иначе кнопка будет недоступна или форма откроется без данных.
Частая ошибка — привязка процедуры к несуществующему макету или опечатка в имени макета. Вторая ошибка — правка типовых объектов без резервной копии, что затрудняет возврат к рабочему состоянию после неудачного обновления.
Что важно запомнить
Печатная форма состоит из макета и процедуры печати; изменения тестируйте на копии, а типовые объекты не правите напрямую.
Нужно ли программировать любую печатную форму?
Не всегда. Если конфигурация уже содержит подходящий макет и команду, достаточно настроить видимость команды или параметры вывода. Программирование требуется, когда нужен нестандартный бланк или новая логика заполнения.
Можно ли править печатную форму прямо в рабочей базе?
Не рекомендуется. Любые изменения в макете или коде лучше вносить в копию конфигурации, проверять там и только после этого переносить в рабочую среду, чтобы не нарушить работу пользователей.
Что делать, если кнопка «Печать» не появляется?
Проверьте, добавлена ли команда в командный интерфейс формы документа, есть ли у пользователя права на выполнение команды и не скрыта ли форма правами доступа. Также убедитесь, что конфигурация сохранена и обновлена после изменений.
Отличается ли печать из списка и из карточки документа?
Да. Из карточки обычно передается один документ, из списка — массив выбранных документов. Процедура печати должна поддерживать оба случая, если команда используется в обоих местах.
Нужно ли резервное копирование перед созданием макета?
Да. Даже правка одного макета может повлиять на печать и обновление конфигурации. Резервная копия конфигурации и базы позволяет откатиться, если форма работает некорректно.