Как установить CFE-расширение в 1С

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

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

Ниже разобраны подготовка, два способа установки, проверка результата, типичные ошибки и ситуации, когда установку лучше поручить специалисту.

Что такое CFE и когда он нужен

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

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

Подготовка перед установкой

Перед подключением расширения проверьте три условия. Во-первых, версия платформы должна соответствовать требованиям разработчика расширения — CFE, созданный на более новой платформе, может не загрузиться или работать некорректно на старой. Во-вторых, режим совместимости конфигурации должен позволять использование расширений (платформа 8.3.6 и новее, на практике желательно 8.3.10+). В-третьих, у пользователя должны быть права администратора в информационной базе.

Обязательно создайте резервную копию базы до установки. Для файловой базы достаточно скопировать каталог с файлом 1Cv8.1CD или выгрузить базу в .dt через конфигуратор. Для клиент-серверной базы используйте средства СУБД или выгрузку .dt. Хотя расширение формально не меняет конфигурацию, его код исполняется в базе и может изменить данные.

Установка через пользовательский режим

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

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

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

Установка через конфигуратор

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

В открывшемся списке нажмите «Создать» (или «Добавить»), затем в окне нового расширения используйте команду «Конфигурация → Загрузить из файла» и укажите CFE-файл. Задайте имя и префикс расширения, снимите при необходимости флажки «Безопасный режим» и «Защита от опасных действий», если разработчик этого требует. Сохраните расширение и обновите конфигурацию базы данных (F7), если платформа это запросит.

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

Проверка результата

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

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

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

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

Строка расширения в списке

Норма

Расширение активно, ошибок нет

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

Статус «не подключено» или значок ошибки

Перезапуск сеанса

Норма

Сеанс перезапущен после загрузки

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

Функциональность не появилась — сеанс не перезапускался

Работа доработанной функции

Норма

Отчёт/форма открываются и дают ожидаемый результат

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

Ошибка при открытии или неверные данные

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

Норма

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

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

Повторяющиеся ошибки вызова методов расширения

Типичные ошибки при установке

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

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

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

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

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

Маршрут решения

Как выбрать действие

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

Источник файла неизвестенСначала разверните копию базы и проверьте расширение там

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

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

Частые вопросы

Чем CFE отличается от EPF и ERF?

CFE — расширение конфигурации, подключается на уровне метаданных и меняет поведение конфигурации. EPF (внешняя обработка) и ERF (внешний отчёт) — отдельные исполняемые файлы, которые запускаются как самостоятельные объекты и не изменяют конфигурацию. Для постоянной доработки типовых механизмов используют CFE, для разовых операций — внешние обработки.

Можно ли установить CFE в базовую версию 1С?

Нет. Базовые версии конфигураций не поддерживают расширения и внешние доработки — это ограничение лицензионной политики платформы. Для использования расширений нужна версия ПРОФ или КОРП.

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

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

Что делать, если пункт «Расширения» не виден в меню?

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

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

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