Как выгрузить расширение конфигурации в файл в 1С 8.3

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

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

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

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

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

Подготовка: что проверить перед выгрузкой

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

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

Как выгрузить расширение в файл через конфигуратор

Основной способ выгрузки — через интерфейс конфигуратора. Последовательность одинакова для файловых и клиент-серверных баз.

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

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

После сохранения рекомендуется сразу дать файлу осмысленное имя с указанием версии, например Доработки_Реализации_1.2.3.cfe. Это избавит от путаницы, когда файлов накопится несколько.

Как загрузить расширение из файла в другую базу

Загрузка выполняется в том же окне «Расширения конфигурации», но уже в целевой базе. Нажмите кнопку «Загрузить из файла», выберите файл .cfe и подтвердите операцию. Платформа добавит расширение в список, после чего его нужно активировать — снять флажок «Безопасный режим», если расширение содержит код, которому вы доверяете, и убедиться, что флажок «Используется» установлен.

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

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

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

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

Выгрузка через пакетный режим и командную строку

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

"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /F"D:\Bases\MyBase" /N"Администратор" /DumpConfigExtensionToFile "D:\Backup\MyExt.cfe" -Extension "МоеРасширение"

Ключ -Extension задаёт имя расширения точно так, как оно указано в списке расширений конфигурации. Для загрузки из файла используется аналогичная команда /LoadConfigExtensionFromFile. Имена параметров и их поддержку стоит сверять с документацией по вашей версии платформы, так как синтаксис может отличаться.

Типичные ошибки и ограничения

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

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