Подключение расширения конфигурации (.cfe) в 1С 8.3: из программы, Конфигуратора и командной строки

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

Типичная ситуация: программист прислал файл Доработки_Печать.cfe с исправленной печатной формой счёта и коротким «поставьте себе». Бухгалтер с правами администратора справится за пять минут. Подключить расширение конфигурации можно тремя способами: из пользовательского режима, через Конфигуратор и пакетно из командной строки. Какой выбрать — зависит от числа баз и от того, нужно ли заглядывать внутрь расширения.

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

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

Проверьте до установки:

• 📄 Формат файла. Расширение — это .cfe. Файл .epf — внешняя обработка, .erf — внешний отчёт, .cf — полная конфигурация. Их подключают совсем другими командами.
• 🔢 Для какой конфигурации и какого релиза сделано расширение. Расширение ссылается на объекты основной конфигурации по именам. Если оно написано под другой релиз, часть объектов может не найтись, и расширение не применится.
• ⚙️ Режим совместимости. У расширения есть свойство «Режим совместимости». Он не должен быть новее, чем у основной конфигурации.
• 🔑 Права пользователя. Устанавливать расширения может только администратор. В типовых конфигурациях это профиль «Администратор» с ролью «Полные права».
• 👥 Сеансы. Установка не требует монопольного режима, но новое расширение начнёт работать только в новых сеансах. Другим пользователям придётся перезайти.
• 💾 Копия базы. Расширение может менять поведение проведения и записи документов. Если ставите его на рабочую базу впервые, сначала сделайте выгрузку .dt или резервную копию СУБД.

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

Как установить расширение в 1С 8.3 из пользовательского режима

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

Через форму «Расширения» в типовой конфигурации

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

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

Через «Все функции» в любой конфигурации

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

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

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

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

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

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

Расширение, загруженное в Конфигураторе, отображается и в форме «Расширения» в режиме Предприятия. Флажки безопасного режима после этого всё равно стоит проверить там.

Что смотреть в свойствах расширения

Откройте свойства корня расширения (двойной щелчок по имени в дереве):

• Назначение — «Исправление», «Адаптация» или «Дополнение». Это подсказка о смысле доработки, на установку не влияет.
• Режим совместимости — номер не выше, чем у основной конфигурации. Проще всего, когда они совпадают.
• Префикс имён — разработчики используют его, чтобы новые объекты не пересеклись с объектами типовой конфигурации после её обновления.
• Версия — заполняется разработчиком; по ней удобно понимать, какая сборка стоит в базе.

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

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

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

Когда одно расширение нужно поставить в двадцать баз, вручную это долго. Платформа умеет загружать расширения в пакетном режиме Конфигуратора. Используются ключи /LoadCfg и /UpdateDBCfg с параметром -Extension, где указывается имя расширения.

Пример для файловой базы:

@echo off
set V8="C:\Program Files\1cv8\8.3.25.1445\bin\1cv8.exe"
set BASE=D:\Bases\Buh
set CFE=D:\Ext\Dorabotki_Pechat.cfe
set EXT=Dorabotki_Pechat

%V8% DESIGNER /F "%BASE%" /N "Администратор" /P "" /LoadCfg "%CFE%" -Extension %EXT% /Out "D:\Ext\load.log"
%V8% DESIGNER /F "%BASE%" /N "Администратор" /P "" /UpdateDBCfg -Extension %EXT% /Out "D:\Ext\update.log"

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

Что важно в скрипте:

• 📝 Ключ /Out пишет журнал. Без него вы не узнаете, почему загрузка не прошла.
• 🔁 Вызовы идут последовательно: сначала загрузка, потом обновление конфигурации базы данных, как и в интерактивном режиме.
• 🔐 Пароль администратора в bat-файле — плохая практика. Храните скрипт в папке с ограниченным доступом или передавайте пароль параметром при запуске.
• 📤 Обратная операция — /DumpCfg "файл.cfe" -Extension ИмяРасширения — выгружает расширение из базы. Удобно делать её перед заменой версии.

Расширения в конфигурациях на БСП: что добавляет типовая форма

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

• 🛡️ Предупреждение о безопасности при каждом добавлении. Пользователь явно подтверждает, что источник надёжный.
• 🔄 Обновление из файла. Чтобы поставить новую версию того же расширения, выделите его в списке и используйте команду обновления из файла. Отдельно удалять старое не нужно, настройки подключения сохраняются.
• ⏯️ Отключение без удаления. Снимите флажок «Активно» — расширение перестанет применяться после перезапуска, но останется в базе. Так удобно проверять, не оно ли вызывает ошибку.
• 💾 Сохранение в файл прямо из пользовательского режима — для переноса или резервной копии.

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

Это главный источник проблем. Типовая конфигурация обновилась, а расширение ссылается на объект или процедуру, которых в новом релизе нет или которые переименованы. Тогда при входе 1С сообщает, что расширение не может быть применено, и указывает объект.

Порядок, который снижает риски:

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

Работа в облаке

В облачных сервисах на технологии 1cFresh порядок установки расширений задаёт провайдер: у одних это тот же раздел «Расширения», у других — заявка в поддержку. Расширения, которым нужен небезопасный режим, в облаке, как правило, не разрешают.

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

Сообщения платформы бывают длинными, но по смыслу укладываются в несколько групп. Выберите свой симптом:

Если ни один вариант не подошёл, временно отключите все расширения по одному. Так быстро видно, какое из них конфликтует. Часто конфликт возникает между двумя расширениями, которые перехватывают одну и ту же процедуру.

Безопасный режим, права и обновление установленных расширений

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

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

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

Кому давать права

• 👤 Устанавливать и удалять расширения — только администратору базы.
• 🚫 Не давайте полные права «на время», чтобы бухгалтер поставил расширение сам. Безопаснее, если администратор сделает это за пять минут.
• 📋 Ведите простой список: какое расширение, от кого, какая версия, когда поставлено. Через год это сэкономит много времени при обновлении.

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

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

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

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