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

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

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

В этой статье мы разберем несколько способов реализации: от использования стандартных механизмов платформы до написания собственного программного кода. Мы рассмотрим нюансы обработки событий и привязки логики к элементам интерфейса.

Подготовка к настройке печатной формы

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

Проверьте наличие печатных форм в дереве метаданных. Обычно они располагаются в разделе Общие макеты или внутри конкретных объектов документации как подчиненные элементы. Для сложных отчетов может потребоваться использование механизма СКД (Система Компоновки Данных).

Если вы планируете использовать внешний отчет, убедитесь, что файл отчета (.mxl или .cf) доступен в информационной базе или на файловом ресурсе, к которому у пользователя есть доступ. Отсутствие файла является частой причиной ошибок при попытке печати.

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

Определите, для какого именно объекта метаданных будет добавлена кнопка. Это может быть документ "Реализация товаров и услуг", справочник "Номенклатура" или регистр сведений. От типа объекта зависит контекст, в котором будет выполняться код обработки нажатия.

Добавление кнопки через Конфигуратор

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

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

• 🖱️ Выберите форму объекта в дереве метаданных.
• 🛠️ Перейдите на вкладку "Команды" и создайте новую команду.
• 🔗 Привяжите команду к элементу "Кнопка" на панели формы.
• 💾 Сохраните конфигурацию и обновите базу данных.

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

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

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

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

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

Процедура КомандаПечатьСчета(Команда)
Объект.Печать(ЭтотОбъект, "СчетНаОплату");
КонецПроцедуры

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

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

Здесь используется цикл по табличной части документа для переноса строк товаров в область макета. Требуется careful обработка типов данных и форматирование чисел.

Не забудьте обработать возможные исключения. Если макет не найден или данные повреждены, пользователь должен получить понятное сообщение об ошибке, а не технический стек вызовов. Для этого используйте конструкцию Попытка...Исключение.

Использование стандартных механизмов печати

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

В свойствах объекта метаданных (документа или справочника) существует раздел "Печатные формы". Добавив туда новую запись, вы автоматически получаете возможность выбора этого варианта в стандартном диалоге печати. Кнопка в этом случае может просто открывать этот стандартный диалог.

Тип объекта	Место настройки	Сложность	Гибкость
Документ	Метаданные объекта	Низкая	Средняя
Отчет (СКД)	Отдельный объект	Средняя	Высокая
Внешний отчет	Файловая система	Высокая	Максимальная
Макет (Табличный)	Общие макеты	Средняя	Высокая

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

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

Настройка прав доступа и видимости

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

В конфигураторе перейдите в конфигуратор прав доступа. Найдите роль, которой вы хотите разрешить печать, и добавьте право на использование новой команды. Если право не выдано, кнопка либо исчезнет с формы, либо станет неактивной (в зависимости от настроек видимости).

Также можно управлять видимостью кнопки программно в событии ПриСозданииНаСервере. Это позволяет скрывать элемент управления в зависимости от статуса документа. Например, кнопку "Печать акта" не имеет смысла показывать, если документ еще не проведен.

⚠️ Внимание: Интерфейс настроек прав доступа и структура ролей могут отличаться в зависимости от версии конфигурации (Бухгалтерия, Управление Торговлей, ЗУП). Всегда проверяйте актуальные настройки в вашей конкретной базе.

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

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

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

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

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

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

Часто задаваемые вопросы (FAQ)

Почему кнопка печати не видна на форме?

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

Как сделать, чтобы документ сразу отправлялся на принтер без предпросмотра?

Для этого в коде обработчика нужно использовать метод Печать() с соответствующими параметрами или работать с объектом ТабличныйДокумент, вызывая метод Печать() напрямую, минуя диалог выбора принтера.

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

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

Где хранить макеты печатных форм: в базе или во внешних файлах?

Хранение в базе данных (в объекте "Общий макет") предпочтительнее для централизованного управления и обновления конфигурации. Внешние файлы удобны только если макеты часто меняются пользователями без участия программиста.