Разработка и Конфигурация · 10 мин
Как добавить шаблон в 1С: пошаговая инструкция
Как добавить шаблон в 1С: установка шаблона конфигурации, загрузка внешней печатной формы и создание макета. Пошаговые инструкции, ошибки и проверка результата.
Под словом «шаблон» в 1С чаще всего понимают три разные вещи: шаблон конфигурации для создания новой информационной базы, внешнюю печатную форму (файл с расширением .epf или макет документа) и макет внутри конфигурации. Порядок действий в каждом случае принципиально различается, и путать их нельзя: попытка «установить» печатную форму как шаблон конфигурации ни к чему не приведёт.
Перед началом работы определите, какой именно файл у вас на руках. Шаблон конфигурации — это обычно каталог с файлами 1Cv8.cf и 1Cv8.cft или установщик setup.exe. Внешняя печатная форма — файл с расширением .epf. Макет печатной формы для типовой конфигурации может поставляться и как файл .mxl, и как документ Word (.docx) для офисных макетов.
Дальше разберём все три сценария по отдельности: от установки шаблона конфигурации через конфигуратор до добавления внешней печатной формы в пользовательском режиме без изменения конфигурации.
Как определить, какой шаблон нужно добавить
Первый шаг — классифицировать задачу. Если нужно создать новую информационную базу на основе готового решения (например, развернуть типовую «1С:Бухгалтерию» или отраслевую конфигурацию), речь идёт о шаблоне конфигурации. Если требуется заменить или дополнить печатную форму существующего документа — о внешней печатной форме или макете.
Ориентируйтесь на расширение файла и источник. Файлы .cf и .cft относятся к конфигурациям, .epf — к внешним обработкам и печатным формам, .mxl и .docx — к макетам. Если поставщик прислал архив, распакуйте его и посмотрите состав: наличие файла 1Cv8.cft однозначно указывает на шаблон конфигурации.
Добавляется при создании новой базы в конфигураторе
Подключается в режиме 1С:Предприятие
Загружается в макет объекта или в справочник макетов
Как добавить шаблон конфигурации при создании базы
Шаблоны конфигураций платформа хранит в специальном каталоге. При установке типового дистрибутива запускается setup.exe, который сам копирует файлы в каталог шаблонов (по умолчанию это подкаталог tmplts в папке установки платформы или в профиле пользователя). Если у вас только файлы .cf/.cft без установщика, их можно скопировать в каталог шаблонов вручную, создав отдельную подпапку с понятным именем.
После этого откройте конфигуратор через ярлык «1С:Предприятие», в окне запуска нажмите «Добавить» и выберите «Создание новой информационной базы». В списке шаблонов появится добавленная конфигурация — выберите её, укажите имя и каталог базы, затем дождитесь завершения загрузки. Если шаблон в списке не появился, проверьте путь к каталогу шаблонов: он задаётся в настройках окна запуска (кнопка «Настройка», поле «Каталоги шаблонов конфигураций»).
- 1Установите дистрибутив через setup.exe или скопируйте файлы .cft/.cf в каталог шаблонов
- 2Откройте окно запуска 1С и нажмите «Добавить» → «Создание новой информационной базы»
- 3Выберите нужный шаблон из списка и задайте имя и каталог базы
- 4Дождитесь окончания загрузки и запустите конфигуратор для проверки
- 5Если шаблона нет в списке — проверьте путь к каталогу шаблонов в настройках запуска
Как подключить внешнюю печатную форму без изменения конфигурации
Самый безопасный способ добавить свой шаблон печатной формы в типовую конфигурацию — механизм дополнительных отчётов и обработок. Он работает в режиме 1С:Предприятие и не требует снятия конфигурации с поддержки, что сохраняет возможность штатного обновления.
Откройте раздел «Администрирование» → «Печатные формы, отчёты и обработки» и включите флажок «Дополнительные отчёты и обработки». Перейдите по одноимённой ссылке, нажмите «Добавить из файла» и укажите файл .epf. После загрузки откройте карточку обработки и проверьте раздел «Размещение»: там должны быть перечислены документы, для которых доступна форма. При необходимости скорректируйте список вручную.
После сохранения новая кнопка появится в меню «Печать» соответствующего документа. Если кнопки нет — чаще всего не заполнено размещение либо обработка написана под другую конфигурацию и не прошла регистрацию.
Как добавить макет печатной формы в конфигураторе
Этот сценарий относится к доработке конфигурации и требует прав на изменение. Откройте конфигуратор, найдите нужный объект (документ или справочник), раскройте ветку «Макеты» и через контекстное меню выберите «Добавить». Задайте имя макета и тип: табличный документ (внутренний формат 1С) или макет Microsoft Word/OpenOffice — последний удобен, когда форму должны править пользователи без конфигуратора.
Заполните макет областями и параметрами: параметры обозначаются в фигурных скобках, например {НомерДокумента}, и подставляются из кода при формировании печатной формы. Затем в модуле менеджера объекта или в команде печати добавьте код, который получает макет, заполняет параметры и выводит области в табличный документ. Без этого кода макет останется «мёртвым» — сам по себе он ничего не печатает.
Учтите ограничение: изменение типовой конфигурации потребует включить возможность изменений и частично снять объекты с поддержки. Это усложнит последующие обновления — каждый раз придётся контролировать, не затронуты ли изменённые объекты новым релизом.
Как выбрать способ добавления шаблона
Выбор зависит от того, насколько глубоко нужно вмешаться в конфигурацию и кто будет сопровождать решение дальше. Внешняя печатная форма подходит для большинства задач с печатью, доработка конфигурации оправдана, только когда возможностей внешней обработки не хватает — например, нужна новая команда в интерфейсе или автоматическое формирование по регламенту.
Сравнение способов
Подходит для замены и добавления печатных форм в типовых конфигурациях; не нарушает поддержку и обновления. Ограничение: работает только там, где включён механизм дополнительных отчётов и обработок.
Полный контроль над формой и логикой, можно добавлять команды и автоматику. Минус: требует снятия с поддержки и усложняет обновления.
Используется только для создания новых баз из готового решения. Не подходит для изменения существующей базы.
Как проверить, что шаблон добавлен корректно
Для шаблона конфигурации признак успеха — созданная база открывается в конфигураторе и в режиме предприятия, а в списке конфигураций отображается ожидаемое имя и версия. Для внешней печатной формы — обработка видна в списке дополнительных отчётов и обработок, у неё заполнено размещение, а в документе появилась новая команда печати.
Обязательно сформируйте тестовую печатную форму на реальном документе и сверьте ключевые поля: номер, дату, контрагента, суммы. Пустые поля или текст «{Параметр}» в готовом документе означают, что макет не связан с данными — параметр назван иначе, чем в коде, либо область не заполняется.
Как проверить результат
Шаблон виден и база создаётся без ошибок
Шаблона нет в списке — неверный каталог шаблонов
Новая кнопка есть в меню «Печать»
Кнопки нет — не заполнено размещение обработки
Все поля заполнены данными документа
Пустые поля или текст в фигурных скобках — ошибка в параметрах макета
Типичные ошибки и ограничения
Наиболее частая проблема — попытка подключить обработку, написанную под другую конфигурацию или другую версию БСП (библиотеки стандартных подсистем). Внешняя печатная форма регистрируется через стандартную функцию СведенияОВнешнейОбработке, и если её интерфейс не совпадает с ожиданиями конфигурации, файл просто не загрузится с сообщением об ошибке.
Вторая группа ошибок связана с правами: пользователю без роли «Добавление дополнительных отчётов и обработок» кнопка добавления недоступна, а в файловой базе с включённой защитой от опасных действий платформа может блокировать открытие внешних файлов. В таком случае обработку добавляет администратор либо временно отключается защита.
Частые вопросы
Можно ли добавить печатную форму, не снимая конфигурацию с поддержки?
Да. Механизм дополнительных отчётов и обработок как раз предназначен для этого: внешняя печатная форма подключается в режиме 1С:Предприятие и не затрагивает конфигурацию, поэтому обновления проходят штатно.
Почему шаблон конфигурации не появляется в списке при создании базы?
Проверьте путь к каталогу шаблонов в настройках окна запуска 1С (кнопка «Настройка»). Файлы .cft должны лежать именно в этом каталоге или его подкаталогах. Также убедитесь, что версия платформы не ниже той, для которой собран шаблон.
Чем файл .cf отличается от .cft?
.cf — это файл поставки конфигурации, из него можно загрузить конфигурацию в существующую базу. .cft — файл шаблона, из которого создаётся новая информационная база через окно запуска. Для добавления шаблона нужен именно .cft.
Внешняя обработка загрузилась, но кнопки печати в документе нет. Что делать?
Откройте карточку обработки в списке дополнительных отчётов и обработок и проверьте таблицу «Размещение»: там должен быть указан нужный тип документа. Если список пуст или не содержит нужного объекта, добавьте его вручную и сохраните.
Опасно ли открывать внешние обработки из интернета?
Да. Файл .epf содержит исполняемый код, который выполняется с правами пользователя и может изменять данные базы. Подключайте обработки только из доверенных источников и предварительно проверяйте их на копии базы.
Можно ли редактировать печатную форму обычному пользователю?
Если конфигурация поддерживает пользовательские макеты на основе Word, пользователь с соответствующими правами может открыть макет, изменить его в редакторе и загрузить обратно без конфигуратора. Возможность зависит от конкретной конфигурации.
Что важно запомнить
Определите тип шаблона по файлу: .cft — для создания новой базы через конфигуратор, .epf — внешняя печатная форма, подключаемая в режиме предприятия без изменения конфигурации. Для печатных форм предпочтителен механизм дополнительных отчётов и обработок: он сохраняет поддержку и обновления. После добавления обязательно проверьте результат на тестовом документе.