Разработка и Конфигурация · 10 мин
1С: как сохранить расширение в файл
Как выгрузить расширение конфигурации 1С в файл через конфигуратор и режим предприятия, чем отличаются форматы CFE и CFEP, какие ошибки возникают и как их избежать.
Расширение конфигурации в 1С часто нужно перенести из одной базы в другую, отправить разработчику или сохранить как резервную копию перед обновлением. Для этого платформа предусматривает сохранение расширения в файл — операцию, доступную как в конфигураторе, так и в пользовательском режиме «1С:Предприятие».
Расширение сохраняется в файл с расширением .cfe. Такой файл содержит все доработки: изменённые формы, добавленные реквизиты, печатные формы, обработчики событий, — но не содержит саму конфигурацию поставщика. Поэтому файл .cfe обычно компактен и его удобно передавать.
Ниже разобраны все рабочие способы выгрузки расширения: через конфигуратор, через пользовательский интерфейс, пакетным запуском, а также типичные ошибки и способы проверки результата.
Что такое файл расширения и когда он нужен
Расширение конфигурации — это механизм доработки типовой конфигурации без снятия её с поддержки. Все изменения хранятся отдельно от основной конфигурации, что позволяет обновлять программу штатно, не теряя доработки. При сохранении в файл расширение упаковывается в контейнер .cfe.
Файл .cfe нужен в нескольких типовых ситуациях: перенос доработки из тестовой базы в рабочую, передача расширения подрядчику или коллеге, резервное копирование перед обновлением конфигурации, хранение версий расширения в системе контроля версий. Также выгрузка в файл — единственный способ забрать расширение из базы, где нет доступа к конфигуратору (например, в некоторых облачных сервисах).
Важно понимать: файл .cfe не является самодостаточной конфигурацией. Он применим только к базе с совместимой основной конфигурацией. Если расширение изменяет объекты, которых нет в целевой конфигурации, при загрузке возникнут ошибки применимости.
Сохранение расширения через конфигуратор
Основной способ для разработчика и администратора — выгрузка через конфигуратор. Потребуется пользователь с правами администратора и монопольный доступ к базе не нужен: операция выполняется при работающих пользователях.
Порядок действий: запустите конфигуратор нужной информационной базы, откройте меню «Конфигурация» и выберите пункт «Расширения конфигурации». В открывшемся окне отобразится список всех расширений, подключённых к базе, с признаками активности и безопасного режима.
Выделите строку с нужным расширением и нажмите кнопку «Сохранить в файл» на командной панели окна (или выберите аналогичный пункт в контекстном меню). Укажите каталог и имя файла — платформа по умолчанию предложит имя, совпадающее с именем расширения, и расширение .cfe. Дождитесь завершения выгрузки: для больших расширений это может занять заметное время.
- 1Откройте базу в конфигураторе под пользователем с правами администратора
- 2Перейдите: Конфигурация → Расширения конфигурации
- 3Выделите нужное расширение в списке
- 4Нажмите «Сохранить в файл» и укажите путь и имя файла .cfe
- 5Дождитесь окончания выгрузки и проверьте наличие файла в указанном каталоге
Сохранение расширения в режиме «1С:Предприятие»
Если доступа к конфигуратору нет — например, база работает в облачном сервисе или права ограничены, — расширение можно сохранить из пользовательского режима. Эта возможность доступна пользователям с правами администратора в типовых конфигурациях на управляемых формах.
Путь в типовых конфигурациях: раздел «Администрирование» → «Печатные формы, отчеты и обработки» → «Расширения». Если пункт «Расширения» не виден, проверьте, что включена функциональность «Дополнительные отчеты и обработки» и что у пользователя есть соответствующие права. В некоторых конфигурациях список расширений находится в разделе «НСИ и администрирование».
В открывшемся списке выделите расширение и нажмите «Сохранить в файл» (или используйте меню «Ещё»). Браузер или тонкий клиент предложит выбрать место сохранения. В веб-клиенте файл скачивается через механизм загрузки файлов браузера.
Выгрузка расширения пакетным запуском и из командной строки
Для автоматизации — например, регулярного резервного копирования расширений — используется пакетный запуск конфигуратора с параметром выгрузки расширения. Это удобно в скриптах обслуживания и в конвейерах CI/CD.
Команда запускается с ключом конфигуратора и специальными параметрами, указывающими имя расширения и путь к файлу. Точный синтаксис зависит от версии платформы, поэтому перед использованием сверьтесь с документацией установленной версии.
"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /F"C:\Bases\MyBase" /N"Администратор" /P"пароль" /DumpCfgExtensionToFile "C:\Backup\MyExt.cfe" -Extension "ИмяРасширения"При автоматизации учитывайте: если имя расширения содержит пробелы или кириллицу, заключайте его в кавычки; путь к файлу должен быть доступен учётной записи, от имени которой выполняется скрипт; код возврата процесса стоит проверять, чтобы не принять сбойную выгрузку за успешную.
Как проверить, что файл сохранился корректно
После выгрузки не ограничивайтесь визуальной проверкой наличия файла. Файл нулевого размера или обрыв операции — признак сбоя. Надёжная проверка — загрузить сохранённый .cfe в тестовую копию базы и убедиться, что расширение подключается без ошибок и доработки работают.
Дополнительный контроль: сравните версию расширения в файле с версией в исходной базе (свойство «Версия» в списке расширений), а также проверьте журнал регистрации на наличие ошибок в момент выгрузки.
Как проверить результат
Файл имеет ненулевой размер, сопоставимый со сложностью расширения
Файл отсутствует или его размер равен нулю
Расширение загружается, подключается и проходит контроль применимости
При загрузке появляются ошибки применимости или расширение не активируется
Изменённые формы, печатные формы и обработчики работают как в исходной базе
Доработки отсутствуют или вызывают ошибки при открытии объектов
Типичные ошибки и ограничения
Частая проблема — отсутствие кнопки «Сохранить в файл» или её недоступность. Причины: у пользователя нет прав администратора, расширение подключено в разделенном режиме с ограничениями, либо в облачном сервисе выгрузка расширений запрещена настройками. Решение — проверить роль пользователя и условия сервиса.
Вторая распространённая ситуация — сохранённый файл не загружается в другую базу с ошибкой применимости. Это означает, что расширение ссылается на объекты, которых нет в целевой конфигурации, либо версии конфигураций существенно различаются. Перед переносом выровняйте версии конфигураций в обеих базах.
Отдельное ограничение: расширения, подключённые из хранилища расширений или установленные сервисом, могут быть защищены от выгрузки. В этом случае файл получить штатно нельзя — обращайтесь к поставщику расширения.
Чем сохранение в файл отличается от других способов переноса
Файл .cfe — не единственный способ перенести доработки. Альтернативы: выгрузка всей конфигурации вместе с расширениями в .cf (не рекомендуется для типовых, так как ломает поддержку), хранилище конфигурации, сравнение и объединение с файлом расширения, а также механизм поставки расширений.
Сравнение вариантов переноса
Универсальный способ: подходит для переноса, резервных копий и передачи третьим лицам. Ограничение — требует совместимой конфигурации в целевой базе
Подходит для командной разработки с историей версий. Избыточно для разового переноса одного расширения
Переносит всё сразу, но снимает типовую конфигурацию с полной поддержки — для типовых решений применять не рекомендуется
FAQ
Какое расширение имеет файл расширения 1С?
Файл расширения конфигурации имеет расширение .cfe. Не путайте его с .cf (файл конфигурации) и .dt (выгрузка информационной базы) — это разные форматы с разным назначением.
Можно ли сохранить расширение без доступа к конфигуратору?
Да. В режиме «1С:Предприятие» откройте «Администрирование» → «Печатные формы, отчеты и обработки» → «Расширения», выделите расширение и нажмите «Сохранить в файл». Нужны права администратора в базе.
Почему сохранённый файл не загружается в другую базу?
Чаще всего из-за ошибок применимости: расширение изменяет объекты, отсутствующие или переименованные в целевой конфигурации. Приведите конфигурации обеих баз к близким версиям и повторите загрузку, либо исправьте расширение под целевую конфигурацию.
Сохраняются ли данные вместе с расширением?
Нет. Файл .cfe содержит только метаданные и программный код доработок. Данные, введённые в добавленные расширением реквизиты, в файл не попадают — для их переноса нужны отдельные средства выгрузки данных.
Можно ли сохранить несколько расширений одним файлом?
Штатно каждое расширение сохраняется в отдельный файл .cfe. Если расширений много, выгружайте их по очереди или автоматизируйте процесс пакетным запуском конфигуратора в скрипте.
Что делать, если кнопка «Сохранить в файл» недоступна?
Проверьте права пользователя (нужны административные), убедитесь, что расширение не защищено поставщиком или условиями облачного сервиса, и попробуйте выгрузку через конфигуратор. Если расширение установлено сервисом, файл можно получить только у поставщика.
Что важно запомнить
Расширение 1С сохраняется в файл .cfe через конфигуратор (Конфигурация → Расширения конфигурации) или из режима предприятия (Администрирование → Расширения). Перед переносом проверяйте файл загрузкой в тестовую базу, учитывайте совместимость версий конфигураций и всегда имейте резервную копию рабочей базы.