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

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

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

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

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

Перед началом работы определите, какой именно файл у вас на руках. Шаблон конфигурации — это обычно каталог с файлами 1Cv8.cf и 1Cv8.cft или установщик setup.exe. Внешняя печатная форма — файл с расширением .epf. Макет печатной формы для типовой конфигурации может поставляться и как файл .mxl, и как документ Word (.docx) для офисных макетов.

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

Как определить, какой шаблон нужно добавить

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

Ориентируйтесь на расширение файла и источник. Файлы .cf и .cft относятся к конфигурациям, .epf — к внешним обработкам и печатным формам, .mxl и .docx — к макетам. Если поставщик прислал архив, распакуйте его и посмотрите состав: наличие файла 1Cv8.cft однозначно указывает на шаблон конфигурации.

Файл 1Cv8.cft или 1Cv8.cfШаблон конфигурации

Добавляется при создании новой базы в конфигураторе

Файл .epfВнешняя печатная форма или обработка

Подключается в режиме 1С:Предприятие

Файл .mxl или .docxМакет печатной формы

Загружается в макет объекта или в справочник макетов

Как добавить шаблон конфигурации при создании базы

Шаблоны конфигураций платформа хранит в специальном каталоге. При установке типового дистрибутива запускается setup.exe, который сам копирует файлы в каталог шаблонов (по умолчанию это подкаталог tmplts в папке установки платформы или в профиле пользователя). Если у вас только файлы .cf/.cft без установщика, их можно скопировать в каталог шаблонов вручную, создав отдельную подпапку с понятным именем.

После этого откройте конфигуратор через ярлык «1С:Предприятие», в окне запуска нажмите «Добавить» и выберите «Создание новой информационной базы». В списке шаблонов появится добавленная конфигурация — выберите её, укажите имя и каталог базы, затем дождитесь завершения загрузки. Если шаблон в списке не появился, проверьте путь к каталогу шаблонов: он задаётся в настройках окна запуска (кнопка «Настройка», поле «Каталоги шаблонов конфигураций»).

Порядок добавления шаблона конфигурации
  1. 1
    Установите дистрибутив через setup.exe или скопируйте файлы .cft/.cf в каталог шаблонов
  2. 2
    Откройте окно запуска 1С и нажмите «Добавить» → «Создание новой информационной базы»
  3. 3
    Выберите нужный шаблон из списка и задайте имя и каталог базы
  4. 4
    Дождитесь окончания загрузки и запустите конфигуратор для проверки
  5. 5
    Если шаблона нет в списке — проверьте путь к каталогу шаблонов в настройках запуска

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

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

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

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

Как добавить макет печатной формы в конфигураторе

Этот сценарий относится к доработке конфигурации и требует прав на изменение. Откройте конфигуратор, найдите нужный объект (документ или справочник), раскройте ветку «Макеты» и через контекстное меню выберите «Добавить». Задайте имя макета и тип: табличный документ (внутренний формат 1С) или макет Microsoft Word/OpenOffice — последний удобен, когда форму должны править пользователи без конфигуратора.

Заполните макет областями и параметрами: параметры обозначаются в фигурных скобках, например {НомерДокумента}, и подставляются из кода при формировании печатной формы. Затем в модуле менеджера объекта или в команде печати добавьте код, который получает макет, заполняет параметры и выводит области в табличный документ. Без этого кода макет останется «мёртвым» — сам по себе он ничего не печатает.

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

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

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

Сравнение способов

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

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

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

Полный контроль над формой и логикой, можно добавлять команды и автоматику. Минус: требует снятия с поддержки и усложняет обновления.

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

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

Как проверить, что шаблон добавлен корректно

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

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

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

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

Шаблон в списке при создании базы
Норма

Шаблон виден и база создаётся без ошибок

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

Шаблона нет в списке — неверный каталог шаблонов

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

Новая кнопка есть в меню «Печать»

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

Кнопки нет — не заполнено размещение обработки

Сформированная форма
Норма

Все поля заполнены данными документа

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

Пустые поля или текст в фигурных скобках — ошибка в параметрах макета

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

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

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

Типичные ошибки
01
Добавление .epf через конфигуратор как макет — обработка не заработает, её нужно подключать в режиме предприятия
02
Снятие конфигурации с поддержки ради одной печатной формы — усложняет все последующие обновления
03
Копирование файлов шаблона не в тот каталог — шаблон не появляется в списке при создании базы
04
Несовпадение имён параметров в макете и в коде — поля в печатной форме остаются пустыми

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

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

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

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

Проверьте путь к каталогу шаблонов в настройках окна запуска 1С (кнопка «Настройка»). Файлы .cft должны лежать именно в этом каталоге или его подкаталогах. Также убедитесь, что версия платформы не ниже той, для которой собран шаблон.

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

.cf — это файл поставки конфигурации, из него можно загрузить конфигурацию в существующую базу. .cft — файл шаблона, из которого создаётся новая информационная база через окно запуска. Для добавления шаблона нужен именно .cft.

Внешняя обработка загрузилась, но кнопки печати в документе нет. Что делать?

Откройте карточку обработки в списке дополнительных отчётов и обработок и проверьте таблицу «Размещение»: там должен быть указан нужный тип документа. Если список пуст или не содержит нужного объекта, добавьте его вручную и сохраните.

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

Да. Файл .epf содержит исполняемый код, который выполняется с правами пользователя и может изменять данные базы. Подключайте обработки только из доверенных источников и предварительно проверяйте их на копии базы.

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

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

Итог

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

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