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

Разработка и Конфигурация · 10 мин

Как подгрузить шаблон в 1С: подробная инструкция

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

Подгрузка шаблона в 1С — одна из самых частых задач при работе с типовыми конфигурациями. Под шаблоном обычно понимают внешнюю печатную форму (файл .epf), макет документа, шаблон текста для автоподстановки или шаблон конфигурации (.cf/.dt) при создании новой базы. Способ загрузки зависит от того, какой именно шаблон нужен и в какой конфигурации вы работаете.

Чаще всего вопрос возникает у пользователей «1С:Бухгалтерии», «1С:Управление торговлей» и «1С:Зарплата и управление персоналом», когда нужно добавить нестандартную печатную форму договора, счёта или акта. Реже — у разработчиков, которые подгружают макеты непосредственно в конфигуратор. Оба сценария разберём ниже.

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

Определите, какой тип шаблона нужно загрузить

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

Основные варианты: внешняя печатная форма или обработка (файл с расширением .epf или .erf), внешний отчёт (.erf), шаблон конфигурации для создания новой базы (файл .cf или .dt), макет табличного документа внутри конфигурации, а также пользовательские шаблоны текста или шаблоны сообщений для рассылок.

Сравнение вариантов

Внешняя печатная форма (.epf)

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

Шаблон конфигурации (.cf, .dt)

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

Макет в конфигураторе

Вариант для разработчика: макет редактируется внутри объекта конфигурации. Требует снятия объекта с поддержки, что усложняет обновления.

Подготовьте файл и проверьте права доступа

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

Проверьте свои права: откройте раздел «Администрирование» — если он доступен и в нём виден пункт «Печатные формы, отчеты и обработки», прав достаточно. Если раздела нет, обратитесь к администратору базы, потому что загрузка внешних обработок требует права «Интерактивное открытие внешних отчетов и обработок» и доступа к справочнику дополнительных обработок.

Загрузите внешний шаблон через «Дополнительные отчеты и обработки»

Это стандартный способ для типовых конфигураций на управляемых формах (Бухгалтерия 3.0, УТ 11, ЗУП 3.1, ERP). Он не требует конфигуратора и не затрагивает структуру конфигурации.

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

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

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

Загрузите шаблон через конфигуратор

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

Загрузка конфигурации или обновления из файла

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

Добавление макета к объекту

Чтобы добавить макет печатной формы внутрь конфигурации, найдите нужный объект (документ или справочник) в дереве конфигурации, откройте ветку «Макеты» и добавьте новый макет типа «Табличный документ». Готовый табличный документ можно вставить из ранее сохранённого файла .mxl через «Файл → Открыть» с последующим копированием содержимого. Учтите, что изменение типового объекта снимает его с полной поддержки и усложняет будущие обновления.

Подгрузите шаблон при создании новой базы

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

При запуске стартера 1С нажмите «Добавить», выберите «Создание новой информационной базы», и в списке появятся доступные шаблоны конфигураций. Если нужного шаблона нет, укажите вручную каталог с развёрнутым шаблоном — в нём должен находиться файл манифеста 1cv8.mft и файл базы 1Cv8.dt или конфигурация.

Если шаблон установлен, но в списке не отображается, проверьте путь к каталогу шаблонов в настройках стартера: при запуске окна списка баз нажмите «Настройка» и убедитесь, что каталог tmplts указан в списке «Каталоги шаблонов конфигураций и обновлений».

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

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

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

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

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

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

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

Формы нет в списке или при открытии возникает ошибка выполнения

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

В макет подставляются реквизиты документа: номер, дата, контрагент, суммы

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

Поля пустые или вместо значений выводятся имена параметров

Поведение после обновления
Норма

После обновления конфигурации внешняя форма по-прежнему работает

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

Форма перестала открываться — вероятно, изменились имена реквизитов, к которым она обращается

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

Типичные ошибки и их решение

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

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

Храните файлы внешних печатных форм в отдельной папке с указанием конфигурации и релиза в имени файла, например «Счет_БП30_версия_2.epf». После очередного обновления программы вы сразу поймёте, какие формы нужно перепроверить, а коллеги не загрузят устаревшую версию.
ПЗ
Практическое замечание

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

Можно ли подгрузить шаблон в 1С без конфигуратора?

Да, если это внешняя печатная форма, отчёт или обработка. Используйте раздел «Администрирование → Печатные формы, отчеты и обработки → Дополнительные отчеты и обработки». Конфигуратор нужен только для изменения самой конфигурации: добавления макетов в объекты, загрузки .cf или обновления релиза.

Почему загруженная печатная форма не появляется в документе?

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

Чем файл .epf отличается от .cf и .dt?

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

Опасно ли загружать внешние шаблоны из интернета?

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

Что делать, если после обновления 1С шаблон перестал работать?

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

Как вернуть стандартную печатную форму вместо загруженной?

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

Итог

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

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