Расширение .cfe в рабочей базе: установка, настройка, обновление и отключение

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

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

Что даёт расширение и почему его не путают с доработкой конфигурации

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

Что умеет расширение:

• 🧩 добавлять свои отчёты, обработки, печатные формы, роли и общие модули;
• 🔧 менять формы типовых объектов: добавлять поля, кнопки, команды;
• 🪝 перехватывать типовые процедуры аннотациями &Перед, &После, &Вместо и &ИзменениеИКонтроль;
• 🗃️ с платформы 8.3.11 — добавлять собственные справочники, документы и регистры с данными, а также реквизиты к типовым объектам.

Главный плюс для администратора: типовое обновление конфигурации ставится без ручного сравнения и объединения. Расширение просто применяется заново к новой версии. Если перехваченный метод или заимствованный объект не изменился — всё работает дальше.

Назначение расширения

У каждого расширения есть свойство «Назначение». От него зависит порядок применения:

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

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

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

1. Сделайте резервную копию. Для файловой базы — копию каталога или выгрузку .dt, для клиент-серверной — бэкап средствами СУБД. Расширение с собственными данными при удалении удаляет и эти данные — откатиться можно будет только из копии.
2. Проверьте источник файла. Файл .cfe — это исполняемый код. Ставьте только то, что получили от своего программиста или известного разработчика.
3. Сверьте версии. Узнайте у разработчика, под какую конфигурацию и релиз собрано расширение и какой у него режим совместимости. Режим совместимости расширения не должен быть новее режима совместимости конфигурации, иначе оно не применится.
4. Проверьте права. Пользователю нужно право «Администрирование» или отдельное право на администрирование расширений конфигурации. В типовых конфигурациях на БСП достаточно профиля «Администратор».
5. Проверьте на копии. Разверните копию базы , подключите расширение там и проведите пару документов, которые оно затрагивает.

Три способа подключить расширение конфигурации

Способ 1. Через раздел «Администрирование» (типовые на БСП)

Подходит для БП 3.0, ЗУП 3.1, УТ 11, КА 2 и ERP — всех конфигураций на Библиотеке стандартных подсистем.

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

Форма БСП дополнительно проверяет, какие разрешения запрашивает расширение (работа с файлами, внешними ресурсами), и показывает это администратору.

Способ 2. Через «Все функции» (любая конфигурация)

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

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

Способ 3. Через Конфигуратор

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

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

Пакетная установка через командную строку удобна для нескольких баз:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F "D:\Base\Buh" /N "Администратор" /P "" ^
 /LoadCfg "D:\Ext\MyExt.cfe" -Extension "MyExt" ^
 /UpdateDBCfg -Extension "MyExt" ^
 /Out "D:\Ext\log.txt"

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

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

Флаги расширения: безопасный режим, защита и область действия

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

• ✅ Активно (Подключено) — расширение применяется при запуске. Сняли флажок — расширение остаётся в базе, но не работает .
• 🛡️ Безопасный режим — код расширения не может работать с файлами, COM-объектами, внешними компонентами и привилегированными операциями. Многие печатные формы и отчёты работают и так. Обмены, загрузки из файлов и интеграции обычно требуют снять флажок.
• 🚧 Защита от опасных действий — платформа предупреждает пользователя, если код расширения пытается выполнить потенциально опасное действие.
• 🔁 Используется в распределённой информационной базе — нужно, чтобы расширение передавалось в узлы РИБ вместе с обменом.

Если разработчик пишет, что расширению нужен небезопасный режим, не снимайте флажок «на всякий случай» у всех расширений сразу. Отключайте его точечно и фиксируйте, у какого расширения и зачем.

Если расширение не применилось: проверка и ошибки

Признак успеха простой: после перезапуска появилась новая команда, поле на форме или печатная форма. Если ничего не изменилось, идите от простого к сложному.

1. Перезапустили ли сеанс? Расширение подхватывается только новыми сеансами. Закройте программу полностью, а не одно окно.
2. Стоит ли флажок «Активно»? Его могли снять при импорте или ранее.
3. Есть ли у пользователя роль из расширения? Если расширение добавляет свои объекты, доступ к ним дают роли расширения. Проверьте профиль групп доступа.
4. Применимо ли расширение к этой конфигурации? В Конфигураторе в окне расширений есть проверка применимости. Она покажет, какой заимствованный объект или метод не найден.
5. Совпадает ли режим совместимости? Сравните его в свойствах конфигурации и расширения.

Подробности ошибки ищите в журнале регистрации: Администрирование → Обслуживание → Журнал регистрации, отбор по уровню «Ошибка» и по времени запуска.

Несколько расширений в одной базе

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

Как платформа применяет их:

• сначала все расширения с назначением «Исправление», затем «Адаптация», затем «Дополнение»;
• внутри одного назначения — в порядке добавления в базу;
• если два расширения перехватывают одну процедуру аннотацией &Вместо, сработает только одно, а результат зависит от порядка — это конфликт.

Что помогает не запутаться:

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

Как узнать, что уже установлено

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

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

Обновить версию или отключить расширение

Как обновить расширение

Разработчик прислал новую версию .cfe. Удалять старое расширение не нужно — особенно если у него есть свои данные.

1. Откройте список расширений тем же путём, что при установке.
2. Выделите расширение и выберите команду обновления из файла.
3. Укажите новый .cfe. Имя расширения в файле должно совпадать с установленным.
4. Перезапустите сеанс и проверьте работу.

В Конфигураторе для обновления повторите загрузку в существующее расширение и выполните обновление конфигурации базы данных.

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

Порядок такой:

1. Перед обновлением выпишите установленные расширения и их версии.
2. Обновите конфигурацию обычным способом.
3. Запустите программу и посмотрите, не появилось ли предупреждений о неприменимых расширениях.
4. Неприменимые расширения отправьте разработчику на адаптацию. До этого снимите у них флажок «Активно», чтобы они не мешали работе.

Отключить или удалить

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

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