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

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

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

Что такое файл CFE и чем расширение лучше правки конфигурации

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

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

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

📌 Типичные задачи, которые решают расширением:

• 🖨️ своя печатная форма счёта или акта вместо типовой;
• ➕ дополнительный реквизит в документе с выводом в список;
• 🔧 исправление ошибки типового релиза до выхода официального обновления;
• 📊 отчёт или обработка, встроенная в меню раздела, а не открываемая через Файл → Открыть.

У расширения есть свойство Назначение: «Исправление», «Адаптация» или «Дополнение». От него зависит порядок применения, когда в базе несколько расширений: сначала исправления, затем адаптации, затем дополнения.

Подготовка к установке расширения: версии, права, копия базы

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

Совместимость с платформой и конфигурацией

Расширение собирают под конкретную конфигурацию и её релиз. Если оно сделано для БП 3.0, в ЗУП оно не встанет: ему просто не к чему «прицепиться».

У расширения есть свойство Режим совместимости. Номер платформы, на которой работает база, должен быть не ниже указанного там. Расширение, собранное в режиме 8.3.24, на платформе 8.3.18 не загрузится.

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

Права пользователя

Добавлять расширения может пользователь с правом Администрирование. В типовых конфигурациях это профиль или роль «Администратор» / «Полные права». У обычного бухгалтера команды добавления не будет — она просто не отображается.

Резервная копия

Загрузка расширения сама по себе базу не портит. Но расширение с ошибкой в коде может сломать проведение документов или открытие форм. Перед установкой в рабочую базу сделайте выгрузку .dt или копию каталога файловой базы. Лучше сначала проверить расширение на копии.

Способы загрузить расширение в 1С: какой когда выбирать

Способ 1. Через пользовательский режим

Этот путь работает в любой конфигурации на БСП. Отличается только раздел меню:

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

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

Если меню раздела в конфигурации нестандартное, есть универсальный путь: Все функции → Стандартные → Управление расширениями конфигурации. Команда «Все функции» включается в Сервис и настройки (шестерёнка) → Параметры → Отображать команду «Все функции».

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

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

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

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

Способ 3. Пакетный запуск из командной строки

Для администратора, который ведёт несколько баз, удобнее скрипт. Загрузка и применение расширения — две команды:

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "" /LoadCfg "D:\ext\MyPrint.cfe" -Extension MyPrint /Out "D:\ext\load.log"

"C:\Program Files\1cv8\8.3.24.1548\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Администратор" /P "" /UpdateDBCfg -Extension MyPrint /Out "D:\ext\update.log"

Что здесь важно:

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

💡 Обратная операция — /DumpCfg "файл.cfe" -Extension ИмяРасширения. Так расширение сохраняют из одной базы, чтобы загрузить в другую.

Что делать, если расширение не загружается или не применяется

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

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

Проверка работы расширения после установки

Расширение загружено — теперь убедитесь, что оно делает то, ради чего ставилось.

1. Перезапустите программу и откройте объект, который меняет расширение. Например, документ «Реализация (акт, накладная, УПД)», если в нём новая печатная форма.
2. Проверьте, что новая команда, реквизит или отчёт появились там, где обещал разработчик.
3. Проведите тестовый документ на копии базы. Убедитесь, что движения сформировались как раньше.
4. Зайдите под обычным пользователем, а не под администратором.

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

В пользовательском режиме, в форме списка расширений, можно также включить или снять Безопасный режим и Защиту от опасных действий. Это настройки конкретной базы, автор расширения задаёт их только как значения по умолчанию.

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

Обновление

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

• В пользовательском режиме выделите расширение в списке и найдите в меню Ещё команду обновления из файла. Укажите новый .cfe.
• В Конфигураторе загрузите новый файл в то же расширение и выполните F7.
• В пакетном режиме повторите /LoadCfg ... -Extension ИмяРасширения с тем же именем, затем /UpdateDBCfg.

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

Удаление

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

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

Безопасность: каким расширениям можно доверять

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

🛡️ Правила, которые стоит соблюдать:

• 📥 ставьте расширения только от известного разработчика или внедренца, с понятной историей версий;
• 🔍 перед установкой в рабочую базу откройте расширение в Конфигураторе и посмотрите, какие объекты оно заимствует и меняет;
• 🔒 оставляйте Безопасный режим включённым, если расширению не нужен доступ к файлам и внешним программам;
• 🧪 новую версию сначала проверяйте на копии базы;
• 📝 храните исходные .cfe всех установленных версий — при проблеме откатитесь на предыдущую за пару минут.

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

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