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