Как создать кнопку печати в 1С: полное руководство

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

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

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

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

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

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

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

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

Как использовать область в макете?

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

Размещение кнопки на форме документа

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

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

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

• 🖨️ Выберите иконку принтера из стандартной библиотеки изображений для лучшей узнаваемости.
• ⌨️ Установите сочетание клавиш (например, Ctrl+P) для ускорения работы опытных пользователей.
• 👁️ Разместите кнопку в видимой части формы, чтобы не загромождать интерфейс второстепенными элементами.

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

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

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

Сначала необходимо получить макет из ресурсов формы или конфигурации. Если макет хранится в форме, используется метод ПолучитьМакет. Затем создается объект табличного документа, в который помещается макет. После этого начинается процесс заполнения полей. Для этого используются методы Область и Параметры.

&НаКлиенте
Процедура ПечатьНажатие(Команда)
ПечатьНаСервере();
КонецПроцедуры

&НаСервере
Процедура ПечатьНаСервере()
Макет = ПолучитьМакет("МакетПечати");
ТабДок = Новый ТабличныйДокумент;
ТабДок.АвтоМасштаб = Истина;

ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьШапка.Параметры.Номер = Объект.Номер;
ОбластьШапка.Параметры.Дата = Объект.Дата;

ТабДок.Вывести(ОбластьШапка);
ТабДок.Показать(, "Печать документа");
КонецПроцедуры

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

Заполнение табличной части документа

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

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

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

Элемент макета	Тип данных	Источник данных	Формат вывода
НомерДокумента	Число	Объект.Номер	ЧЦ (0)
ДатаДокумента	Дата	Объект.Дата	ДФ "dd.MM.yyyy"
НаименованиеТовара	Строка	СтрокаТЧ.Номенклатура	Без форматирования
Количество	Число	СтрокаТЧ.Количество	ЧЦ (2)
Сумма	Число	СтрокаТЧ.Сумма	ЧЦ (2)

Использование форматов строк позволяет привести числа и даты к единому стандарту. Например, количество товара часто требуют выводить с двумя знаками после запятой, а дату — в формате День.Месяц.Год. Это делается либо в свойствах поля макета, либо программно при присваивании параметров.

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

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

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

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

Также стоит обратить внимание на настройки страницы. В свойствах макета или программно можно задать ориентацию листа (книжная или альбомная) и размеры полей. Это особенно актуально для документов с широкими таблицами, которые не помещаются на стандартный лист А4 в вертикальной ориентации.

Типовые ошибки и способы их решения

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

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

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

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

Оптимизация и расширение функционала

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

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

Не забывайте про возможность сохранения отчета в файлы популярных форматов. Табличный документ 1С поддерживает экспорт в PDF, XLSX, TXT и другие форматы. Добавление кнопок "Сохранить как PDF" рядом с кнопкой печати является хорошим тоном в разработке интерфейсов, так как электронные документы сейчас востребованы не менее бумажных.

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

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

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

Можно ли использовать одну кнопку для печати разных документов?

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

Почему не заполняются поля в макете?

Чаще всего причина в несоответствии имен параметров в коде и имен полей в макете. Имена чувствительны к регистру. Также проверьте, что тип данных переменной соответствует ожидаемому типу поля макета.

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

Логотип можно вставить прямо в макет как картинку в ячейку таблицы. Если логотип хранится в базе данных (в регистре сведений или справочнике организаций), его нужно программно считать и поместить в поле макета типа "Картинка" перед выводом.

Работает ли печать на тонком клиенте?

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