Подключение расширения CFE к базе 1С 8.3 без потери данных

Файл с расширением .cfe — это расширение конфигурации . Его не копируют в папку базы и не запускают как программу: его загружают в информационную базу, и платформа 1С 8.3 накладывает изменения поверх типовой конфигурации, не трогая её код. Из обычного режима работы (с правами администратора) это делается за минуту. Из конфигуратора — тоже, но шагов больше.

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

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

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

• 🔑 Права. Пользователь должен иметь роль администратора (в типовых конфигурациях это «Полные права»). Для работы в конфигураторе нужен ещё и вход в режим «Конфигуратор».
• 🧩 Платформа и конфигурация. Расширение собирают под конкретную конфигурацию и диапазон версий. Посмотрите описание от разработчика: для какой конфигурации, с какого релиза, на какой платформе проверено. Если сказано «платформа не ниже 8.3.14» — ваша платформа должна иметь номер не ниже этого.
• 💾 Копия базы. Выгрузите информационную базу в .dt или сделайте копию каталога файловой базы. Для серверной базы — резервная копия средствами СУБД.
• 📄 Лицензия. Платформа должна запускаться штатно: без доступной лицензии базу не откроет ни пользователь, ни конфигуратор.

Установка CFE из режима 1С:Предприятие

Это самый простой путь. Он работает в конфигурациях со встроенной библиотекой стандартных подсистем (БСП): 1С:Бухгалтерия, ЗУП, Управление торговлей и других типовых.

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

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

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

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

Загрузка файла

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

Свойства расширения

После загрузки откройте свойства расширения (двойной щелчок по строке). Важны три галочки:

Обновление конфигурации базы данных

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

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

Безопасный режим и права: как не потерять контроль над базой

Самый частый вопрос после загрузки: почему расширение «ничего не делает» или, наоборот, ломает рабочий процесс. Часто причина в настройках безопасности.

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

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

• 🛡 Для стороннего расширения: безопасный режим включён, защита от опасных действий включена.
• 🧪 Если функция не работает из-за ограничений: сначала разберитесь, что именно блокируется, и спросите у автора, нужен ли этот доступ.
• ✅ Отключайте защиту только для расширения, чей исходный код вы видели или за которое отвечает ваш разработчик.

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

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

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

Журнал регистрации открывается из Администрирование → Поддержка и обслуживание → Журнал регистрации (в конфигураторе — меню Администрирование → Журнал регистрации). Фильтруйте по уровню Ошибка и по времени запуска расширения.

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

Автоматизация: установка CFE без ручных действий

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

"C:\Program Files\1cv8\<версия>\bin\1cv8.exe" DESIGNER /F "D:\bases\test" /N "Админ" /P "пароль" /LoadCfg "D:\ext\MyExt.cfe" -Extension "МоёРасширение" /UpdateDBCfg -Extension "МоёРасширение" /Out "D:\ext\log.txt"

Имя расширения в параметре -Extension — это имя, под которым оно значится в конфигурации. Точный набор параметров и порядок смотрите в справке платформы по запуску конфигуратора: от версии к версии он дополняется.

Что учесть в скрипте:

• 🔒 Пароль не хранить в открытом виде в общем репозитории.
• 📜 Всегда писать лог через /Out и проверять код возврата.
• 👥 Перед запуском на рабочей базе убедиться, что пользователи вышли: пакетный режим также требует монопольного доступа для обновления структуры.
• 🧯 Сначала прогонять скрипт на копии.

Типичные ошибки при установке и что с ними делать

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

Обновление и удаление установленного расширения

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

Загрузка новой версии

Новый .cfe загружают поверх старого. Порядок действий:

1. Сделайте копию базы , как и при первой установке.
2. Откройте список расширений (в режиме 1С:Предприятие или в конфигураторе).
3. Загрузите новый файл. Если имя расширения совпадает, платформа заменит старую версию.
4. Проверьте свойства: после замены они иногда сбрасываются к значениям по умолчанию, и безопасный режим придётся настроить заново.
5. Обновите конфигурацию базы данных, если новая версия добавила объекты с данными.

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

Удаление

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

Для временного отключения достаточно снять галочку «Активно»: никакие данные не потеряются.

Порядок выкладки на рабочую базу

Расширения чаще всего ломают рабочий процесс не из-за ошибки в коде, а из-за неаккуратной выкладки. Рабочая схема из четырёх шагов:

• 🧪 Тестовая копия. Разверните копию базы из свежего бэкапа, поставьте расширение и пройдите основные сценарии: ввод документа, печать, отчёт, обмен, если он есть.
• 👀 Приёмка пользователем. Покажите изменение тому, кто работает с этим участком, а не только программисту. Заметить неудобство в форме проще у пользователя.
• 🕕 Окно выкладки. Установка на рабочую базу в нерабочее время, когда нет проведения документов и регламентных заданий.
• ↩️ План отката. Заранее знайте, как вернуться: свежая копия, предыдущая версия расширения, снятая галочка «Активно».

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

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