Подключаем расширение .cfe к базе 1С: три рабочих способа

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

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

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

Файл расширения — это .cfe. Его часто путают с внешними файлами других типов, а они загружаются совсем в другие места.

Никогда не загружайте .cf вместо .cfe — это заменит всю конфигурацию базы.

Перед загрузкой проверьте четыре вещи:

• 📌 Для какой конфигурации и релиза сделано расширение. Расширение заимствует объекты основной конфигурации. Если разработчик собирал его на другом релизе, часть заимствованных объектов может не совпасть.
• 📌 Режим совместимости. У расширения он не должен быть выше версии платформы, на которой работает база. Номер платформы смотрите в Справка → О программе (значок «i» в правом верхнем углу).
• 📌 Права. Нужна роль «Администратор» (в типовых — «Полные права») или отдельное право на администрирование расширений конфигурации.
• 📌 Источник файла. Расширение работает с данными базы так же, как сама конфигурация. Файл от неизвестного автора — это риск.

2. Как загрузить расширение в пользовательском режиме 1С:Предприятие

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

Порядок действий

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

После перезапуска откройте форму или отчёт, которые меняет расширение, и проверьте результат.

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

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

• ✅ В списке расширений у него нет предупреждающего значка и текста об ошибке применения.
• ✅ У расширения стоит флажок «Активно» (в форме «Управление расширениями конфигурации» или в Конфигураторе).
• ✅ Изменение, ради которого ставили расширение, появилось на экране: новая кнопка, реквизит, печатная форма, исправленный расчёт.

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

Если раздела «Расширения» нет

В нетиповых конфигурациях и старых релизах ссылки может не быть. Тогда используйте стандартную функцию платформы:

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

3. Загрузка расширения через Конфигуратор

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

Пошагово

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

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

Чем отличаются способы

4. Как автоматически подключать расширение при запуске базы

Отдельной настройки «подключать при старте» нет. Любое расширение со флажком «Активно» платформа применяет при каждом новом сеансе сама. Автоматизировать имеет смысл другое — загрузку файла в базы.

Пакетный запуск Конфигуратора

Удобно, когда одно расширение нужно разнести по 10–20 базам. Пример .bat для файловой базы:

@echo off
set V8="C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe"
set CFE="D:\ext\MyExtension.cfe"

%V8% DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "пароль" ^
  /LoadCfg %CFE% -Extension "МоёРасширение" ^
  /UpdateDBCfg -Extension "МоёРасширение" ^
  /Out "D:\ext\log_buh.txt"

Для серверной базы вместо /F используйте /S "сервер\имя_базы". Путь к 1cv8.exe замените на свою версию платформы, имя после -Extension — на имя расширения из его свойств. Результат пишется в файл из параметра /Out: смотрите его после каждого запуска.

Программная загрузка

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

&НаСервере
Процедура УстановитьРасширение(АдресФайла)
	Данные = ПолучитьИзВременногоХранилища(АдресФайла);
	Отбор = Новый Структура("Имя", "МоёРасширение");
	Найденные = РасширенияКонфигурации.Получить(Отбор);
	Если Найденные.Количество() > 0 Тогда
		Расширение = Найденные[0];
	Иначе
		Расширение = РасширенияКонфигурации.Создать();
	КонецЕсли;
	Расширение.БезопасныйРежим = Истина;
	Расширение.Записать(Данные);
КонецПроцедуры

Процедура находит расширение по имени и обновляет его или создаёт новое. Безопасный режим в примере оставлен включённым: снимайте его в коде только для расширений, которым это действительно нужно. Файл предварительно помещают во временное хранилище на клиенте. Пользователю с правом администрирования расширений этого достаточно; изменения применятся в новых сеансах.

5. Ошибки при загрузке расширения 1С и что с ними делать

Если после установки база вообще перестала открываться в пользовательском режиме, зайдите в Конфигуратор, откройте Конфигурация → Расширения конфигурации и снимите у проблемного расширения флажок «Активно». Удалять его сразу не нужно.

6. Безопасность установленных расширений

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

• 🛡️ Безопасный режим. Запрещает операции, опасные для сервера и компьютера пользователя: работу с файлами, запуск программ, внешние компоненты.
• 🛡️ Защита от опасных действий. При попытке опасного действия пользователь видит предупреждение и решает, разрешать ли его.

Практические правила:

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

7. Как обновить или удалить расширение

Обновление на новую версию

1. Получите новый файл .cfe от разработчика.
2. В разделе «Расширения» выделите установленное расширение.
3. В меню «Ещё» выберите «Обновить из файла…» и укажите новый файл.
4. Перезапустите программу.

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

Не удаляйте старое расширение, чтобы поставить новое: при удалении теряются данные, которые расширение хранило в собственных справочниках и регистрах.

После обновления конфигурации

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

Удаление

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

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