Как вывести кнопку печати на форму в 1С 8.3

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

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

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

Как устроена печать в 1С 8.3 и откуда берётся кнопка

В управляемом приложении 1С кнопка на форме — это элемент формы, связанный с командой. Команда может быть стандартной (например, «Записать», «Провести»), командой объекта (описана в конфигураторе у документа или справочника) или командой конкретной формы. Пока команда не создана, вывести кнопку невозможно — элементу формы нужно указать свойство «ИмяКоманды».

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

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

Способ 1. Добавить кнопку печати на форму вручную через конфигуратор

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

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

Пример обработчика команды на форме:

&НаКлиенте
Процедура ПечатьНакладной(Команда)

ТабДок = СформироватьПечатнуюФормуНаСервере(Объект.Ссылка);
ТабДок.Показать("Накладная № " + Объект.Номер);

КонецПроцедуры

&НаСервереБезКонтекста
Функция СформироватьПечатнуюФормуНаСервере(Ссылка)

ТабДок = Новый ТабличныйДокумент;
Макет = Документы.РеализацияТоваров.ПолучитьМакет("Накладная");

ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьШапка.Параметры.НомерДокумента = Ссылка.Номер;
ОбластьШапка.Параметры.ДатаДокумента = Формат(Ссылка.Дата, "ДЛФ=D");
ТабДок.Вывести(ОбластьШапка);

Возврат ТабДок;

КонецФункции

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

1. 1
   Откройте форму объекта в конфигураторе
2. 2
   На закладке «Команды» создайте команду формы с заголовком «Печать»
3. 3
   Напишите клиентский обработчик и серверную функцию формирования табличного документа
4. 4
   Перетащите команду в командную панель дерева элементов формы
5. 5
   Обновите конфигурацию БД (F7) и проверьте кнопку в режиме предприятия

Куда лучше поместить кнопку на форме

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

Способ 2. Добавить печатную форму в типовую конфигурацию через механизм печати БСП

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

Откройте модуль менеджера нужного объекта и найдите (или добавьте) процедуру с такой структурой:

Процедура ДобавитьКомандуПечати(КомандыПечати) Экспорт

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

КонецПроцедуры

Процедура Печать(МассивОбъектов, ПараметрыПечати, КоллекцияПечатныхФорм,
ОбъектыПечати, ПараметрыВывода) Экспорт

Если УправлениеПечатью.НужноПечататьМакет(КоллекцияПечатныхФорм, "НакладнаяМоя") Тогда
УправлениеПечатью.ВывестиТабличныйДокументВКоллекцию(
КоллекцияПечатныхФорм,
"НакладнаяМоя",
НСтр("ru = 'Накладная (моя форма)'"),
СформироватьНакладную(МассивОбъектов, ОбъектыПечати));
КонецЕсли;

КонецПроцедуры

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

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

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

В модуле обработки описывается, к каким объектам она относится и какие команды печати добавляет:

Функция СведенияОВнешнейОбработке() Экспорт

ПараметрыРегистрации = ДополнительныеОтчетыИОбработки.СведенияОВнешнейОбработке();
ПараметрыРегистрации.Вид = ДополнительныеОтчетыИОбработкиКлиентСервер.ВидОбработкиПечатнаяФорма();
ПараметрыРегистрации.Назначение.Добавить("Документ.РеализацияТоваровУслуг");

Команда = ПараметрыРегистрации.Команды.Добавить();
Команда.Идентификатор = "МояПечатнаяФорма";
Команда.Представление = НСтр("ru = 'Накладная (внешняя)'");
Команда.Использование = ДополнительныеОтчетыИОбработкиКлиентСервер.ТипКомандыВызовСерверногоМетода();

Возврат ПараметрыРегистрации;

КонецФункции

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

Способ 4. Вывести кнопку через расширение конфигурации

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

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

&После("ДобавитьКомандуПечати")
Процедура Расш1_ДобавитьКомандуПечати(КомандыПечати)
    КомандаПечати = КомандыПечати.Добавить();
    КомандаПечати.Идентификатор = "НакладнаяРасш";
    КомандаПечати.Представление = НСтр("ru = 'Накладная (расширение)'");
КонецПроцедуры

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

Проверка результата и права доступа

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

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

Типичные ошибки при выводе кнопки печати

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

FAQ