Как добавить кнопку «Печать» в документ 1С 8.3 через конфигуратор

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

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

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

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

Прежде чем что-то менять, откройте конфигуратор и проверьте, есть ли в конфигурации подсистема печати. Откройте ветку «Общие» → «Подсистемы» и поищите подсистему «Печать», а в общих модулях — модуль «УправлениеПечатью». Если они есть, конфигурация построена на библиотеке стандартных подсистем (БСП), и печатные формы подключаются централизованно. Это все типовые решения фирмы «1С» на управляемых формах.

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

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

Любая печатная форма строится на макете. В конфигураторе найдите нужный документ в дереве объектов, раскройте его, нажмите правой кнопкой на ветку «Макеты» и выберите «Добавить». Задайте имя макета, например «ПечатьАкта», и тип макета — «Табличный документ».

В редакторе макета создайте именованные области: «Шапка», «СтрокаТаблицы», «Подвал». Выделите нужные строки, затем через меню «Таблица» → «Имена» → «Назначить имя» задайте имя области. В ячейках, куда должны подставляться данные, укажите параметры в фигурных скобках, например [НомерДокумента] или [Контрагент], а в свойствах ячейки установите «Заполнение» — «Параметр».

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

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

В конфигурациях на БСП кнопка в форму документа добавляется автоматически, как только печатная форма зарегистрирована в модуле менеджера. Откройте документ в дереве конфигурации, нажмите правой кнопкой и выберите «Открыть модуль менеджера». Если конфигурация на поддержке с запретом изменений, сначала включите возможность изменения: «Конфигурация» → «Поддержка» → «Настройка поддержки» → «Включить возможность изменения».

В модуле менеджера найдите (или создайте, если конфигурация позволяет) процедуру «ДобавитьКомандыПечати». В ней добавьте описание команды печати: идентификатор макета, представление кнопки, порядок, имя менеджера печати. Затем в процедуре «Печать» того же модуля добавьте ветку, которая по идентификатору формирует табличный документ из вашего макета и заполняет его параметры данными документа.

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

Процедура ДобавитьКомандыПечати(КомандыПечати) Экспорт
    КомандаПечати = КомандыПечати.Добавить();
    КомандаПечати.Идентификатор = "ПечатьАкта";
    КомандаПечати.Представление = НСтр("ru = 'Акт (новая форма)'");
    КомандаПечати.Порядок = 10;
КонецПроцедуры

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

Если подсистемы печати нет, добавьте команду формы. Откройте форму документа в конфигураторе, перейдите на вкладку «Команды» → «Команды формы» и добавьте новую команду, например «ПечатьАкта». В свойствах команды задайте заголовок «Печать» и картинку при необходимости, а в обработчике укажите действие — клиентскую процедуру.

Затем перетащите команду из панели свойств в дерево элементов формы — в командную панель или рядом с ней. Платформа создаст кнопку автоматически. В модуле формы напишите обработчик: клиентская процедура вызывает серверную, которая получает макет, заполняет параметры данными документа и возвращает табличный документ, после чего клиент показывает его через «Показать()» или коллекцию печатных форм.

1. 1
   Создайте макет табличного документа с именованными областями и параметрами
2. 2
   Добавьте команду формы документа и её обработчик
3. 3
   Перетащите команду в командную панель формы — появится кнопка
4. 4
   В серверной процедуре сформируйте табличный документ из макета и заполните параметры
5. 5
   На клиенте выведите табличный документ в предпросмотр
6. 6
   Обновите конфигурацию базы данных и проверьте печать на тестовом документе

Альтернатива: внешняя печатная форма без изменения конфигурации

Если типовая конфигурация находится на полной поддержке и снимать объекты с поддержки недопустимо (это усложнит обновления), используйте внешнюю печатную форму. Это файл обработки .epf, который подключается в режиме предприятия через «Администрирование» → «Печатные формы, отчёты и обработки» → «Дополнительные отчёты и обработки».

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

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

После обновления конфигурации базы данных (F7 в конфигураторе) откройте проведённый документ в режиме предприятия. Признак успеха: в командной панели есть кнопка «Печать», при нажатии открывается предпросмотр с заполненными данными документа. Проверьте печать на документе с пустыми необязательными реквизитами — часто именно там всплывают ошибки обращения к данным.

Если кнопка не появилась, проверьте: добавлен ли идентификатор в процедуру «ДобавитьКомандыПечати» именно того документа, обновлена ли конфигурация базы данных, не открыт ли сеанс со старой версией (перезапустите клиент). Если кнопка есть, но форма пустая — сверяйте имена параметров макета с кодом заполнения и убедитесь, что область выводится в табличный документ методом «Вывести» или «Присоединить».

Частые вопросы