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