К статье
Практический материал

Документы и Печать · 12 мин

Как подключить шаблоны в 1С

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

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

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

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

Какие шаблоны бывают в 1С и как выбрать способ подключения

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

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

Маршрут решения

Как выбрать способ подключения

Есть файл .epf от разработчика и типовая конфигурацияПодключайте через «Дополнительные отчеты и обработки» — конфигурация останется на поддержке
Шаблон должен быть частью конфигурации и вызываться из кодаДобавляйте макет в конфигураторе в ветке «Общие → Макеты»
Нужно изменить этикетку, ценник, текст письма или SMSРедактируйте шаблон в пользовательском режиме в соответствующем справочнике
Конфигурация снята с поддержки и сильно доработанаМакет в конфигураторе предпочтительнее — внешние обработки усложнят сопровождение

Подключение внешней печатной формы (файл .epf)

Это основной способ для типовых конфигураций: «Бухгалтерия предприятия», «Управление торговлей», «Зарплата и управление персоналом» и других решений на Библиотеке стандартных подсистем. Сначала убедитесь, что механизм включен: откройте «Администрирование → Печатные формы, отчеты и обработки» и установите флажок «Дополнительные отчеты и обработки». Без этого пункта меню для регистрации файла не появится.

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

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

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

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

Добавление макета в конфигураторе

Макет внутри конфигурации нужен, когда печатная форма должна поставляться вместе с решением или вызываться программно. Откройте конфигуратор, в дереве конфигурации раскройте ветку «Общие → Макеты» и добавьте новый элемент. Задайте имя латиницей без пробелов, например МакетСчетаНаОплату, и выберите тип «Табличный документ» для обычных печатных форм.

В редакторе макета создайте области: шапку, строку табличной части, подвал. Ячейки, в которые подставляются данные, оформите как параметры — в свойствах ячейки установите «Заполнение: Параметр» и задайте имя параметра, например НомерДокумента или НаименованиеТовара. Текст в фигурных скобках вида [НомерДокумента] также работает как параметр, но явное свойство надежнее и понятнее при сопровождении.

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

bsl
Макет = ПолучитьМакет("МакетСчетаНаОплату");
ТабДок = Новый ТабличныйДокумент;
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьШапка.Параметры.НомерДокумента = Номер;
ОбластьШапка.Параметры.ДатаДокумента = Формат(Дата, "ДЛФ=D");
ТабДок.Вывести(ОбластьШапка);
Для Каждого СтрокаТовары Из Товары Цикл
    ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
    ОбластьСтрока.Параметры.Заполнить(СтрокаТовары);
    ТабДок.Вывести(ОбластьСтрока);
КонецЦикла;

Чтобы макет появился в меню «Печать» документа, команду печати регистрируют в процедуре ДобавитьКомандыПечати модуля менеджера объекта, а вывод — в процедуре Печать. В типовых конфигурациях эти процедуры уже существуют, поэтому достаточно добавить свою команду по образцу соседних.

Шаблоны этикеток, ценников, писем и SMS

Часть шаблонов подключается вообще без конфигуратора и внешних файлов. Шаблоны этикеток и ценников редактируются в справочнике «Шаблоны этикеток и ценников» (в торговых конфигурациях — раздел «Настройки и администрирование» или «Печать этикеток и ценников»). Создайте новый элемент, выберите назначение (ценник, этикетка) и отредактируйте макет встроенным редактором, разместив поля товара: наименование, цену, штрихкод.

Шаблоны писем и SMS хранятся в справочнике «Шаблоны сообщений». В тексте используются параметры в квадратных скобках, например [Контрагент.Наименование] — при отправке они подставляются автоматически. Набор доступных параметров зависит от контекста, из которого отправляется сообщение, поэтому после создания шаблона проверьте подстановку на реальном документе.

Шаблоны договоров и офисных документов подключаются через механизм «Печать из шаблонов Microsoft Office» (в типовых решениях — настройка печатных форм договоров). Файл Word с полями подстановки загружается в базу, после чего договор формируется на его основе с данными контрагента и сделки.

Проверка результата после подключения

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

Для макетов этикеток проверьте печать на целевом принтере: шаблон, корректно выглядящий на экране, может смещаться из-за полей печати и размеров носителя. Распечатайте пробный лист и совместите с реальной этикеточной лентой или листом.

Контрольные точки

Как проверить результат

Команда печати в документе
Норма

Новая форма видна в меню «Печать» и открывается без ошибок

Тревожный признак

Команды нет или при нажатии возникает ошибка — проверьте назначение обработки и права пользователя

Заполнение данных
Норма

Все параметры подставлены, нет пустых полей и текста с квадратными скобками

Тревожный признак

На форме видны необработанные параметры вида [ИмяПараметра] — имена в макете и коде не совпадают

Печать на принтере
Норма

Границы областей совпадают с носителем, текст не обрезается

Тревожный признак

Смещение или обрезка — настройте поля макета и параметры страницы

Типичные ошибки и ограничения

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

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

Типичные ошибки
01
Подключение .epf без проверки назначения — форма регистрируется, но недоступна ни в одном документе
02
Расхождение имен параметров в макете и в коде — на печати остаются пустые поля или текст в квадратных скобках
03
Изменение типового макета вместо создания своего — при обновлении доработка теряется
04
Работа без резервной копии — ошибка в коде обработки может повредить данные без возможности отката
05
Игнорирование прав доступа — пользователи не видят новую форму, хотя у администратора все работает

Ограничения и границы самостоятельной работы

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

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

Итог

Что важно запомнить

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

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

Почему внешняя печатная форма не появляется в меню «Печать»?

Чаще всего не включен флажок «Дополнительные отчеты и обработки» в разделе «Администрирование → Печатные формы, отчеты и обработки». Если флажок включен, откройте зарегистрированную обработку и проверьте таблицу назначения: документ, из которого вы печатаете, должен быть в списке. Третья причина — права: пользователю нужно право на использование дополнительных отчетов и обработок.

Можно ли подключить шаблон, не снимая конфигурацию с поддержки?

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

На печатной форме видны надписи в квадратных скобках вместо данных. Что делать?

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

Чем внешняя печатная форма отличается от макета в конфигураторе?

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

Опасно ли подключать файлы .epf из интернета?

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

Что произойдет с подключенными шаблонами при обновлении конфигурации?

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