Загрузка файла .cfe в базу 1С: три способа и разбор сбоев

Вам прислали файл с окончанием .cfe, и нужно «поставить расширение в 1С». Быстрее всего это делается в режиме Предприятия: Администрирование → Печатные формы, отчёты и обработки → Расширения, кнопка добавления из файла. Если этого раздела в вашей конфигурации нет, остаются Конфигуратор и командная строка. Все три способа ниже.

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

Что проверить до загрузки файла

Пять минут проверки экономят вечер разбирательств. Сделайте это до любых кнопок.

• 💾 Копия базы. Выгрузите информационную базу в .dt или сделайте копию файла 1Cv8.1CD для файловой базы. Расширение может изменить структуру данных, откатить это руками сложно.
• 🔑 Права. Нужна роль с полными правами или административный доступ в Конфигураторе. У обычного пользователя кнопок не будет.
• 🧩 Совместимость. Расширение делают под конкретную конфигурацию, а часто и под диапазон её релизов. Уточните у разработчика, для какой конфигурации и версии оно собрано.
• 🖥 Платформа. Расширения поддерживаются с 8.3.6. Если платформа старше, расширение не загрузится. Номер платформы смотрите в Справка → О программе.
• 👥 Время. Загрузка и применение могут потребовать перезапуска сеансов. Выбирайте момент, когда в базе никто не работает .

Как понять, подойдёт ли файл вашей базе

Сам файл .cfe не покажет, под что он собран, пока вы его не загрузили. Поэтому задайте автору три вопроса:

• Для какой конфигурации сделано расширение: Бухгалтерия предприятия, ЗУП, Управление торговлей?
• На какой релиз конфигурации оно проверялось и работает ли на более новых?
• Какую минимальную версию платформы оно требует?

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

Способ 1. Загрузка из режима Предприятия

Самый безопасный для пользователя способ: не нужен Конфигуратор и не нужен доступ к серверу. Он работает во всех конфигурациях, где подключена библиотека стандартных подсистем (БСП): Бухгалтерия, ЗУП, УТ и других типовых.

1. Запустите базу в режиме 1С:Предприятие под пользователем с полными правами.
2. Откройте Администрирование → Печатные формы, отчёты и обработки → Расширения.
3. Нажмите кнопку добавления расширения из файла и выберите .cfe в окне диалога.
4. Система покажет предупреждение о рисках. Прочтите его и подтвердите.
5. Дождитесь завершения. Платформа перезапустит сеанс, и новые возможности появятся после повторного входа.

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

Флажки безопасности

У каждого расширения есть настройки, которые определяют, что ему можно:

Способ 2. Установка через Конфигуратор

Нужен, когда БСП нет, когда база нестандартная или когда расширение нужно разворачивать вместе с отладкой.

1. Откройте базу в Конфигураторе: кнопка Конфигуратор в списке баз.
2. Откройте список расширений: Конфигурация → Расширения конфигурации.
3. Добавьте новое расширение — программа создаст пустое.
4. Загрузите в него содержимое файла .cfe командой загрузки конфигурации из файла, предварительно выбрав это расширение. Для расширения выбирайте именно файл .cfe, а не .cf.
5. Примените изменения к базе данных: Конфигурация → Обновить конфигурацию базы данных (клавиша F7).

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

Расширение, загруженное через Конфигуратор, заводится в тот же список, что и загруженное из Предприятия. Разницы после загрузки нет.

Установка в клиент-серверной базе (SQL)

Для базы на сервере 1С и SQL-сервере принципиально ничего не меняется: расширение хранится в самой информационной базе, а не в файлах на диске.

Что стоит учесть:

• Операции выполняются под пользователем, у которого есть доступ к базе, а не под учётной записью SQL. Права на SQL-сервере не меняйте.
• Применение к базе данных на сервере занимает больше времени, чем в файловом варианте. Не прерывайте процесс, даже если окно «зависло».
• Пока идёт применение, другие пользователи могут получить сообщения о необходимости перезапуска. Предупредите их заранее.
• Перед загрузкой сделайте не только выгрузку .dt, но и резервную копию SQL-базы средствами СУБД. Выгрузка восстановит данные, а бэкап СУБД даёт быстрый откат всей базы.

Как отключить, обновить и удалить расширение

Список расширений находится там же, где вы их добавляли. Для каждого есть три сценария.

Временно выключить

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

Обновить до новой версии

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

Удалить

Выберите расширение в списке и удалите его. Данные, которые расширение создало (например, реквизиты и справочники), могут остаться в базе. Если в расширении были собственные объекты метаданных, судьбу данных обсудите с разработчиком до удаления.

Что делать, если расширение мешает работе

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

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

Такой порядок защищает от поспешных решений: отключение обратимо за секунду, удаление нет.

Автоматизация: загрузка расширения из командной строки

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

Загрузка файла в расширение с указанным именем:

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe" DESIGNER /F "D:\bases\test" /N "Администратор" /P "пароль" /LoadCfg "D:\ext\MyExt.cfe" -Extension "МоеРасширение" /UpdateDBCfg -Extension "МоеРасширение" /Out "D:\ext\log.txt"

Что здесь важно:

• 8.3.xx.xxxx замените на реальный номер каталога платформы;
• /F задаёт путь к файловой базе, для серверной базы используется параметр /S в формате сервер\база;
• -Extension указывает имя расширения, к которому относится команда;
• /Out пишет результат в файл: по нему скрипт понимает, успешна ли операция.

Пароль в командной строке виден в списке процессов. Для рабочих серверов храните учётные данные в защищённом хранилище скрипта и ограничьте доступ к самому скрипту.

Выбор способа

Как убедиться, что расширение встало правильно

Загрузка без ошибок ещё не значит, что всё работает. Пройдите короткую проверку.

1. Откройте список расширений и найдите новую строку. Название и версия должны совпадать с теми, что указал автор.
2. Убедитесь, что расширение активно, а режим безопасности выставлен так, как вы решили.
3. Перезапустите клиент и откройте тот объект, который расширение должно менять: документ, отчёт, обработку.
4. Выполните одну типовую операцию вручную. Например, проведите тестовый документ и посмотрите, нет ли сообщений об ошибке.
5. Если расширение должно добавлять реквизиты или команды, сравните форму до и после. Для этого удобно держать рядом копию базы без расширения.

Отдельно посмотрите журнал регистрации: Администрирование → Обслуживание → Журнал регистрации в большинстве типовых конфигураций. Сообщения об ошибках сразу после загрузки покажут, какой модуль расширения не прошёл проверку.

Выгрузка расширения в файл

Иногда нужна обратная операция: у вас уже есть работающее расширение, и его требуется перенести в другую базу. В Конфигураторе откройте Конфигурация → Расширения конфигурации, выберите нужное расширение и выгрузите его в файл с окончанием .cfe. Этот же файл потом загружается любым из трёх способов выше.

Полезные правила переноса:

• 📦 выгружайте файл из базы, в которой расширение уже проверено, а не из рабочей;
• 🏷 в имени файла указывайте версию расширения и релиз конфигурации, под который оно собрано;
• 🗂 храните прежние версии файлов: откат к предыдущей версии займёт минуту, а не час.

Если расширение не загружается или не работает

Типичные сбои, которых нет в основной инструкции.

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