Расширение конфигурации в файле .cfe: откуда берётся и как с ним обращаться

Файл CFE в 1С — это расширение конфигурации , сохранённое в один файл. Внутри лежат изменённые и добавленные объекты: формы, модули, макеты печатных форм, реквизиты, роли. Открывают его не блокнотом, а Конфигуратором или формой «Управление расширениями» в режиме 1С:Предприятие, после чего расширение подключается к базе поверх типовой конфигурации и не снимает её с поддержки.

Формат появился вместе с механизмом расширений в платформе 8.3.6 и с тех пор стал главным способом дорабатывать типовые БП 3.0, ЗУП 3.1, УТ 11 и ERP. Если вам прислали .cfe от программиста или поставщика сервиса, способов подключить его два: через пользовательский режим (проще, не нужен Конфигуратор) и через Конфигуратор (больше контроля). Какой выбрать, разберём ниже по шагам.

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

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

Что может оказаться внутри:

• 🧩 заимствованные объекты — копии ссылок на объекты основной конфигурации, к которым расширение «цепляется»;
• 📝 модули с аннотациями &Перед, &После, &Вместо, &ИзменениеИКонтроль — так расширение встраивается в типовой код, не правя его;
• 🖨 макеты и формы — изменённые печатные формы, новые кнопки и поля на формах документов;
• 📦 собственные объекты — справочники, регистры, документы, если расширение их добавляет;
• 🔐 роли — права на новые объекты;
• ⚙️ свойства самого расширения: имя, синоним, версия, префикс имён, назначение, режим совместимости.

Чтобы не путаться в расширениях файлов, держите под рукой сравнение.

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

Назначение расширения

У каждого расширения есть свойство «Назначение». Оно влияет на порядок применения, когда расширений в базе несколько:

1. Исправление — срочные правки ошибок типовой. Применяются первыми.
2. Адаптация — доработки под конкретную компанию.
3. Дополнение — новый функционал, интеграции, отраслевые модули.

Внутри одной группы порядок зависит от того, в какой последовательности расширения подключали.

Как создают файл CFE и сохраняют расширение

Файл CFE не создают «с нуля» в проводнике. Сначала в базе появляется расширение, потом его выгружают в файл.

Создание и выгрузка в Конфигураторе

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

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

Выгрузка из пользовательского режима

Если Конфигуратора под рукой нет, файл можно получить и в 1С:Предприятии. В БП 3.0, ЗУП 3.1 и УТ 11 список расширений открывается по пути Администрирование → Печатные формы, отчеты и обработки → Расширения. Выделите строку и выберите в меню «Ещё» команду сохранения в файл.

Выгрузка из командной строки

Для скриптов и резервного копирования используют пакетный запуск Конфигуратора:

"C:\Program Files\1cv8\8.3.24.1586\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "" /DumpCfg "D:\Backup\Fix_Print.cfe" -Extension "Fix_Print" /Out "D:\Backup\dump.log"

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

Чем открыть файл CFE и как посмотреть, что внутри

Файл CFE — двоичный контейнер платформы. Блокнот или Word покажут набор нечитаемых символов. Это не шифрование: данные просто упакованы. «Расшифровывать» ничего не нужно, нужно открыть файл правильным инструментом.

Способы по возрастанию сложности:

Пошагово: безопасный просмотр через тестовую базу

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

Для выгрузки в XML используйте в окне расширения Конфигурация → Выгрузить конфигурацию в файлы…. Получится папка, которую удобно сравнивать любой утилитой сравнения текстов.

Как подключить расширение из CFE к рабочей базе

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

Через 1С:Предприятие

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

Через Конфигуратор

1. Конфигурация → Расширения конфигурации → «Добавить».
2. Откройте новое расширение и загрузите в него .cfe из меню Конфигурация → Загрузить из файла….
3. Обновите конфигурацию базы данных для расширения (F7 в окне расширения).
4. Для пакетного режима есть ключи /LoadCfg "файл.cfe" -Extension "Имя" и следом /UpdateDBCfg -Extension "Имя". Загрузка и обновление — два отдельных шага, без второго расширение не заработает.

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

CFE от поставщиков сервисов и торгового оборудования

Отдельный сценарий: файл CFE приходит не от своего программиста, а от компании-партнёра. Так распространяют модули интеграции с банками, маркетплейсами, сервисами доставки, системами лояльности, отдельные доработки для работы с кассами и платёжными терминалами.

Здесь часто путают два разных вида файлов:

• 🔌 драйвер оборудования (ККТ, сканер, весы, эквайринг) — это внешняя компонента, обычно в архиве .zip. Её подключают в карточке экземпляра оборудования через Администрирование → Подключаемое оборудование, а не через список расширений;
• 🧩 расширение .cfe — дорабатывает логику конфигурации: добавляет команды, обработку ответов от устройства, новые поля в документах.

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

Что спросить у поставщика до установки:

1. На какие конфигурации и релизы рассчитана версия файла.
2. Минимальный номер платформы: расширение с режимом совместимости новее вашей платформы не загрузится.
3. Нужно ли снимать «Безопасный режим» и почему.
4. Как ставить новую версию: поверх старой или с удалением.

Ошибки при загрузке CFE и как их разобрать

Платформа почти всегда пишет причину текстом. Читайте сообщение полностью, ответ обычно в последней строке.

Ещё две ситуации, которые не всегда видны сразу:

• 🗂 Распределённая база. Если расширение должно работать во всех узлах РИБ, у него включают свойство использования в распределённой базе. Иначе в периферийных узлах доработки не будет.
• 🧾 Модель сервиса и разделение данных. В облачных и разделённых базах есть область действия расширения: вся база или конкретная область данных. Не та область — расширение «не видно» части пользователей.

Версии CFE и безопасность доработок

Расширение — исполняемый код, который работает с данными бухгалтерии. Относитесь к .cfe так же, как к программе, скачанной из интернета.

Безопасность

• 🔒 Устанавливайте файлы только из известного источника: свой программист, договор с партнёром.
• 🛡 Оставляйте «Безопасный режим» включённым, если автор не объяснил, зачем его снимать.
• 👤 Давайте права на добавление расширений только администраторам. Право на интерактивное добавление расширений есть в ролях полного доступа; рядовым пользователям оно не нужно.
• 🧹 Неиспользуемые расширения удаляйте. Каждое лишнее расширение замедляет запуск и усложняет обновления.

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

Управление версиями

1. Нумерация. Ведите свойство «Версия» в формате 1.4.2 и пишите в комментарии к релизу, что поменялось.
2. Имя файла. Шаблон Имя_версия_дата.cfe, например Fix_Print_1.4.2_2026-10-07.cfe.
3. Архив. Храните предыдущие версии хотя бы за два-три обновления типовой: так можно быстро откатиться.
4. Git. Для команды разработки удобнее выгрузка в XML и система контроля версий, чем папка с файлами .cfe.
5. Хранилище. Расширение можно подключить к хранилищу конфигурации, как основную конфигурацию, если над ним работают несколько программистов.

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