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

В типовых конфигурациях (БП 3.0, ЗУП 3.1, УТ 11) расширение добавляют из файла через Администрирование → Печатные формы, отчеты и обработки → Расширения, кнопка Добавить из файла и выбор файла .cfe. После загрузки 1С попросит перезапустить программу, и расширение начнёт работать. Второй путь — Конфигуратор: Конфигурация → Расширения конфигурации, загрузка из файла и обновление конфигурации базы данных.

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

Что проверить перед загрузкой расширения

Большая часть неудач при добавлении расширения возникает до нажатия кнопки. Проверьте пять вещей.

• 👤 Права пользователя. Добавлять и удалять расширения может пользователь с полными правами (роль «Полные права» или «Администратор системы» в типовых). У обычного бухгалтера кнопки добавления просто не будет или появится сообщение о нехватке прав.
• 🧩 Версия платформы. Файл .cfe сохраняют в определённом режиме совместимости. Если расширение собрано на платформе с номером выше вашей, база его не откроет. Номер платформы смотрите в окне Справка → О программе.
• 📄 Релиз конфигурации. Расширение пишут под конкретный релиз. Если оно меняет типовые формы или модули, а у вас другой релиз, применение может не пройти.
• 🔐 Источник файла. Расширение исполняет код внутри вашей базы. Берите файлы только у разработчика, которому доверяете, или у своего программиста.
• 💾 Резервная копия. Расширения, которые добавляют реквизиты и таблицы, меняют структуру данных. Перед загрузкой такого расширения в рабочую базу сделайте выгрузку .dt или копию каталога файловой базы.

Отдельно о монопольном режиме. Для добавления расширения в режиме Предприятия выгонять пользователей обычно не нужно. Но если расширение меняет структуру данных, лучше делать это вне рабочего времени: остальным пользователям всё равно потребуется перезапуск, чтобы увидеть изменения.

Как добавить расширение из файла в режиме Предприятия

Это основной способ для бухгалтера и администратора без навыков программирования. Конфигуратор не нужен.

Пути в типовых конфигурациях

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

Пошагово

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

После перезапуска новые команды, печатные формы или реквизиты появятся там, куда их встроил разработчик. Обычно это описано в инструкции к расширению.

Как обновить уже загруженное расширение

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

Если удалить старое и добавить новое, данные из таблиц расширения могут пропасть вместе с удалением.

Подключение расширения через Конфигуратор

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

Загрузка в окне «Расширения конфигурации»

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

Не перепутайте файлы .cfe и .cf

Самая неприятная ошибка в Конфигураторе — загрузить расширение не туда. Команда Конфигурация → Загрузить конфигурацию из файла в главном меню (вне окна расширений) работает с основной конфигурацией и ждёт файл .cf.

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

Расширения в Конфигураторе живут отдельно от основной конфигурации. Загрузка .cfe в окне расширения не трогает основную конфигурацию и не снимает её с поддержки.

Загрузка из командной строки

Для пакетных обновлений нескольких баз пригодится запуск в пакетном режиме. Ключи /LoadCfg и /UpdateDBCfg с параметром -Extension работают с конкретным расширением:

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER ^
  /F "D:\Bases\Buh" /N "Администратор" /P "пароль" ^
  /LoadCfg "D:\Ext\MoeRasshirenie.cfe" -Extension "МоеРасширение" ^
  /UpdateDBCfg -Extension "МоеРасширение" ^
  /Out "D:\Ext\log.txt"

Подставьте номер своей платформы в путь. Для клиент-серверной базы вместо /F используйте /S "сервер\база". Итог операции смотрите в файле, указанном после /Out.

Какой способ выбрать

Как настроить видимость команд и права на расширение

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

Роли расширения

Расширение может принести свои роли. Пока роль не назначена пользователю, его объекты для этого пользователя закрыты.

• 🧑‍💼 В типовых конфигурациях на БСП роли назначают через Администрирование → Настройки пользователей и прав → Группы доступа или профили групп доступа. Роли расширения появляются в профиле после его загрузки.
• ⚙️ У самого расширения есть свойство «Использовать основные роли для всех пользователей». Если разработчик его включил, основные роли расширения выдаются всем автоматически. Свойство видно в палитре свойств расширения в Конфигураторе.

Безопасный режим и защита от опасных действий

В списке расширений есть флажки «Безопасный режим» и «Защита от опасных действий».

• 🛡️ Безопасный режим запрещает расширению работу с файлами, внешними компонентами, COM-объектами и запуск программ. Это правильная настройка для расширения из непроверенного источника.
• 🌐 Если расширение должно обмениваться данными с внешним сервисом или читать файлы, в безопасном режиме оно выдаст ошибку. Снимайте флажок только для расширения, которому доверяете, и только по требованию разработчика.
• ⚠️ Защита от опасных действий показывает предупреждения при попытке расширения выполнить потенциально опасную операцию. Отключать её без причины не стоит.

Где появятся новые команды

Расширение может добавить команды в разделы, в формы документов, в подменю «Печать» или «Создать на основании». Если команду в форме не видно, откройте Ещё → Изменить форму и проверьте, не скрыта ли она. В панели разделов проверьте Сервис и настройки → Настройка → Панель разделов.

Почему расширение не загружается или не применяется

Несколько случаев требуют отдельного комментария.

Конфликт двух расширений. Если два расширения меняют один и тот же модуль или форму, порядок их применения влияет на результат. Временно снимите флажок «Активно» у одного из них и проверьте, ушла ли ошибка.

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

Зависший кэш. Изредка после замены расширения клиент показывает старые формы. Помогает запуск с ключом /ClearCache. Кэш очищается только у того пользователя и на том компьютере, где запущен клиент, на сеансы других пользователей это не влияет.

Безопасность и учёт версий расширений

Расширение — полноценный код в вашей базе. Относитесь к нему как к программе, которую устанавливаете на сервер.

Правила безопасной установки

• 🔍 Загружайте сначала в копию базы. Проверьте ключевые операции: проведение документов, печать, закрытие месяца, если расширение их затрагивает.
• 🛡️ Оставляйте безопасный режим включённым, если разработчик не объяснил, зачем его снимать.
• 👥 Не давайте права на добавление расширений рядовым пользователям. Полные права — только у администратора.
• 📋 Ведите список установленных расширений: название, версия, автор, дата загрузки, что меняет.

Как вести версии

У каждого расширения есть свойство «Версия», его заполняет разработчик. Номер видно в списке расширений. Сверяйте его с версией в файле, который вам прислали.

Храните предыдущие файлы .cfe в отдельной папке с датой в имени, например Rasshirenie_v1.4_2026-09-15.cfe. Если новая версия сломает работу, вы откатитесь загрузкой прежнего файла поверх текущего.

Сохранить текущее расширение из базы в файл можно двумя путями:

• в режиме Предприятия: выделите расширение в списке и найдите команду сохранения в файл;
• в Конфигураторе: в окне расширения Конфигурация → Сохранить конфигурацию в файл.

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