Подключаем файл .cfe к базе 1С 8.3 без снятия с поддержки

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

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

Что такое расширение и чем оно отличается от обработки

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

Файл расширения имеет формат .cfe. Не путайте его с другими файлами:

Расширения бывают трёх назначений. Это свойство видно в Конфигураторе, в палитре свойств расширения:

• 🔧 Исправление — патч от разработчика, закрывает конкретную ошибку релиза;
• 🎛 Адаптация — доработка под учёт конкретной организации: новая печатная форма, поле в документе, своя проверка;
• ➕ Дополнение — самостоятельная функциональность поверх типовой: интеграция с сайтом, сервис, модуль.

Главный плюс для бухгалтера и администратора: типовая конфигурация остаётся «на замке». Обновления ставятся как обычно, без сравнения и объединения. Доработка переживает обновление, если разработчик расширения не опирался на то, что фирма 1С потом поменяла.

Перед установкой расширения: пять проверок

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

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

Два способа установки: какой выбрать

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

Установка расширения в 1С через пользовательский режим

Шаг 1. Включите использование расширений

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

Шаг 2. Откройте список и добавьте файл

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

Шаг 3. Проверьте флажки строки

В строке расширения смотрите на две настройки:

• ✅ Подключено (Активно) — должно быть включено, иначе расширение не загружается при запуске;
• 🛡 Безопасный режим — по умолчанию включён и ограничивает расширение: оно не может работать с файлами, внешними компонентами, COM-объектами и привилегированным режимом.

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

Шаг 4. Перезапустите программу

Расширение подхватывается только новым сеансом. Закройте 1С и откройте снова. В клиент-серверной базе расширение заработает у каждого пользователя после его перезапуска. Тех, кто сейчас в базе, попросите перезайти.

Установка расширения через Конфигуратор

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

Шаг 1. Откройте список расширений

1. Запустите базу в режиме «Конфигуратор» под администратором.
2. Если дерево конфигурации не открыто, нажмите Конфигурация → Открыть конфигурацию.
3. Выберите Конфигурация → Расширения конфигурации. Откроется окно со списком уже подключённых расширений.

Шаг 2. Загрузите файл .cfe

1. В окне расширений нажмите «Добавить». Платформа создаст пустое расширение с именем вроде Расширение1.
2. Выделите его, откройте меню «Действия» окна расширений и выберите загрузку расширения из файла.
3. Укажите файл .cfe. Имя пустого расширения заменится на имя из файла.

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

Шаг 3. Обновите конфигурацию базы данных

Это шаг, который чаще всего пропускают. Загрузка .cfe только кладёт расширение в Конфигуратор. Чтобы оно попало в базу, нужно:

1. Открыть дерево расширения двойным щелчком по строке в списке.
2. Выполнить Конфигурация → Обновить конфигурацию базы данных или нажать F7, находясь в окне этого расширения.
3. Принять список изменений, если платформа его покажет.

После этого проверьте свойства расширения в палитре: флажки «Активно» и «Безопасный режим» ведут себя так же, как в пользовательском режиме.

Шаг 4. Проверьте результат в рабочем режиме

Запустите 1С:Предприятие и откройте ту форму, документ или печатную форму, которую меняет расширение. Новая кнопка или реквизит должны появиться сразу. Если ничего не изменилось — переходите к разделу с ошибками ниже.

Пакетная установка из командной строки

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

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

Замените номер платформы в пути на свой, а для клиент-серверной базы вместо /F используйте /S"сервер\база". Результат смотрите в файле лога: при ошибке там будет её текст.

Почему расширение не устанавливается и что делать

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

Ещё одна частая ситуация — распределённая база (РИБ). У расширения есть свойство «Использовать в распределенной информационной базе». Если оно выключено, на периферийные узлы расширение не попадёт, и в филиале доработки не будет.

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

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

Самый безопасный вариант, если расширение мешает работе или вы ищете источник ошибки:

1. Откройте список расширений в пользовательском режиме.
2. Снимите флажок «Подключено» (в Конфигураторе — «Активно»).
3. Перезапустите программу.

Расширение останется в базе со всеми данными. Вернуть его — поставить флажок обратно.

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

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

Не удаляйте старую версию перед установкой новой, если расширение хранит данные. Удаление сотрёт их.

Удалить полностью

1. В списке расширений выделите строку.
2. Нажмите «Удалить» и подтвердите.
3. В Конфигураторе после удаления выполните обновление конфигурации БД.

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