Разработка и Конфигурация · 9 мин
Как сохранить расширение конфигурации 1С 8.3 в файл
Пошаговая инструкция: как выгрузить расширение конфигурации 1С 8.3 в файл .cfe через конфигуратор, командную строку и EDT. Проверка результата и типичные ошибки.
Расширение конфигурации в 1С 8.3 хранится непосредственно в информационной базе, а не в виде отдельного файла на диске. Поэтому для переноса доработки на другую базу, отправки коллеге или резервного копирования расширение нужно выгрузить в файл с расширением .cfe. Платформа предоставляет для этого несколько способов: через конфигуратор, пакетный режим командной строки и среду разработки EDT.
Файл .cfe содержит всю структуру расширения: заимствованные объекты, изменённые формы, собственные роли, макеты и код модулей. При этом данные информационной базы в файл не попадают — выгружается только описание доработки. Это делает файл компактным и безопасным для передачи.
Ниже разобраны рабочие способы выгрузки, условия их применения, проверка результата и ошибки, которые чаще всего мешают сохранить расширение корректно.
Что нужно проверить перед выгрузкой
Перед сохранением убедитесь, что расширение находится в рабочем состоянии. Откройте список расширений через меню «Конфигурация → Расширения конфигурации» и проверьте, что нужное расширение присутствует, подключено (флажок установлен) и не отмечено признаками ошибок применения.
Для работы потребуются права администратора информационной базы и запуск конфигуратора под пользователем, у которого есть право изменения конфигурации. Если база работает в клиент-серверном режиме, желательно дождаться завершения активных сеансов или выполнять выгрузку в период минимальной нагрузки — при изменениях структуры платформа может потребовать монопольный доступ.
Также проверьте версию платформы. Механизм расширений появился в платформе 8.3.6, а полноценная работа со списком расширений и сохранением в файл стабильно доступна начиная с 8.3.8 и новее. На более старых релизах часть описанных команд может отсутствовать.
Сохранение расширения через конфигуратор
Это основной и самый надёжный способ, доступный на любой актуальной версии платформы.
- 1Запустите конфигуратор нужной информационной базы
- 2Откройте меню «Конфигурация → Расширения конфигурации»
- 3В списке найдите нужное расширение и выделите его строку
- 4Нажмите кнопку «Сохранить в файл» на панели инструментов окна
- 5Укажите папку и имя файла, убедитесь, что тип файла — «Расширение конфигурации (*.cfe)»
- 6Нажмите «Сохранить» и дождитесь завершения операции
После нажатия «Сохранить» платформа формирует файл, в который входят все объекты расширения. Время выгрузки зависит от объёма доработки: небольшое расширение с парой форм сохраняется за секунды, крупное — до нескольких минут.
Если кнопка «Сохранить в файл» неактивна, проверьте, что расширение выделено именно в списке (курсор стоит на его строке), а конфигуратор запущен не в режиме «только чтение». Также убедитесь, что конфигурация базы не находится на поддержке с запретом изменений в части, затрагивающей расширение, — впрочем, на само сохранение расширения это обычно не влияет, блокировка чаще связана с правами текущего пользователя.
Выгрузка расширения через командную строку
Пакетный режим удобен для автоматизации: регулярного резервного копирования расширений по расписанию или интеграции в конвейер сборки. Запуск выполняется через исполняемый файл конфигуратора с параметрами.
"C:\Program Files\1cv8\8.3.22.1750\bin\1cv8.exe" DESIGNER /F"D:\Bases\Trade" /N"Администратор" /P"пароль" /DumpCfgExtensionToFile "D:\Backup\MyExtension.cfe" -Extension "МоеРасширение"Ключевые параметры команды: DESIGNER — запуск конфигуратора, /F — путь к файловой базе (для серверной используйте /S с адресом сервера и именем базы), /DumpCfgExtensionToFile — команда выгрузки, -Extension — имя расширения точно так, как оно указано в свойствах.
Имя расширения чувствительно к регистру и пробелам — скопируйте его из списка расширений, а не вводите вручную по памяти. Если имя указано неверно, команда завершится с ошибкой, и файл создан не будет. Для диагностики добавьте параметр /Out с путём к файлу журнала — туда попадёт текст ошибки.
Сохранение расширения из 1C:EDT
Если разработка ведётся в 1C:Enterprise Development Tools, расширение существует как проект в рабочей области. Выгрузка в файл .cfe выполняется через экспорт проекта.
В навигаторе проектов выделите проект расширения, откройте контекстное меню и выберите экспорт в файл конфигурации. В мастере укажите, что экспортируется расширение, задайте путь и имя файла. EDT соберёт проект и сформирует .cfe, который затем можно загрузить в целевую базу стандартным способом.
Учтите, что экспорт из EDT и выгрузка из конфигуратора не всегда дают идентичный результат, если проект в рабочей области расходится с версией, загруженной в базу. Перед выгрузкой синхронизируйте проект с информационной базой, чтобы файл отражал актуальное состояние доработки.
Сравнение способов выгрузки
Подходит для разового сохранения и ручной работы. Не требует подготовки, но не автоматизируется.
Подходит для регулярного резервного копирования и скриптов. Требует точного указания параметров и прав на запуск.
Подходит, если разработка ведётся в EDT. Требует синхронизации проекта с базой перед экспортом.
Проверка результата и загрузка обратно
После сохранения убедитесь, что файл корректен. Минимальная проверка — размер файла: пустой или аномально маленький файл (единицы килобайт при крупной доработке) — признак сбоя. Надёжнее выполнить контрольную загрузку в тестовую копию базы.
Как проверить результат
Файл .cfe существует, размер соответствует объёму доработки
Файл отсутствует или имеет нулевой размер
Расширение загружается без ошибок и появляется в списке
Ошибка «файл не является расширением конфигурации» или ошибки применения
Формы и код расширения работают в тестовой базе
Объекты не открываются, ошибки совместимости с версией конфигурации
Загрузка выполняется в том же окне «Расширения конфигурации» кнопкой «Загрузить из файла». После загрузки расширение нужно подключить и при необходимости перезапустить сеанс. Если целевая конфигурация отличается версией от исходной, платформа может потребовать обновления расширения — заимствованные объекты проверяются на соответствие текущей структуре метаданных.
Типичные ошибки и ограничения
Отдельное ограничение касается безопасного режима и профилей безопасности. Если расширение использует привилегированные операции, при загрузке в базу с действующими профилями безопасности оно может не примениться до явного разрешения администратора. Это не ошибка выгрузки — файл при этом корректен.
Также помните, что расширения, подключённые через хранилище расширений или распространяемые поставщиком, могут иметь ограничения на изменение, но сохранение в файл обычно доступно в любом случае.
Что важно запомнить
Расширение сохраняется в файл .cfe через список расширений в конфигураторе кнопкой «Сохранить в файл», либо пакетной командой /DumpCfgExtensionToFile. Перед загрузкой файла в другую базу проверяйте его на тестовой копии и делайте резервную копию данных.
Частые вопросы
Чем файл .cfe отличается от файла .cf?
Файл .cf содержит полную конфигурацию целиком, а .cfe — только расширение: заимствованные и собственные объекты доработки. Загрузить .cfe как основную конфигурацию нельзя, он применяется только поверх существующей конфигурации.
Можно ли сохранить расширение, если оно отключено?
Да. Сохранение в файл доступно независимо от того, подключено расширение или нет — важно лишь, чтобы оно присутствовало в списке расширений базы.
Как сохранить сразу все расширения базы?
Через интерфейс конфигуратора — только по одному: выделяйте каждое расширение и сохраняйте в отдельный файл. Для массовой выгрузки используйте командную строку, последовательно выполняя /DumpCfgExtensionToFile для каждого имени расширения в скрипте.
Почему при загрузке .cfe возникает ошибка «не является расширением конфигурации»?
Чаще всего файл повреждён при передаче (например, обрезан при копировании) или это вообще другой тип файла с переименованным расширением. Проверьте размер файла и повторите выгрузку из исходной базы.
Сохраняются ли в файл настройки безопасного режима расширения?
Да, свойства расширения, включая признак использования в безопасном режиме и префикс имён, входят в состав файла .cfe и восстанавливаются при загрузке.
Можно ли открыть .cfe и посмотреть код без базы?
Напрямую — нет, это бинарный формат платформы. Чтобы просмотреть содержимое, загрузите файл в любую тестовую базу через конфигуратор или импортируйте расширение как проект в 1C:EDT.