Как добавить кнопку «Печать» в документ 1С 8.3 — пошаговая инструкция

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

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

Материал будет полезен как начинающим программистам 1С, так и опытным специалистам, которые хотят оптимизировать процесс печати документов. Все инструкции актуальны для платформы 8.3.20+ и проверены на типовых конфигурациях УТ 11, БП 3.0 и ЗУП 3.1.

1. Подготовка: что нужно знать перед добавлением кнопки

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

✅ Версию платформы — в старых релизах (ниже 8.3.10) могут отсутствовать некоторые функции работы с макетами.

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

✅ Наличие макета печати — без заранее подготовленного макета (.mxl или .ert) кнопка будет нерабочей.

Особое внимание уделите типу документа, для которого добавляете кнопку. Например, в Заказе покупателя и Счёте на оплату могут использоваться разные макеты, даже если визуально они похожи. Если вы работаете с табличным документом, потребуется дополнительная настройка вывода данных в ячейки.

💡

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

2. Способ 1: Добавление кнопки через конструктор форм

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

1. Откройте конфигуратор и найдите нужный документ в дереве объектов (например, Документ.РеализацияТоваровУслуг).

2. Перейдите на вкладку Формы и откройте форму документа (обычно это ФормаДокумента или ФормаОбъекта).

3. В верхней панели инструментов нажмите Действия → Добавить команду.

4. В открывшемся окне выберите тип команды — Печать, укажите имя (например, ПечатьСчета) и нажмите ОК.

После этого кнопка появится в панели действий формы. Однако она ещё не привязана к макету. Чтобы настроить печать:

1. Вернитесь в форму и выделите добавленную команду.

2. В свойствах команды (F4) найдите событие ОбработкаПечати и нажмите на кнопку с лупой рядом с полем.

3. В открывшемся модуле введите код для печати (пример ниже).

Пример кода для печати стандартного макета:

Процедура ПечатьСчета(Команда)
Печать.ПечатьДокумента(Объект, "ПечатнаяФормаСчета");
КонецПроцедуры

Выбрать документ в дереве конфигурации|

Открыть форму документа (ФормаОбъекта)|

Добавить команду типа "Печать"|

Привязать обработчик события ОбработкаПечати|

Проверить наличие макета печати-->

3. Способ 2: Ручное программирование кнопки

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

Алгоритм действий:

1. Откройте форму документа в конфигураторе и перейдите на вкладку Элементы.

2. Добавьте новую кнопку через контекстное меню (Добавить → Кнопка).

3. Настройте свойства кнопки:

- Имя: КнопкаПечать

- Заголовок: Печать

- Действие: ПечатьДокумента (создайте обработчик с таким именем в модуле формы).

Пример кода для обработчика с проверкой условий:

Процедура ПечатьДокумента(Команда)
Если НЕ Объект.Проведен Тогда
Предупреждение("Документ не проведён! Печать невозможна.", 60);
Возврат;
КонецЕсли;

Макет = Документы.РеализацияТоваровУслуг.ПечатнаяФормаСчета();
ТабДок = Новый ТабличныйДокумент;
ТабДок.ОриентацияСтраницы = ОриентацияСтраницы.Портрет;
Макет.Вывести(ТабДок, Объект);

ТабДок.Показать("Печать счёта №" + Объект.Номер);
КонецПроцедуры

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

Что делать, если макет не найден?

Если при выполнении кода выводится ошибка "Макет не найден", проверьте:

1. Правильность имени макета (регистр имеет значение!).

2. Наличие макета в свойствах документа (вкладка "Макеты").

3. Права на доступ к макету (в некоторых конфигурациях макеты защищены ролями).

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

4. Способ 3: Использование внешних обработок

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

Инструкция по настройке:

1. Создайте внешнюю обработку с процедурой печати (пример кода ниже).

2. Подключите обработку к форме документа через свойство ВнешниеОбработки.

3. Добавьте кнопку на форму и в обработчике вызовите метод внешней обработки.

Пример кода внешней обработки:

Процедура ПечатьДокументаНаКлиенте(Документ, ИмяМакета)
Макет = Документ.Метод("ПечатнаяФорма" + ИмяМакета)();
ТабДок = Новый ТабличныйДокумент;
Макет.Вывести(ТабДок, Документ);
ТабДок.Показать("Печать: " + Документ.ВидыДокументов.Представление);
КонецПроцедуры

Преимущества этого метода:

🔄 Гибкость: одна обработка может использоваться для разных документов.
🔒 Безопасность: не требуется изменять типовую конфигурацию.
📦 Лёгкое обновление: при изменении логики печати достаточно обновить обработку.

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

5. Типичные ошибки и их решения

Даже опытные разработчики сталкиваются с проблемами при настройке печати. Рассмотрим самые распространённые ошибки и способы их устранения:

Ошибка	Причина	Решение
Кнопка не отображается	Отсутствует право на команду или ошибка в имени	Проверьте роли пользователя и корректность имени команды в свойствах формы
Печать пустого документа	Не переданы данные в макет или ошибка в запросе	Отладьте процедуру `Макет.Вывести()`, проверьте параметры
Ошибка "Макет не найден"	Неверное имя макета или он не добавлен в документ	Убедитесь, что макет существует и имя указано без опечаток
Некорректное форматирование	Проблемы с настройками табличного документа	Настройте свойства `ТабДок.ОриентацияСтраницы` и `ТабДок.Масштаб`

Особое внимание уделите правам доступа. Если кнопка не появляется у пользователей, проверьте:

🔐 Наличие роли с правом на выполнение команды печати.
📄 Права на чтение макета (в некоторых конфигурациях макеты защищены отдельно).
🖨️ Права на печать документов данного типа (настраивается в ролях на уровне документа).

💡

Самая частая ошибка — несовпадение имён макета в коде и в свойствах документа. Всегда проверяйте регистр и наличие макета через Документ.Макеты.Найти().

6. Дополнительные возможности: печать в PDF и настройка параметров

Стандартная печать в 1С 8.3 выводит документ в табличный документ, но часто требуется сохранение в PDF или настройка дополнительных параметров (например, количество копий). Для этого используйте следующие методы:

Сохранение в PDF:

ТабДок.Записать("C:\Temp\Счет_" + Объект.Номер + ".pdf", ТипФайлаPDF.Стандартный);

Настройка принтера:

ПараметрыПечати = Новый Структура();
ПараметрыПечати.Вставить("ИмяПритера", "HP LaserJet");
ПараметрыПечати.Вставить("Копий", 2);
ТабДок.Напечатать(,, ПараметрыПечати);

Для работы с PDF потребуется установленный компонент 1C:Предприятие PDF (входит в дистрибутив платформы). Если компонент отсутствует, пользователь увидит ошибку при попытке сохранения.

Также можно настроить предварительный просмотр перед печатью:

ТабДок.Показать();
Если Вопрос("Напечатать документ?", КодВопроса.ДаНет) = КодВозвратаДиалога.Да Тогда
ТабДок.Напечатать();
КонецЕсли;

Выборка = Документы.РеализацияТоваровУслуг.Выбрать();
Пока Выборка.Следующий() Цикл
ПечатьДокумента(Выборка.Ссылка);

КонецЦикла;-->

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

Если документ содержит сотни строк (например, Акт выполненных работ с детализацией), печать может занимать несколько минут. Чтобы ускорить процесс:

✅ Используйте серверный вызов для формирования макета:

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

✅ Отключите ненужные данные в макете:

📊 Уберите из макета колонки, которые не нужны для печати (например, служебные реквизиты).
🔍 Используйте отбор в запросе, который формирует данные для макета.

✅ Настройте кэширование макетов:

Макет = Документы.РеализацияТоваровУслуг.ПечатнаяФормаСчета.ПолучитьМакет();
Если НЕ ЗначениеЗаполнено(КэшМакетов[ИмяМакета]) Тогда
КэшМакетов[ИмяМакета] = Макет;
КонецЕсли;

Для документов с табличными частями более 1000 строк рекомендуется использовать постраничную печать:

ТабДок.АвтоМасштаб = Ложь;
ТабДок.ВысотаСтраницы = 2970; // Формат A4 в десятых долях мм
ТабДок.ПоказатьПостранично();

Как проверить скорость печати?

Включите отладку производительности через Сервис → Параметры → Отладка → Профилировка.

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

FAQ: Ответы на частые вопросы

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

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

Процедура ПечатьСчета(Команда)
Печать.ПечатьДокумента(Объект, "ПечатнаяФормаСчета");
КонецПроцедуры

Убедитесь, что в свойствах команды указано Видимость = Истина и Использование = Допустимое.

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

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

Почему при печати выводится пустой документ?

Причины могут быть следующими:

📝 В макете не указаны источники данных (проверьте параметры в Макет.Вывести()).
🔍 Документ не проведён или не заполнены обязательные реквизиты.
🖼️ Ошибка в запросе, который формирует данные для макета (используйте отладчик для проверки).

Для диагностики добавьте перед выводом макета строку:

Сообщить("Данные для печати: " + Объект.СуммаДокумента);

Если сообщение не выводится, проблема в передаче объекта.

Как сделать кнопку печати доступной только для определённых ролей?

Настройте видимость кнопки в зависимости от прав:

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
КнопкаПечать.Видимость = Роли.Найти("Администратор") <> Неопределено;
КонецПроцедуры

Или используйте функцию ГлобальныйКонтекст.ПраваПользователя() для проверки конкретных прав.

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

Да, для этого используйте ФоновоеЗадание:

ФоновоеЗадание = ФоновыеЗадания.Создать("ПечатьДокументаФоновая");
ФоновоеЗадание.Параметры.Документ = Объект;
ФоновоеЗадание.ВыполнитьАсинхронно();

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

Добавление кнопки «Печать» в документ 1С 8.3: полное руководство для разработчиков