Как загрузить файл CFE в 1С: инструкция по подключению расширения

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

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

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

Что такое файл CFE и когда его нужно загружать

CFE (Configuration Extension) — это скомпилированный файл расширения конфигурации платформы «1С:Предприятие 8.3». Внутри него находятся объекты метаданных, которые платформа «накладывает» поверх основной конфигурации: новые роли, подсистемы, обработки, изменённые формы и модули. Расширение не заменяет типовые объекты, а дополняет или переопределяет их поведение.

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

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

Первое и обязательное действие — сделать резервную копию базы. Для файловой базы достаточно скопировать файл 1Cv8.1CD, для клиент-серверной — выполнить выгрузку через конфигуратор («Администрирование → Выгрузить информационную базу») или средствами СУБД. Если расширение окажется несовместимым или содержит ошибку, вы сможете быстро вернуться к рабочему состоянию.

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

Третий момент — права доступа. Для загрузки через конфигуратор нужны права администратора конфигурации. Для загрузки через режим «Предприятие» — полные права в базе и отсутствие запрета на подключение расширений в профиле безопасности (актуально для клиент-серверных баз с включённым режимом безопасности).

Способ 1: загрузка CFE через конфигуратор

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

В открывшемся окне нажмите кнопку «Загрузить из файла» (или используйте контекстное меню) и укажите путь к файлу CFE. Платформа загрузит расширение и покажет его в списке с именем, версией и статусом активности. Если расширение с таким именем уже существует, платформа предложит обновить его — это нормальный сценарий при установке новой версии доработки.

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

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

Способ 2: загрузка CFE в режиме «Предприятие»

Если доступ к конфигуратору закрыт (частая ситуация в облачных сервисах и у франчайзи с ограниченным доступом), расширение можно подключить прямо из пользовательского режима. В типовых конфигурациях на базе БСП (1С:Управление торговлей, 1С:ERP, 1С:Бухгалтерия и другие) откройте «Администрирование → Печатные формы, отчёты и обработки → Расширения». В некоторых конфигурациях раздел находится по пути «НСИ и администрирование → Администрирование → Расширения».

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

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

Сравнение способов загрузки

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

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

Через режим «Предприятие»

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

Проверка результата после загрузки

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

Дополнительно откройте журнал регистрации («Администрирование → Обслуживание → Журнал регистрации» в типовых конфигурациях) и поищите ошибки за время подключения расширения. Ошибки вида «Объект метаданных не найден» или «Метод объекта не обнаружен» указывают на несовместимость расширения с текущей версией конфигурации.

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

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

Расширение в списке

Норма

Присутствует, отмечено как активное, версия соответствует переданному файлу

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

Отсутствует в списке или флаг активности снят

Работа функциональности

Норма

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

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

Функциональность не появилась или выдаёт ошибки при открытии

Журнал регистрации

Норма

Нет ошибок, связанных с расширением, после перезапуска сеанса

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

Ошибки «метод не обнаружен», «объект не найден» сразу после подключения

Обновление и удаление расширения

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

Удаление расширения выполняется в том же списке расширений: выделите строку и нажмите «Удалить» в конфигураторе или снимите флаг активности в режиме «Предприятие». Помните, что если расширение добавляло собственные данные (например, новые справочники или регистры), при удалении эти данные могут быть потеряны — уточните этот момент в описании расширения.

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

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

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

Третья ошибка — попытка загрузить файл CF (полная конфигурация) как расширение или наоборот. Это разные форматы: CF загружается через «Конфигурация → Загрузить конфигурацию из файла» и заменяет конфигурацию целиком, CFE — только через механизм расширений. Перепутав их, вы рискуете затереть рабочую конфигурацию.

Частые вопросы о загрузке CFE

Чем файл CFE отличается от файла CF?

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

Можно ли загрузить CFE без доступа к конфигуратору?

Да, в типовых конфигурациях на базе БСП это делается в режиме «Предприятие» через «Администрирование → Печатные формы, отчёты и обработки → Расширения». Ограничение — в клиент-серверных базах администратор может запретить такую загрузку профилями безопасности.

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

Проверьте, что расширение активно, перезапустите сеанс 1С и убедитесь, что у вашего пользователя есть права на объекты расширения. Если не помогло — посмотрите журнал регистрации на предмет ошибок совместимости и очистите кэш клиента.

Можно ли установить несколько расширений одновременно?

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

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

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

Как вернуть всё назад, если расширение сломало работу базы?

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