Как открыть CFE-файл в 1С и загрузить расширение конфигурации

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

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

Ниже разобраны оба пути: загрузка расширения в режиме «Предприятие» для использования и работа с CFE через конфигуратор для просмотра и доработки, а также типичные ошибки при загрузке и способы их устранения.

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

Прежде чем открывать файл, полезно убедиться, что перед вами именно расширение. Форматы 1С легко перепутать, а способы их открытия различаются принципиально. CFE (Configuration Extension) — контейнер расширения конфигурации, появившийся в платформе 8.3.6 и получивший массовое применение начиная с версий 8.3.8 и выше.

Ключевая особенность расширения — оно не меняет типовую конфигурацию, а работает поверх неё. Это позволяет дорабатывать конфигурации на поддержке, не снимая их с замка, и упрощает последующие обновления. Именно поэтому большинство подрядчиков сегодня передают доработки именно в формате CFE.

Подготовка: что проверить перед загрузкой CFE

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

Во-первых, убедитесь, что версия платформы 1С, на которой работает ваша база, поддерживает механизм расширений и совместима с тем, под какую версию собран CFE. Расширение, созданное на более новой платформе, может не загрузиться на старой. Во-вторых, уточните у поставщика файла, для какой конфигурации и какого релиза он предназначен — расширение для «Бухгалтерии предприятия» не заработает корректно в «Управлении торговлей».

Третий обязательный шаг — резервная копия. Загрузка расширения сама по себе не перезаписывает данные, но код расширения после подключения начинает выполняться в базе, и ошибки в нём могут повлиять на документы и регистры. Выгрузите базу через конфигуратор (Администрирование → Выгрузить информационную базу) или штатными средствами СУБД, если база клиент-серверная.

Как открыть CFE через конфигуратор

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

1. 1
   Откройте базу в конфигураторе под пользователем с правами администратора
2. 2
   В меню выберите «Конфигурация» → «Расширения конфигурации»
3. 3
   В открывшемся окне нажмите «Загрузить из файла» и укажите путь к CFE-файлу
4. 4
   Проверьте имя и свойства загруженного расширения в списке
5. 5
   Нажмите F7 или выполните «Конфигурация» → «Обновить конфигурацию базы данных»
6. 6
   Перезапустите сеанс в режиме «Предприятие» и проверьте работу расширения

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

Чтобы посмотреть содержимое CFE без подключения к рабочей базе, можно загрузить его в любую пустую тестовую базу той же конфигурации. В дереве конфигурации объекты расширения отображаются отдельно — вы увидите, какие формы, модули и объекты заимствованы и изменены.

Если требуется внести правки, после загрузки расширение доступно для редактирования так же, как обычные объекты конфигурации. После правок его можно снова сохранить в CFE через кнопку «Сохранить в файл» в том же окне расширений.

Как подключить CFE в режиме «Предприятие»

Если ваша задача — просто подключить готовое расширение к базе, а не редактировать его, удобнее использовать режим «Предприятие». Этот способ не требует монопольного доступа и доступен пользователям с правами администратора прямо в рабочем интерфейсе.

Точный путь зависит от конфигурации, но в типовых решениях на БСП (Бухгалтерия, Зарплата и управление персоналом, Управление торговлей и другие) действуйте так: откройте раздел «Администрирование», найдите пункт «Печатные формы, отчёты и обработки» или «Расширения» — в разных конфигурациях название отличается. В открывшемся списке расширений нажмите «Добавить из файла» и выберите CFE-файл.

После добавления платформа проверит расширение и предложит перезапустить сеанс. Без перезапуска расширение не активируется — это частая причина ситуации «загрузил, но ничего не изменилось». После перезапуска проверьте, что расширение присутствует в списке и отмечено как активное.

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

Типичные ошибки при открытии CFE и их решение

Большинство проблем при работе с CFE сводится к нескольким повторяющимся сценариям. Зная их, диагностика занимает минуты.

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

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

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

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

Контрольные точки

Как проверить результат

Расширение в списке (конфигуратор или раздел «Расширения»)

Норма

Присутствует, флаг активности установлен, ошибок применения нет

Тревожный признак

Отсутствует в списке, снят флаг или есть отметка об ошибке

Функциональность расширения

Норма

Новые отчёты, кнопки или формы доступны и работают

Тревожный признак

Объекты не появились или выдают ошибки при открытии

Работа основной конфигурации

Норма

Штатные документы и отчёты работают как раньше

Тревожный признак

Появились ошибки в типовых операциях после подключения

Дополнительно полезно проверить журнал регистрации сразу после подключения: ошибки применения расширения и ошибки в его коде фиксируются там. Если в журнале появляются повторяющиеся ошибки, связанные с расширением, отключите его (снимите флаг активности) до выяснения причин — отключение расширения не удаляет данные и полностью обратимо.

Для клиент-серверных баз проверьте работу расширения под несколькими пользователями и ролями: расширение может добавлять объекты, на которые у части пользователей нет прав, и это нормально, если так задумано, но ошибки доступа в журнале регистрации стоит проанализировать.

Когда CFE не подходит: альтернативы и ограничения

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

Сравнение вариантов доработки

Расширение CFE

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

Внешняя обработка EPF

Подходит для разовых операций и отчётов без изменения интерфейса конфигурации. Не требует прав администратора конфигурации

Изменение конфигурации (CF)

Требуется при глубокой доработке структуры данных. Усложняет обновления и снимает объекты с поддержки

Если переданный вам CFE не решает задачу из-за ограничений механизма, уточните у разработчика, какие объекты он изменяет. Иногда правильное решение — комбинация: расширение для интерфейсных доработок плюс внешние обработки для сервисных функций.

Частые вопросы о работе с CFE-файлами

Можно ли открыть CFE-файл без установленной 1С?

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

Чем отличается загрузка CFE в конфигураторе и в режиме «Предприятие»?

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

Расширение загрузилось, но ничего не изменилось. Что делать?

Проверьте три вещи: выполнено ли обновление конфигурации базы данных (в конфигураторе), перезапущен ли сеанс после подключения, установлен ли флаг активности у расширения в списке. В подавляющем большинстве случаев причина — одна из этих трёх.

Безопасно ли подключать CFE от стороннего разработчика?

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

Можно ли конвертировать CFE обратно, чтобы посмотреть код?

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

Что произойдёт с расширением при обновлении типовой конфигурации?

Расширение сохранится, но может перестать применяться, если в новом релизе изменились заимствованные объекты. Перед обновлением проверьте совместимость расширения с новым релизом, а после обновления — откройте список расширений и убедитесь в отсутствии ошибок применения.