Разработка и Конфигурация · 11 мин
Файл CFE в 1С: что это такое и как с ним работать
Разбираем формат CFE в 1С: что такое файл расширения конфигурации, чем отличается от CF и DT, как создать, подключить, обновить и избежать типичных ошибок.
Файл с расширением .cfe — это файл расширения конфигурации 1С:Предприятие. Он содержит доработку типовой конфигурации, оформленную отдельным пакетом: формы, модули, роли, подсистемы и другие объекты, которые накладываются поверх основной конфигурации без её изменения. Механизм появился, чтобы упростить сопровождение типовых решений: вместо снятия конфигурации с поддержки доработки выносятся в расширение.
Файл CFE нельзя «открыть» как документ или архив в обычной программе — это внутренний формат платформы 1С. Работать с ним можно только через конфигуратор: подключить расширение к информационной базе, выгрузить его в файл, сравнить с другим расширением. Попытка переименовать файл или открыть его текстовым редактором ничего полезного не даст.
Чаще всего с CFE сталкиваются администраторы и разработчики при установке готовых доработок от сторонних поставщиков, при переносе наработок между базами и при обновлении типовых конфигураций. Ниже разберём, чем CFE отличается от других файлов 1С, как его подключить и что проверить, чтобы не сломать рабочую базу.
Что содержит файл CFE и зачем нужны расширения
Расширение конфигурации — это механизм платформы 1С:Предприятие 8.3, позволяющий добавлять и изменять объекты метаданных поверх основной конфигурации. Внутри CFE-файла могут быть собственные справочники, документы, отчёты, обработки, а также заимствованные объекты типовой конфигурации с изменёнными формами, модулями или макетами.
Главная цель механизма — сохранить конфигурацию на полной поддержке поставщика. Когда доработка внесена напрямую в конфигурацию, каждое обновление превращается в ручное сравнение и объединение объектов. С расширением обновление типовой части проходит штатно, а доработка остаётся отдельным слоем, который лишь нужно проверить на совместимость.
Типичные сценарии использования расширений:
- изменение печатных форм и макетов без правки типовых модулей;
- добавление реквизитов в документы и справочники;
- переопределение логики проведения или заполнения объектов через подписки на события;
- внедрение дополнительных отчётов и обработок;
- адаптация типовой конфигурации под отраслевые требования.
Чем CFE отличается от CF, DT и других файлов 1С
В практике администрирования 1С встречается несколько похожих форматов, и их часто путают. Подмена одного формата другим — распространённая причина ошибок при загрузке.
| Формат | Что содержит | Как используется |
|---|---|---|
| CFE | Расширение конфигурации (доработка-слой) | Подключается к базе поверх основной конфигурации |
| CF | Полная конфигурация (метаданные без данных) | Загрузка конфигурации, объединение, обновление |
| DT | Выгрузка информационной базы (данные + конфигурация) | Резервное копирование, перенос базы целиком |
| EPF / ERF | Внешняя обработка или отчёт | Открываются в режиме «1С:Предприятие» через «Файл → Открыть» |
Ключевое отличие: CFE не заменяет конфигурацию и не содержит данных. Если вам прислали CFE-файл, загружать его через «Загрузить конфигурацию из файла» нельзя — эта операция предназначена для CF и приведёт к ошибке формата или, что хуже, к неправильным действиям с конфигурацией базы.
Как создать и выгрузить файл CFE
Создание расширения выполняется в конфигураторе. Откройте меню «Конфигурация → Расширения конфигурации», нажмите «Создать», задайте имя, префикс и синоним. Префикс важен: он добавляется к именам новых объектов расширения и предотвращает конфликты имён с основной конфигурацией и другими расширениями.
После этого в дереве конфигурации появляется возможность заимствовать объекты: выделите нужный объект основной конфигурации и добавьте его в расширение через контекстное меню. Изменения вносите только в заимствованные объекты — формы, модули, команды. Новые собственные объекты создаются непосредственно в расширении.
Чтобы получить CFE-файл, в окне списка расширений выделите нужное и нажмите кнопку выгрузки (или пункт «Выгрузить в файл» контекстного меню), укажите путь сохранения. Платформа сохранит файл с расширением .cfe, который можно передать коллегам или подключить в другой базе с аналогичной конфигурацией.
- 1Откройте базу в конфигураторе под пользователем с правами администратора
- 2Перейдите в меню «Конфигурация → Расширения конфигурации»
- 3Выделите нужное расширение в списке
- 4Нажмите «Выгрузить в файл» и укажите папку сохранения
- 5Проверьте, что файл появился с расширением .cfe и ненулевым размером
Как подключить CFE-файл к информационной базе
Подключение выполняется в том же окне «Расширения конфигурации». Нажмите «Добавить» или используйте команду загрузки из файла, укажите путь к CFE-файлу, задайте имя расширения. После загрузки расширение появится в списке, но изменения вступят в силу после перезапуска сеанса пользователей.
Перед подключением на рабочей базе сделайте выгрузку DT — это обязательное условие безопасной работы. Затем проверьте соответствие релизов: расширение, разработанное под одну версию типовой конфигурации, может работать некорректно на другой, если заимствованные объекты изменились поставщиком.
Обратите внимание на настройки расширения в списке: флажок «Активно» включает и отключает расширение без удаления, а свойства «Безопасный режим» и «Защита от опасных действий» ограничивают выполнение потенциально опасного кода. Для расширений из недоверенных источников безопасный режим включать обязательно.
Обновление типовой конфигурации при установленных расширениях
Одно из главных преимуществ расширений — упрощённое обновление. Однако «упрощённое» не значит «автоматическое». После обновления типовой конфигурации платформа может отключить расширение, если заимствованные объекты изменились: например, в форме удалили реквизит, который расширение изменяло.
Порядок безопасного обновления: сначала обновите конфигурацию на тестовой копии базы, затем откройте список расширений и проверьте статус каждого. Платформа показывает расширения, несовместимые с новой версией. Для таких расширений нужно открыть их в конфигураторе, выполнить проверку применимости и исправить конфликты — обычно это повторное заимствование изменённых объектов.
Полезная практика — выгружать CFE-файлы всех подключённых расширений перед обновлением. Тогда даже при повреждении расширения в базе у вас останется его копия для восстановления или анализа.
Ограничения механизма расширений
Расширения не всесильны: часть доработок по-прежнему требует прямого изменения конфигурации. Ограничения зависят от версии платформы, но в целом в расширениях нельзя или затруднительно изменять планы обмена, некоторые критерии отбора, последовательности, а также ряд системных свойств объектов. Возможности постепенно расширяются в новых версиях платформы.
Ещё одно ограничение — производительность и диагностика. Многочисленные расширения, перекрывающие одни и те же обработчики, усложняют поиск причин ошибок: стек вызовов проходит через несколько слоёв. Поэтому не стоит дробить доработки на десятки мелких расширений без необходимости.
Если доработка требует глубокого вмешательства в структуру метаданных, сравните варианты: расширение, внешняя обработка или снятие конфигурации с поддержки. У каждого пути своя цена сопровождения.
Чем выполнить доработку
Подходит для форм, печати, подписок, новых объектов; конфигурация остаётся на поддержке. Ограничение — не все объекты можно заимствовать
Подходит для разовых операций и дополнительных отчётов; не может менять типовые формы и модули
Позволяет любые доработки, но усложняет обновления и снимает объекты с полной поддержки
Как проверить результат после подключения расширения
После подключения CFE и перезапуска сеанса убедитесь, что доработка реально работает. Откройте изменённую форму, выполните типовую операцию, которую затрагивает расширение, и сформируйте связанные отчёты или печатные формы. Проверяйте под пользователем с обычными правами, а не только под администратором: часть проблем связана с ролями, которые добавляет расширение.
Параллельно проверьте журнал регистрации на предмет ошибок при запуске сеанса и выполнении операций. Ошибки вида «объект не найден» или «метод не обнаружен» после подключения расширения — признак несовместимости версий.
Как проверить результат
Стоит флажок «Активно», ошибок применимости нет
Расширение отключено платформой или помечено как несовместимое
Формы открываются, новые элементы видны и функционируют
Ошибки при открытии формы, пропавшие реквизиты
Нет новых ошибок после перезапуска сеансов
Ошибки вызова методов или обращения к объектам расширения
Пользователи с типовыми ролями видят новые объекты
Доработка доступна только администратору
Часто задаваемые вопросы
Чем открыть файл CFE без 1С?
Никак. CFE — внутренний двоичный формат платформы 1С:Предприятие, сторонние программы его не читают. Чтобы посмотреть содержимое, подключите файл как расширение в тестовой базе через конфигуратор и изучите объекты в дереве конфигурации.
Можно ли подключить CFE из другой конфигурации?
Технически файл загрузится, но расширение будет работать корректно только с той конфигурацией, под которую разработано. Если заимствованные объекты отсутствуют в вашей конфигурации, платформа откажется применять расширение или отключит его при первой проверке.
Чем CFE отличается от внешней обработки EPF?
EPF — самостоятельная обработка, запускаемая вручную или через механизм дополнительных отчётов и обработок. CFE — слой доработки, который встраивается в конфигурацию: меняет типовые формы, модули и добавляет новые объекты метаданных. Внешняя обработка не может изменить типовую форму документа, расширение — может.
Опасно ли подключать расширение от стороннего разработчика?
Да, если источник непроверенный: код расширения выполняется с правами пользователей базы и может обращаться к данным. Включайте безопасный режим в свойствах расширения, тестируйте на копии базы и по возможности запрашивайте у разработчика описание функциональности.
Что делать, если после обновления расширение отключилось?
Откройте конфигуратор, перейдите в список расширений и посмотрите причину несовместимости. Обычно нужно заново заимствовать изменённые поставщиком объекты и перенести в них свои доработки. Если есть выгруженный CFE-файл рабочей версии, его можно использовать как эталон для сравнения.
Можно ли удалить расширение без последствий?
Да, если расширение не добавляло собственные объекты с данными. Удаление расширения, содержащего собственные справочники или документы, приведёт к удалению этих данных из базы. Перед удалением сделайте выгрузку DT и выгрузите само расширение в CFE-файл.
Что важно запомнить
CFE — это файл расширения конфигурации 1С: доработка, которая накладывается на типовую конфигурацию без её изменения и сохраняет её на поддержке. Работа с файлом ведётся только через конфигуратор («Конфигурация → Расширения конфигурации»), а перед подключением или обновлением обязательно делайте резервную копию базы и проверяйте совместимость релизов.