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