К статье
Практический материал

Разработка и Конфигурация · 9 мин

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

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

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

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

Ниже разобраны рабочие способы выгрузки, условия их применения, проверка результата и ошибки, которые чаще всего мешают сохранить расширение корректно.

Что нужно проверить перед выгрузкой

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

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

Также проверьте версию платформы. Механизм расширений появился в платформе 8.3.6, а полноценная работа со списком расширений и сохранением в файл стабильно доступна начиная с 8.3.8 и новее. На более старых релизах часть описанных команд может отсутствовать.

Сохранение расширения через конфигуратор

Это основной и самый надёжный способ, доступный на любой актуальной версии платформы.

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

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

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

Выгрузка расширения через командную строку

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

bash
"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 и выгрузка из конфигуратора не всегда дают идентичный результат, если проект в рабочей области расходится с версией, загруженной в базу. Перед выгрузкой синхронизируйте проект с информационной базой, чтобы файл отражал актуальное состояние доработки.

Сравнение способов выгрузки

Конфигуратор

Подходит для разового сохранения и ручной работы. Не требует подготовки, но не автоматизируется.

Командная строка

Подходит для регулярного резервного копирования и скриптов. Требует точного указания параметров и прав на запуск.

1C:EDT

Подходит, если разработка ведётся в EDT. Требует синхронизации проекта с базой перед экспортом.

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

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

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

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

Файл создан
Норма

Файл .cfe существует, размер соответствует объёму доработки

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

Файл отсутствует или имеет нулевой размер

Загрузка в тестовую базу
Норма

Расширение загружается без ошибок и появляется в списке

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

Ошибка «файл не является расширением конфигурации» или ошибки применения

Работоспособность
Норма

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

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

Объекты не открываются, ошибки совместимости с версией конфигурации

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

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

Типичные ошибки
01
Неверное имя расширения в командной строке — команда завершается ошибкой, файл не создаётся
02
Попытка загрузить .cfe в базу с другой версией конфигурации без проверки — расширение не применяется из-за изменившихся заимствованных объектов
03
Сохранение через EDT без синхронизации проекта — файл содержит устаревшую версию доработки
04
Отсутствие резервной копии перед загрузкой — при ошибке применения приходится восстанавливать базу вручную
05
Выгрузка не того расширения из списка — в файле оказывается чужая доработка с похожим именем

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

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

Итог

Что важно запомнить

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

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

Чем файл .cfe отличается от файла .cf?

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

Можно ли сохранить расширение, если оно отключено?

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

Как сохранить сразу все расширения базы?

Через интерфейс конфигуратора — только по одному: выделяйте каждое расширение и сохраняйте в отдельный файл. Для массовой выгрузки используйте командную строку, последовательно выполняя /DumpCfgExtensionToFile для каждого имени расширения в скрипте.

Почему при загрузке .cfe возникает ошибка «не является расширением конфигурации»?

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

Сохраняются ли в файл настройки безопасного режима расширения?

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

Можно ли открыть .cfe и посмотреть код без базы?

Напрямую — нет, это бинарный формат платформы. Чтобы просмотреть содержимое, загрузите файл в любую тестовую базу через конфигуратор или импортируйте расширение как проект в 1C:EDT.