Как установить файл CFE в 1С

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

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

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

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

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

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

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

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

Установка CFE в режиме «Предприятие»

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

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

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

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

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

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

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

"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /S"Server\Base" /N"Администратор" /P"пароль" /LoadCfgExtensionFiles "C:\Ext\MyExt.cfe" -Extension MyExt /UpdateDBCfg

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

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

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

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

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

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

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

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

Чтобы обновить расширение до новой версии, откройте список расширений, удалите старое или загрузите новую версию поверх (в зависимости от режима установки), затем перезапустите сеанс. В конфигураторе обновление выполняется повторной загрузкой из файла с заменой существующего расширения с тем же именем.

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

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