Как создать печатный документ в 1С

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

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

Ниже разобраны все три способа с конкретными действиями, проверками результата и типичными ошибками. Материал ориентирован на конфигурации на управляемых формах (Бухгалтерия 3.0, Управление торговлей 11, УНФ и аналогичные), но принципы применимы и к обычным формам.

Как устроен механизм печати в 1С

Любая печатная форма в 1С строится из трёх компонентов: макет, программный код формирования и команда печати. Макет — это шаблон табличного документа, где заданы ячейки, шрифты, рамки и именованные области. Области бывают статическими (текст выводится как есть) и параметризованными (в ячейках указаны имена параметров, например НомерДокумента или Контрагент).

При нажатии кнопки «Печать» программный модуль получает макет, в цикле или один раз выводит области в итоговый табличный документ и подставляет в параметры значения из реквизитов объекта. Результат пользователь видит в окне предварительного просмотра, откуда документ можно отправить на принтер или сохранить в PDF, Excel, ODS.

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

Способ 1: изменить типовой макет без программирования

Самый быстрый вариант, когда нужно поправить существующую форму: добавить реквизиты организации, изменить текст подвала или вставить логотип. Во многих конфигурациях макеты доступны прямо из режима предприятия: откройте форму печати документа, нажмите «Ещё» или кнопку настройки и найдите пункт редактирования макета (в некоторых конфигурациях он называется «Изменить макет» или доступен через администрирование печатных форм).

Если макет недоступен из режима предприятия, его редактируют в конфигураторе: Конфигурация → открыть объект (например, документ «РеализацияТоваровУслуг») → Макеты → нужный макет. Правится он как обычная таблица: текст, шрифты, границы, объединение ячеек. После сохранения конфигурации форма изменится для всех пользователей.

Ограничение способа: изменение конфигурации снимает объект с полной поддержки, что усложняет автоматические обновления. Если база обновляется регулярно, безопаснее использовать внешнюю печатную форму — она переживает обновления без потерь.

Способ 2: создать внешнюю печатную форму

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

Общий порядок создания в конфигураторе: Файл → Новый → Внешняя обработка. В модуле объекта обработки обязательно должна быть экспортная функция СведенияОВнешнейОбработке(), которая возвращает структуру с видом «ПечатнаяФорма», перечнем объектов назначения (например, «Документ.СчетНаОплатуПокупателю») и списком команд печати. Точный состав структуры зависит от версии БСП (библиотеки стандартных подсистем) в вашей конфигурации.

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

1. 1
   Откройте раздел «Администрирование» → «Печатные формы, отчеты и обработки» и включите механизм дополнительных отчетов и обработок.
2. 2
   Перейдите в «Дополнительные отчеты и обработки» и нажмите «Добавить из файла».
3. 3
   Выберите файл .epf и подтвердите предупреждение безопасности.
4. 4
   Проверьте назначение: в карточке обработки должны быть указаны нужные виды документов.
5. 5
   Откройте документ, нажмите «Печать» и убедитесь, что новая команда появилась в списке.

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

Способ 3: печатная форма внутри конфигурации

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

Конструктор создаёт работающий каркас, но реальную форму почти всегда приходится дорабатывать вручную: настраивать ширину колонок, добавлять итоги, условное оформление, вывод картинок (логотип, печать, подпись). Картинки вставляются в макет через свойство ячейки «Картинка» либо выводятся программно с помощью области рисунков табличного документа.

После доработки команду печати регистрируют в модуле менеджера объекта — в процедуре ДобавитьКомандыПечати() (для конфигураций на БСП). Без регистрации команда не появится в меню «Печать» документа, даже если макет и код готовы.

Процедура ДобавитьКомандыПечати(КомандыПечати) Экспорт
	КомандаПечати = КомандыПечати.Добавить();
	КомандаПечати.Идентификатор = "МойМакет";
	КомандаПечати.Представление = НСтр("ru = 'Моя печатная форма'");
КонецПроцедуры

Как заполнить макет данными: параметры, области, циклы

Типовая логика формирования выглядит так: получить макет методом ПолучитьМакет("ИмяМакета"), получить из него область через Макет.ПолучитьОбласть("Шапка"), заполнить параметры через Область.Параметры.НомерДокумента = ... и вывести область в результирующий документ методом ТабДок.Вывести(Область). Табличные части выводятся в цикле: для каждой строки товара получается область «Строка», заполняется и добавляется.

Для номеров документов используйте функцию удаления префиксов (в БСП это ПрефиксацияОбъектовКлиентСервер.НомерНаПечать()), иначе на печать выйдет номер с префиксом базы вида «00БП-000123». Даты форматируйте функцией Формат() с нужной строкой формата, суммы прописью — типовой функцией РаботаСКурсамиВалют.СформироватьСуммуПрописью() или аналогом из вашей конфигурации.

Проверяйте вывод на документах с разным объёмом данных: одна строка товаров, много строк (перенос на вторую страницу), длинные наименования. Для корректного разрыва страниц используйте метод ПроверитьВывод() перед выводом очередной строки — он определяет, поместится ли область на текущей странице.

Проверка результата и выгрузка в файл

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

Готовый документ сохраняется без печати на принтер: Файл → Сохранить в формате PDF — стандартный способ передать документ контрагенту. Также доступны Excel (с сохранением структуры ячеек), HTML и ODS. Программно сохранение выполняется методом ТабДок.Записать(ИмяФайла, ТипФайлаТабличногоДокумента.PDF).

Частые вопросы