К статье
Практический материал

Другое · 6 мин

Печатная форма документа в 1С: создание и настройка

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

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

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

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

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

Где в конфигураторе находится печатная форма

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

Если документ уже имеет стандартную форму, новая печатная форма не заменяет её автоматически. Нужно явно добавить команду «Печать» или расширить существующую, иначе пользователь не увидит новый вариант в интерфейсе.

Создание макета печатной формы

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

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

Порядок создания макета
  1. 1
    Откройте раздел «Макеты» конфигурации
  2. 2
    Создайте макет типа табличный документ или внешняя обработка
  3. 3
    Оформите заголовок, поля реквизитов и области табличной части
  4. 4
    Сохраните макет и обновите конфигурацию

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

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

Программная процедура печати документа

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

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

1c
Процедура Печать(МассивОбъектов, ОбъектПечати, ПараметрыВывода) Экспорт
    Макет = ПолучитьМакет("МакетПечатиДокумента");
    ТабДок = Макет.ПолучитьОбъект();
    // заполнение реквизитов и табличной части
    ТабДок.Вывести();
КонецПроцедуры

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

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

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

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

Способы вызова печати

Стандартная команда конфигурации

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

Собственная команда и макет

Подходит для уникальных бланков и отчетов; ограничение — требует поддержки при обновлениях конфигурации.

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

Проверка результата и типичные ошибки

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

Контрольные точки

Как проверить печатную форму

Открытие команды «Печать» в карточке документа
Норма

Команда активна и открывает форму

Тревожный признак

Команда отсутствует или неактивна

Вывод заполненного документа
Норма

Реквизиты и строки соответствуют документу

Тревожный признак

Поля пустые, смещены или отсутствуют

Печать из списка документов
Норма

Печатаются выбранные документы

Тревожный признак

Печатается только текущий или ни один

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

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

Итог

Что важно запомнить

Печатная форма состоит из макета и процедуры печати; изменения тестируйте на копии, а типовые объекты не правите напрямую.

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

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

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

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

Что делать, если кнопка «Печать» не появляется?

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

Отличается ли печать из списка и из карточки документа?

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

Нужно ли резервное копирование перед созданием макета?

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