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

Разработка печатных форм в платформе 1С:Предприятие 8 является одной из ключевых задач при внедрении и доработке конфигураций. Грамотно оформленный документ, который пользователь может отправить на принтер, экспортировать в PDF или Excel, значительно повышает удобство работы и соответствие требованиям делового оборота. Процесс создания таких форм эволюционировал от простых табличных документов к мощным инструментам Схемы компоновки данных (СКД).

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

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

Выбор подхода к реализации печати

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

Наиболее распространенным и гибким методом является использование Схемы компоновки данных (СКД). Этот подход позволяет описывать структуру отчета декларативно, отделяя логику получения данных от логики их отображения. СКД поддерживает различные варианты оформления, условное форматирование и группировки, что делает его идеальным для сложных печатных форм.

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

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

Подготовка макета в конфигураторе

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

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

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

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

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

Настройка схемы компоновки данных

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

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

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

Элемент настройки	Описание функции	Где применяется
Группировка	Объединение строк по общему признаку	Отчеты, ведомости
Поле	Вывод конкретного значения из набора данных	Любые печатные формы
Параметр	Переменная для фильтрации данных (дата, контрагент)	Формы отбора
Ресурс	Вычисляемое поле (сумма, выражение)	Расчетные документы

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

Как использовать выражения в СКД?

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

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

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

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

Процедура Печать(ОбъектыПечати, ПараметрыПечати) Экспорт

Для каждого ОбъектПечати Из ОбъектыПечати Цикл
Макет = ПолучитьМакет("ОсновнойМакет");
Компоновщик = Новый КомпоновщикНастроекКомпоновкиДанных;
Компоновщик.УстановитьМакет(Макет);

Настройки = Компоновщик.Настройки;
Настройки.ПараметрыДанных.УстановитьЗначениеПараметра("ДокументСсылка", ОбъектПечати.Объект);

ПроцессКомпоновки = Компоновщик.ПолучитьПроцессКомпоновки();
Результат = ПроцессКомпоновки.Выполнить();

ПараметрыПечати.Добавить(Результат);
КонецЦикла;

КонецПроцедуры

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

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

Работа с внешними печатными формами

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

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

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

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

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

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

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

• 📄 Ошибка "Не найдено поле": Возникает, если в макете используется поле, которое отсутствует в наборе данных. Проверьте имена полей в запросе и настройках СКД на предмет опечаток.
• 📄 Пустой документ при печати: Чаще всего причина в параметрах отбора. Убедитесь, что параметры, передаваемые в схему компоновки, имеют корректные значения и тип данных соответствует ожидаемому.
• 📄 Неверное форматирование чисел и дат: Проверьте настройки формата в свойствах поля макета. Локаль системы и настройки пользователя могут влиять на отображение разделителей разрядов и формата даты.

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

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

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

Для добавления логотипа в макет СКД используйте поле типа "Хранилище значения" или "Бинарные данные". В настройках отчета укажите это поле в заголовке. Значение можно передавать параметром из реквизита организации или хранить непосредственно в макете как ресурс.

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

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

Почему не работает условное оформление в веб-клиенте?

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

Как скрыть колонку в печатной форме программно?

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