Документы и Печать · 12 мин
Как подключить шаблоны в 1С
Как подключить шаблоны печатных форм в 1С: внешние печатные формы, макеты в конфигураторе, регистрация и проверка. Пошаговая инструкция с типичными ошибками.
Подключение шаблонов в 1С — частая задача и для пользователя, и для разработчика. Под шаблонами обычно понимают печатные формы документов (счета, акты, накладные, договоры), макеты этикеток и ценников, а также шаблоны сообщений и файлов обмена. Способ подключения зависит от того, что именно нужно добавить: готовую внешнюю печатную форму, макет внутрь конфигурации или шаблон в пользовательском режиме.
Самый простой сценарий — подключение внешней печатной формы в типовой конфигурации без изменения самой конфигурации. Это безопасный путь: файл-обработка регистрируется в справочнике дополнительных отчетов и обработок, а конфигурация остается на поддержке и обновляется штатно. Более сложный путь — добавление макета в конфигураторе, который требует снятия объектов с поддержки и аккуратной работы при обновлениях.
Ниже разобраны оба подхода, а также подключение шаблонов этикеток, договоров и сообщений. Отдельно описаны проверка результата, типичные ошибки и ограничения, с которыми сталкиваются на практике.
Какие шаблоны бывают в 1С и как выбрать способ подключения
Прежде чем подключать шаблон, определите его тип, потому что механизмы подключения различаются. Внешняя печатная форма — это файл с расширением .epf, который конфигурация регистрирует как дополнительную обработку. Макет — это шаблон табличного документа, хранящийся внутри конфигурации и вызываемый из кода. Шаблоны этикеток, ценников, SMS и писем редактируются прямо в пользовательском режиме в соответствующих справочниках.
Выбор способа зависит от источника шаблона и требований к обновлению. Если шаблон получен от разработчика в виде файла .epf и конфигурация типовая — используйте механизм дополнительных отчетов и обработок. Если печатная форма должна вызываться из нескольких мест, участвовать в общем модуле печати или поставляться вместе с доработанной конфигурацией — макет добавляется в конфигураторе.
Как выбрать способ подключения
Подключение внешней печатной формы (файл .epf)
Это основной способ для типовых конфигураций: «Бухгалтерия предприятия», «Управление торговлей», «Зарплата и управление персоналом» и других решений на Библиотеке стандартных подсистем. Сначала убедитесь, что механизм включен: откройте «Администрирование → Печатные формы, отчеты и обработки» и установите флажок «Дополнительные отчеты и обработки». Без этого пункта меню для регистрации файла не появится.
Далее перейдите по ссылке «Дополнительные отчеты и обработки», нажмите «Добавить из файла» и укажите файл .epf. Программа прочитает сведения из обработки: для каких документов она предназначена, как называется команда печати. Если файл разработан корректно, назначение подставится автоматически; если нет — укажите вручную, к каким объектам (например, документу «Реализация товаров и услуг») привязывается форма.
После записи откройте документ, из которого должна печататься форма, и нажмите кнопку «Печать». В списке команд рядом с типовыми вариантами появится новая строка с названием вашей формы. Сформируйте печатную форму и сверьте результат с образцом: реквизиты, суммы, подписи.
- 1Включите флажок «Дополнительные отчеты и обработки» в разделе «Администрирование → Печатные формы, отчеты и обработки»
- 2Откройте список дополнительных отчетов и обработок, нажмите «Добавить из файла» и выберите .epf
- 3Проверьте назначение: список документов, для которых доступна форма
- 4Запишите элемент и откройте нужный документ
- 5Нажмите «Печать» и убедитесь, что новая команда присутствует и формирует корректный документ
В файловых базах с отключенной защитой от опасных действий регистрация проходит без дополнительных вопросов. В клиент-серверном варианте и при включенном режиме защиты система может запросить подтверждение открытия внешнего файла — это нормальная реакция на потенциально опасный код.
Добавление макета в конфигураторе
Макет внутри конфигурации нужен, когда печатная форма должна поставляться вместе с решением или вызываться программно. Откройте конфигуратор, в дереве конфигурации раскройте ветку «Общие → Макеты» и добавьте новый элемент. Задайте имя латиницей без пробелов, например МакетСчетаНаОплату, и выберите тип «Табличный документ» для обычных печатных форм.
В редакторе макета создайте области: шапку, строку табличной части, подвал. Ячейки, в которые подставляются данные, оформите как параметры — в свойствах ячейки установите «Заполнение: Параметр» и задайте имя параметра, например НомерДокумента или НаименованиеТовара. Текст в фигурных скобках вида [НомерДокумента] также работает как параметр, но явное свойство надежнее и понятнее при сопровождении.
Вывод макета выполняется кодом в модуле менеджера документа или в общем модуле печати. Типовая последовательность: получить макет, вывести области в табличный документ, заполнить параметры.
Макет = ПолучитьМакет("МакетСчетаНаОплату");
ТабДок = Новый ТабличныйДокумент;
ОбластьШапка = Макет.ПолучитьОбласть("Шапка");
ОбластьШапка.Параметры.НомерДокумента = Номер;
ОбластьШапка.Параметры.ДатаДокумента = Формат(Дата, "ДЛФ=D");
ТабДок.Вывести(ОбластьШапка);
Для Каждого СтрокаТовары Из Товары Цикл
ОбластьСтрока = Макет.ПолучитьОбласть("Строка");
ОбластьСтрока.Параметры.Заполнить(СтрокаТовары);
ТабДок.Вывести(ОбластьСтрока);
КонецЦикла;Чтобы макет появился в меню «Печать» документа, команду печати регистрируют в процедуре ДобавитьКомандыПечати модуля менеджера объекта, а вывод — в процедуре Печать. В типовых конфигурациях эти процедуры уже существуют, поэтому достаточно добавить свою команду по образцу соседних.
Шаблоны этикеток, ценников, писем и SMS
Часть шаблонов подключается вообще без конфигуратора и внешних файлов. Шаблоны этикеток и ценников редактируются в справочнике «Шаблоны этикеток и ценников» (в торговых конфигурациях — раздел «Настройки и администрирование» или «Печать этикеток и ценников»). Создайте новый элемент, выберите назначение (ценник, этикетка) и отредактируйте макет встроенным редактором, разместив поля товара: наименование, цену, штрихкод.
Шаблоны писем и SMS хранятся в справочнике «Шаблоны сообщений». В тексте используются параметры в квадратных скобках, например [Контрагент.Наименование] — при отправке они подставляются автоматически. Набор доступных параметров зависит от контекста, из которого отправляется сообщение, поэтому после создания шаблона проверьте подстановку на реальном документе.
Шаблоны договоров и офисных документов подключаются через механизм «Печать из шаблонов Microsoft Office» (в типовых решениях — настройка печатных форм договоров). Файл Word с полями подстановки загружается в базу, после чего договор формируется на его основе с данными контрагента и сделки.
Проверка результата после подключения
После подключения любого шаблона проверку выполняют на реальном, но некритичном документе. Сформируйте печатную форму и сверьте ключевые поля: номер и дату документа, наименования сторон, суммы прописью и цифрами, подписи и печати. Особое внимание — округлению цен и итогов: ошибки округления в макете заметны только на данных с копейками.
Для макетов этикеток проверьте печать на целевом принтере: шаблон, корректно выглядящий на экране, может смещаться из-за полей печати и размеров носителя. Распечатайте пробный лист и совместите с реальной этикеточной лентой или листом.
Как проверить результат
Новая форма видна в меню «Печать» и открывается без ошибок
Команды нет или при нажатии возникает ошибка — проверьте назначение обработки и права пользователя
Все параметры подставлены, нет пустых полей и текста с квадратными скобками
На форме видны необработанные параметры вида [ИмяПараметра] — имена в макете и коде не совпадают
Границы областей совпадают с носителем, текст не обрезается
Смещение или обрезка — настройте поля макета и параметры страницы
Типичные ошибки и ограничения
Самая частая проблема — внешняя печатная форма не появляется в меню «Печать». Причины: не включен механизм дополнительных отчетов и обработок, в файле не заполнены сведения о назначении, у пользователя нет прав на дополнительные обработки. Проверяйте эти три пункта последовательно.
Вторая группа ошибок связана с версиями. Внешняя форма, разработанная под старую редакцию конфигурации, после обновления может перестать работать или выводить устаревшие реквизиты. Макет в конфигураторе при обновлении может быть затерт, если объект возвращен на поддержку поставщика. Поэтому все доработки документируют: какой макет добавлен, какие процедуры изменены.
Ограничения и границы самостоятельной работы
Подключение готовой внешней печатной формы и редактирование шаблонов сообщений — задачи уровня уверенного пользователя, они безопасны при наличии резервной копии. Добавление макета в конфигураторе и написание кода вывода требуют навыков программирования на встроенном языке 1С и понимания структуры конфигурации.
Обратитесь к специалисту, если нужно: изменить типовой макет с сохранением обновлений, вывести печатную форму из нескольких объектов с общей логикой, интегрировать шаблон с подписанием или отправкой. Ошибки в этих сценариях дороже исправлять, чем предотвращать.
Что важно запомнить
Готовые печатные формы подключайте как дополнительные обработки — конфигурация останется на поддержке. Свои макеты добавляйте в конфигураторе только когда это действительно необходимо. Всегда делайте резервную копию, проверяйте назначение формы и совпадение имен параметров, а результат проверяйте на реальном документе и реальном принтере.
Частые вопросы
Почему внешняя печатная форма не появляется в меню «Печать»?
Чаще всего не включен флажок «Дополнительные отчеты и обработки» в разделе «Администрирование → Печатные формы, отчеты и обработки». Если флажок включен, откройте зарегистрированную обработку и проверьте таблицу назначения: документ, из которого вы печатаете, должен быть в списке. Третья причина — права: пользователю нужно право на использование дополнительных отчетов и обработок.
Можно ли подключить шаблон, не снимая конфигурацию с поддержки?
Да, именно для этого существует механизм дополнительных отчетов и обработок. Внешняя печатная форма в формате .epf регистрируется в базе без изменения конфигурации, и штатное обновление продолжает работать. Снятия с поддержки требует только добавление макетов и кода внутрь конфигурации.
На печатной форме видны надписи в квадратных скобках вместо данных. Что делать?
Это признак того, что параметр макета не заполнен из кода: имя параметра в макете не совпадает с именем в процедуре вывода. Сравните имена посимвольно, включая регистр букв, и проверьте, что для каждой области вызывается заполнение параметров перед выводом.
Чем внешняя печатная форма отличается от макета в конфигураторе?
Внешняя форма — отдельный файл .epf, который хранится в базе как элемент справочника и легко заменяется новой версией. Макет — часть конфигурации: он надежнее встроен в общую логику, но требует конфигуратора и контроля при обновлениях. Для разовых доработок удобнее внешняя форма, для поставляемых решений — макет.
Опасно ли подключать файлы .epf из интернета?
Да. Внешняя обработка — это исполняемый код с доступом к данным базы, включая возможность их чтения, изменения и передачи. Подключайте только файлы от разработчиков, которым доверяете, проверяйте их на копии базы и не отключайте защиту от опасных действий без необходимости.
Что произойдет с подключенными шаблонами при обновлении конфигурации?
Дополнительные отчеты и обработки при штатном обновлении сохраняются, но сама форма может перестать корректно работать, если в конфигурации изменились реквизиты, на которые она опирается. Макеты и код, добавленные в конфигураторе, при обновлении требуют ручного сопоставления. После каждого обновления проверяйте печать ключевых форм.