Загрузка расширения конфигурации из файла .cfe в 1С 8.3: три способа и разбор ошибок

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

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

Что такое CFE и чем он отличается от других файлов 1С

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

Путаница с форматами — частая причина вопросов «файл не открывается». Сверьтесь с таблицей:

Ещё одно отличие от .cf: загрузка расширения не заменяет основную конфигурацию. Удалите расширение — и база вернётся к типовому поведению. С .cf такой откат без копии невозможен.

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

Пять минут подготовки экономят час разбирательств. Проверьте по списку:

• 💾 Резервная копия. Расширение, которое добавляет свои реквизиты или справочники, меняет структуру базы. Сделайте выгрузку .dt или копию каталога файловой базы.
• 👤 Права. Нужна роль с правом администрирования расширений. В типовых конфигурациях это обычно «Полные права» или «Администратор системы». Без них кнопки добавления просто не будет.
• 🔢 Версия платформы. Файл, сохранённый в более новой платформе, может не прочитаться в старой. Узнать свою версию: Справка → О программе.
• 📌 Для какой конфигурации и релиза сделано расширение. Спросите у разработчика. Расширение под БП 3.0 не применится к ЗУП, а заплатка под конкретный релиз может «упасть» после обновления.
• 🔐 Источник файла. Расширение исполняет код внутри вашей базы. Берите файлы только у своего программиста, франчайзи или проверенного поставщика.

Способы загрузить файл CFE в 1С

Способов три. Они дают одинаковый результат — расширение в базе, — но различаются удобством и контролем.

В облачных сервисах вроде 1С:Фреш Конфигуратор недоступен. Там расширение обычно ставят через пользовательский режим, а в части сервисов — только после проверки на стороне провайдера.

Как загрузить расширение CFE в пользовательском режиме

Этот способ работает в БП 3.0, ЗУП 3, УТ 11, КА 2, ERP и других конфигурациях на БСП.

Шаг 1. Откройте список расширений

1. Зайдите в раздел Администрирование.
2. Откройте Печатные формы, отчеты и обработки.
3. Нажмите ссылку Расширения.

Если ссылки нет, включите отображение команды «Все функции»: Сервис и настройки → Настройки → Показывать команду "Все функции". Затем Все функции → Стандартные → Управление расширениями конфигурации. Это стандартная форма платформы, она есть в любой конфигурации.

Шаг 2. Добавьте файл

1. Нажмите Добавить из файла….
2. Программа может показать предупреждение о безопасности. Прочитайте его: речь о том, что расширение получит доступ к данным базы. Подтвердите, если доверяете источнику.
3. Выберите файл .cfe на диске и нажмите «Открыть».

Расширение появится в списке. Посмотрите на колонки и флажки строки:

• ✅ Активно / Подключено — флажок должен стоять, иначе расширение не работает .
• 🛡️ Безопасный режим — ограничивает расширению опасные действия (работу с файлами, внешние соединения, привилегированный режим).
• ⚠️ Защита от опасных действий — включает предупреждения при запуске сомнительного кода.

Шаг 3. Перезапустите программу

Расширение подключается при старте сеанса. После добавления 1С сама предложит перезапуск. Если нет — закройте программу и откройте заново.

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

Шаг 4. Проверьте результат

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

Загрузка файла CFE через Конфигуратор

Конфигуратор даёт больше контроля. Здесь сразу видны объекты расширения и конфликты с основной конфигурацией.

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

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

Пакетная и фоновая загрузка CFE

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

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

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /F"D:\Bases\Buh" /N"Администратор" /P"пароль" ^
  /LoadCfg "D:\Ext\Pechat.cfe" -Extension "Pechat" ^
  /UpdateDBCfg -Extension "Pechat" ^
  /Out "D:\Logs\ext_load.log" /DisableStartupDialogs

Клиент-серверная база — вместо /F укажите сервер и имя базы:

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /S"srv1c\buh_main" /N"Администратор" /P"пароль" ^
  /LoadCfg "D:\Ext\Pechat.cfe" -Extension "Pechat" ^
  /UpdateDBCfg -Extension "Pechat" /Out "D:\Logs\ext_load.log"

Что здесь важно:

• 📁 Путь к 1cv8.exe подставьте свой — номер версии в папке у вас другой.
• 🏷️ -Extension задаёт имя расширения в базе. Если такого ещё нет, платформа создаст его.
• 📄 /Out пишет лог. Проверяйте его после каждого запуска: пакетный режим не показывает окна с ошибками.
• 🔑 Пароль в bat-файле лежит открытым текстом. Ограничьте доступ к скрипту правами Windows.

В новых версиях платформы есть отдельная утилита ibcmd — она работает с базой без запуска Конфигуратора. Для расширений у неё есть параметр --extension в командах загрузки и применения конфигурации. Точный синтаксис сверяйте со справкой своей версии: ibcmd help infobase config.

Как загрузить новую версию CFE поверх старой

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

Правильный порядок в пользовательском режиме:

1. Откройте список расширений и выделите строку старой версии.
2. В меню «Ещё» найдите команду обновления из файла. В разных релизах БСП она называется по-разному, ищите по слову «Обновить» или «из файла».
3. Укажите новый файл .cfe.
4. Перезапустите программу.

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

Ошибки при загрузке расширения CFE и как их исправить

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

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

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