Другое · 7 мин
Добавление печатной формы на кнопку Печать в 1С
Пошаговая инструкция по добавлению печатной формы на кнопку Печать в 1С: настройка команды, обработки и проверка результата без риска для базы.
Добавление печатной формы на кнопку «Печать» в 1С требует согласования трёх элементов: команды интерфейса, обработчика печати и самой печатной формы в конфигурации. Если хотя бы один из этих звеньев отсутствует или не связан с другими, нажатие кнопки не приведёт к выводу документа. Работа ведётся в конфигураторе, поэтому перед изменениями рекомендуется создать резервную копию информационной базы.
Задача решается по-разному в зависимости от типа приложения: управляемое приложение, обычное приложение или веб-клиент. Общий алгоритм сохраняется, но способы вызова команды и отображения результата могут отличаться. Ниже описан порядок действий, применимый к типовым конфигурациям на платформе 1С:Предприятие.
Определите, где должна появиться кнопка
Первым шагом уточните объект, на котором размещается печать: это может быть список документов, форма документа, журнал или отчёт. Кнопка «Печать» обычно добавляется в командную панель формы или в панель действий списка. В управляемом приложении команда настраивается в редакторе команд формы, а в обычном — через свойства кнопки на командной панели.
Проверьте, не существует ли уже команды с именем «Печать» или «ПечатьДокумента». Дублирование имён может привести к вызову не той обработки или к отсутствию реакции на нажатие. Если команда есть, достаточно проверить, какая процедура ей соответствует.
Создайте или подключите печатную форму
Печатная форма в 1С оформляется как отдельный объект конфигурации: макет табличного документа, внешняя обработка или отчёт, в зависимости от архитектуры конфигурации. Форма должна быть доступна из кода и иметь процедуру вывода, которая принимает ссылку на объект и заполняет табличный документ.
Если печатная форма уже есть в конфигурации, убедитесь, что она публично доступна для вызова из формы документа. В закрытых или типовых конфигурациях прямой доступ может быть ограничен, тогда используется стандартный механизм вывода через общие модули или регистрацию формы в подсистеме печати.
- 1Откройте форму объекта в конфигураторе и найдите команду «Печать»
- 2Назначьте обработчик команды, который вызывает процедуру печати
- 3Укажите макет или обработку печатной формы в параметрах вызова
- 4Сохраните конфигурацию и обновите информационную базу
Напишите обработчик нажатия кнопки
Обработчик кнопки «Печать» обычно находится в модуле формы объекта и может называться «Печать», «ПечатьДокумента» или аналогично. В коде создаётся табличный документ, вызывается процедура вывода печатной формы, после чего результат выводится на экран или отправляется на печать. Важно передать в процедуру правильную ссылку на документ или набор записей.
В управляемых формах команда может быть описана в командной панели с свойством «Обработчик», указывающим на процедуру модуля формы. Если команда общая для нескольких форм, целесообразно вынести логику печати в общий модуль и вызывать его из обработчиков разных форм.
Примерная структура обработчика включает проверку наличия выбранного объекта, создание экземпляра табличного документа, заполнение формы и вывод. Если объект не выбран, обработчик должен сообщать об этом пользователю вместо выполнения печати.
Проверьте результат в режиме предприятия
После сохранения конфигурации обновите информационную базу и откройте соответствующий документ или список. Нажмите кнопку «Печать» и убедитесь, что открывается нужная форма, заполнены правильные данные и появляется диалог вывода. Если окно печати не открывается или выводится пустой лист, причина чаще всего в разрыве связи между кнопкой и обработчиком.
Проверяйте печать на копии базы, а не в рабочей среде, особенно если конфигурация находится под поддержкой или используется в торговле. Ошибка в коде печати не должна повредить данные, но некорректный макет может привести к неверному документу.
Ограничения и риски
Не все конфигурации позволяют свободно добавлять команды на форму без доступа к настройке прав. Пользователю могут быть недоступны кнопки печати из-за ролей и прав доступа, даже если код обработчика написан верно. Проверьте права доступа к объекту и к команде, если печать работает у одних пользователей и не работает у других.
В веб-клиенте и тонком клиенте поведение диалога печати может отличаться от толстого клиента: иногда вывод открывается в новой вкладке браузера или отправляется на сервер печати. Не делайте вывод о неисправности формы, проверив её только в одном варианте клиента.
Риск повреждения данных при добавлении кнопки печати минимален, если изменения ограничены модулем формы и макетом. Опасность возникает при прямом редактировании таблиц базы, изменении регистров или отключении проверки целостности. Такие действия выходят за рамки обычной настройки печати.
Как проверить результат
Появляется диалог с макетом и данными документа
Окно не открывается или выводится пустой лист
Кнопка доступна и работает для нужной роли
Кнопка скрыта или выдаёт ошибку доступа
Печать выполняется в тонком, толстом или веб-клиенте согласно задаче
Разница в поведении не объясняется особенностями клиента
Как выбрать способ реализации
Если печать нужна только для одного документа, проще добавить кнопку на форму этого документа и написать локальный обработчик. Когда печать одинакова для нескольких объектов, лучше создать общую обработку или общий модуль и подключить его к командам разных форм. Это снижает дублирование кода и упрощает поддержку.
Для типовых конфигураций предпочтительно использовать встроенные механизмы вывода и расширения конфигурации, а не правилять поставляемые объекты напрямую. Если типовая конфигурация уже предоставляет кнопку «Печать», проверьте настройки подсистемы печати перед созданием собственной.
Часто задаваемые вопросы
Что важно запомнить
Кнопка «Печать» работает только при совпадении команды, обработчика и зарегистрированной печатной формы. Проверяйте результат на копии базы и учитывайте права доступа.
Нужно ли программировать добавление кнопки «Печать»?
В большинстве случаев да: требуется создать команду и обработчик на языке встроенного языка 1С. В некоторых типовых конфигурациях кнопку можно добавить через настройку интерфейса без программирования, но привязку к конкретной печатной форме всё равно приходится прописывать в коде.
Можно ли добавить печать на уже существующую тип кнопки?
Да, если у кнопки есть свойство обработчика команды. Но если кнопка принадлежит стандартной панели типа конфигурации, прямое изменение может быть ограничено. Безопаснее добавить свою команду или использовать расширение конфигурации.
Почему кнопка «Печать» есть, но при нажатии ничего не происходит?
Скорее всего, команда не связана с процедурой печати, либо обработчик не найден из-за опечатки в имени. Также возможна отсутствие прав доступа или ошибка в коде вывода, которая прерывает выполнение без сообщения.
Нужно ли обновлять информационную базу после изменений?
Да, после сохранения конфигурации в конфигураторе требуется обновление базы конфигурации, чтобы изменения вступили в силу в режиме предприятия. Без обновления новая кнопка или обработчик могут не появиться.