Расширение .cfe: три способа подключить его к базе и разобраться с ошибками

Файл CFE в 1С добавляют как расширение конфигурации . Быстрее всего это сделать прямо в рабочей программе: ☰ → Все функции → Стандартные → Управление расширениями конфигурации → Добавить из файла…, затем перезапустить 1С. Конфигуратор и снятие с поддержки для этого не нужны.

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

Что такое файл CFE и чем он отличается от CF, EPF и DT

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

Расширения появились в платформе 8.3.6. На более ранних версиях загрузить CFE нельзя.

Файлы 1С легко перепутать, поэтому сверьтесь с таблицей:

Подготовка: что проверить до того, как добавить CFE

Пять минут проверки избавляют от большинства отказов при применении.

1. Для какой конфигурации и релиза сделан файл. Расширение «цепляется» к объектам типовой конфигурации. Если разработчик делал его под БП 3.0, а у вас ЗУП 3.1, оно не применится. Если релиз сильно отличается — тоже может не встать.
2. Версия платформы. Посмотрите в ☰ → Справка → О программе. Нужна платформа не ниже той, под которую собран файл. Узнайте это у разработчика.
3. Права. Добавлять расширения может пользователь с полными правами (роль «Полные права» или «Администратор системы»).
4. Источник файла. Расширение исполняет код в вашей базе. Ставьте только файлы от своего программиста, франчайзи или известного поставщика.
5. Резервная копия. Перед первой установкой расширения в рабочую базу сделайте выгрузку .dt или копию каталога файловой базы. Особенно если расширение добавляет свои реквизиты и хранит данные.

💡 Если есть копия базы для тестов, сначала поставьте CFE туда. Так вы увидите ошибки применения, не мешая бухгалтерии.

Способ 1. Добавить файл CFE в режиме 1С:Предприятие

Это основной способ для пользователя-администратора. Конфигуратор не открывается, остальные пользователи продолжают работать.

Через стандартную функцию платформы

Работает в любой конфигурации на платформе 8.3.

1. Откройте ☰ (главное меню) → Все функции. Если пункта нет, включите его: ☰ → Сервис и настройки → Параметры → Отображать команду «Все функции».
2. Раскройте ветку Стандартные и откройте Управление расширениями конфигурации.
3. Нажмите Добавить из файла… и выберите файл .cfe.
4. Платформа покажет предупреждение безопасности о том, что расширение может содержать опасный код. Подтвердите, если доверяете источнику.
5. Расширение появится в списке. Проверьте, что флажок Активно установлен.
6. Перезапустите 1С. Изменения вступают в силу только в новом сеансе.

Через раздел «Администрирование» в типовых конфигурациях

В БП 3.0, ЗУП 3.1, УТ 11 и других конфигурациях на БСП есть своя форма списка расширений:

Если ссылки «Расширения» нет, включите флажок Расширения в той же форме «Печатные формы, отчеты и обработки».

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

Способ 2. Загрузить расширение CFE через Конфигуратор

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

1. Запустите базу в режиме Конфигуратор.
2. Откройте Конфигурация → Расширения конфигурации.
3. Если такого расширения в базе ещё нет, нажмите Добавить. Появится пустое расширение со стандартным именем — его заменит загруженное.
4. Выделите строку расширения и через меню Конфигурация этого окна выберите Загрузить конфигурацию из файла…. Укажите файл .cfe.
5. Конфигуратор спросит, обновить ли конфигурацию базы данных. Ответьте «Да» или откройте дерево расширения и выполните Конфигурация → Обновить конфигурацию базы данных (F7).
6. Закройте Конфигуратор и запустите базу в режиме 1С:Предприятие.

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

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

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

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

Способ 3. Пакетная загрузка CFE и установка из обработки

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

Файловая база:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" /LoadCfg "D:\ext\Dorabotki.cfe" -Extension "Доработки" /UpdateDBCfg -Extension "Доработки" /Out "D:\ext\log.txt"

Клиент-серверная база — то же самое, только вместо /F указывается /S "сервер\имя_базы".

• 📌 Номер версии в пути подставьте свой — посмотрите каталог C:\Program Files\1cv8\.
• 📌 Имя после -Extension — это имя расширения в базе. Если расширения ещё нет, оно будет создано с этим именем.
• 📌 Ключ /Out пишет протокол в файл. Без него ошибку загрузки придётся искать вслепую.
• 📌 Пакетный запуск нельзя выполнить, пока в этой же базе открыт Конфигуратор.

Программная установка из внешней обработки

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

&НаСервереБезКонтекста
Процедура УстановитьРасширение(АдресФайла)
    ДанныеФайла = ПолучитьИзВременногоХранилища(АдресФайла);
    Расширение = РасширенияКонфигурации.Создать();
    Расширение.БезопасныйРежим = Ложь;
    Расширение.Записать(ДанныеФайла);
КонецПроцедуры

Код работает только у пользователя с правами администратора. Если расширение с таким именем уже установлено, его сначала находят через РасширенияКонфигурации.Получить(Новый Структура("Имя", "Доработки")) и вызывают Записать у найденного объекта, а не создают новый.

Какой способ выбрать

Настройки после добавления: безопасный режим и защита от опасных действий

В списке расширений у каждой строки есть флажки. От них зависит, заработает ли доработка.

• ✅ Активно — расширение подключается при старте сеанса. Снимите флажок, чтобы временно отключить его без удаления.
• 🔒 Безопасный режим — при добавлении из файла в пользовательском режиме он обычно включён. Код расширения не может работать с файлами, внешними компонентами и COM. Если расширение загружает файлы, печатает в Excel или обращается к сайту, разработчик должен сказать, нужно ли снимать этот флажок.
• 🛡 Защита от опасных действий — показывает предупреждения при выполнении потенциально опасных операций.
• 🔁 Передавать в подчинённые узлы РИБ — если база в распределённой информационной базе, решите, нужно ли расширение на периферийных узлах.

После изменения любого флажка снова перезапустите программу.

Ошибки при добавлении CFE и что с ними делать

Тексты сообщений немного различаются по версиям платформы, но причины повторяются. Выберите свой симптом:

Ещё две частые причины, которые не похожи на ошибку:

• ❌ Загружен не тот файл. Под видом расширения прислали .cf, .epf или архив. Форма выбора файла CFE просто не покажет такие файлы или выдаст ошибку формата. Проверьте расширение и попросите у разработчика именно выгрузку расширения.
• ❌ Два расширения с одной задачей. Старая версия осталась активной, новая добавлена рядом. Они конфликтуют. Удалите старую строку или загрузите новый файл в неё же.

Если файл CFE не загружается: обходные пути

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

1. Загрузить через Конфигуратор с протоколом. Сообщения Конфигуратора подробнее, чем в пользовательском режиме: видно, какой именно объект или реквизит не нашёлся.
2. Сравнить и объединить. Откройте в Конфигураторе существующее расширение и выполните для него сравнение с конфигурацией из файла. Так можно взять из CFE только нужные объекты и пропустить конфликтующие. Это работа для программиста.
3. Проверить на копии базы. Разверните .dt в новую пустую базу и поставьте расширение туда. Если там всё работает, причина в рабочей базе: другой релиз, свои доработки, старая версия того же расширения.
4. Обновить платформу. Если файл собран на более новой платформе, обновите клиент и сервер 1С до нужной версии. Обновление сервера останавливает службу 1С и обрывает сеансы всех пользователей — делайте это вне рабочего времени.
5. Запросить файл под ваш релиз. Пришлите разработчику номер релиза конфигурации и версии платформы из окна «О программе».

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