Как добавить команду Печать в документ 1С

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

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

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

Подготовка метаданных и создание команды

Первым шагом необходимо обратиться к дереву метаданных в конфигураторе. Вам нужно найти конкретный объект Документ, в форму которого планируется добавить новую функцию. Раскройте ветку этого документа и перейдите к разделу Формы. Если форма еще не создана, её потребуется создать заново, выбрав тип «Форма объекта».

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

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

Обратите внимание на свойство Видимость. Если команда должна быть доступна только определенным ролям, настройте права доступа через механизм РПП (Роли, Права, Полномочия). Неправильная настройка видимости — частая причина, по которой пользователи жалуются на «исчезновение» кнопок после обновления прав.

Настройка размещения кнопки на форме

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

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

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

Важно проверить свойство Порядок для кнопки. Логично разместить команду печати рядом с кнопками «Провести» и «Записать», так как эти действия часто выполняются в одной последовательности. Хаотичное расположение элементов управления снижает эргономику работы оператора.

Написание кода обработчика события

Самый ответственный этап — написание программного кода. Перейдите в модуль формы документа, нажав кнопку 1С в верхней панели конфигуратора. Найдите процедуру, соответствующую действию вашей команды. Если вы назвали действие Печать, система автоматически создаст заготовку &НаКлиенте процедуры Печать(Команда).

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

&НаКлиенте
Процедура Печать(Команда)
ПечатьДокумента(ЭтотОбъект);
КонецПроцедуры

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

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

Создание и настройка макетов печати

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

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

При создании макета важно правильно именовать его. Имя макета должно совпадать с тем, которое будет указано в коде обработчика печати. Часто используется схема именования: Макет.Накладная или Макет.СчетФактура. Если макетов несколько, реализуйте логику выбора в обработчике команды.

Тип макета	Назначение	Сложность верстки	Производительность
Табличный документ	Счета, Накладные, Акты	Высокая	Высокая
Текстовый документ	Письма, Простые справки	Низкая	Средняя
Внешний файл (MXL)	Сложные отчеты	Средняя	Зависит от размера
HTML шаблон	Печать в браузер/PDF	Высокая	Низкая

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

Интеграция с подсистемой печати БСП

В типовых конфигурациях, таких как Управление Торговлей или Бухгалтерия Предприятия, не рекомендуется писать код печати с нуля. Гораздо эффективнее использовать механизмы Библиотеки Стандартных Подсистем (БСП). Это обеспечивает единообразие интерфейса и возможность пользователю выбирать принтер и настройки вывода.

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

&НаКлиенте
Процедура Печать(Команда)
ПараметрыПечати = Новый Структура;
ПараметрыПечати.Вставить("ОбъектПечати", ЭтотОбъект);
ПараметрыПечати.Вставить("ИмяМакета", "Макет1");

Печать.Печать(ПараметрыПечати);
КонецПроцедуры

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

Использование стандартных механизмов также позволяет автоматически поддерживать функционал предварительного просмотра, экспорта в Excel и отправки по электронной почте, так как эти функции уже встроены в стандартные диалоги печати платформы 1С.

Что делать, если БСП не подключена?

Если вы работаете в самописной конфигурации без БСП, вам придется реализовать диалог выбора принтера и предпросмотра самостоятельно, используя объект ТабличныйДокумент.Методы.Просмотр() и ТабличныйДокумент.Методы.Печать().

Отладка и тестирование функционала

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

Проверьте видимость кнопки. Если её нет, проверьте права доступа и настройки компоновки формы. Попробуйте нажать кнопку. Если возникает ошибка скрипта, нажмите F12 (или используйте меню «О программе» -> «Журнал регистрации») для просмотра текста ошибки. Чаще всего проблемы связаны с типами передаваемых переменных.

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

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

Частые ошибки и способы их решения

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

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

• 🖨️ Ошибка «Макет не найден»: проверьте точное совпадение имени макета в коде и в метаданных, учитывая регистр символов.
• 🚫 Ошибка прав доступа: убедитесь, что у роли пользователя есть право на использование общих ресурсов или чтение документа.
• 📄 Пустая печать: проверьте заполненность реквизитов документа данными перед запуском команды печати.

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

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

В типовых конфигурациях это возможно через механизмы расширения (Extensions), если администратор базы разрешил их использование. В самописных базах без расширения — нет, требуется доступ в Конфигуратор.

Почему печать идет сразу на принтер без предпросмотра?

Это зависит от настроек, переданных в метод печати. По умолчанию 1С может открывать предпросмотр. Если настроено прямое подключение к принтеру по умолчанию в параметрах вызова, окно предпросмотра будет пропущено.

Как добавить печать нескольких документов списком?

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

Влияет ли версия платформы 1С на код печати?

Базовые принципы не меняются уже много лет. Однако новые версии платформы (8.3.20+) предлагают улучшенные методы работы с PDF и облачной печатью, которые могут требовать иного синтаксиса вызова.

Где хранятся настройки принтера для 1С?

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