Загрузка файла .cfe в информационную базу 1С 8.3: Конфигуратор, пользовательский режим и командная строка

Чтобы подключить расширение 1С из файла CFE в Конфигураторе, откройте Конфигурация → Расширения конфигурации, добавьте новое расширение кнопкой «Добавить», загрузите в него файл .cfe и примените изменения к базе командой «Обновить конфигурацию базы данных» (F7). После этого пользователи перезапускают сеансы, и доработка начинает работать. Основная конфигурация при этом остаётся на поддержке, её не нужно снимать с замка.

Способов подключить расширение три. Конфигуратор выбирают программисты и администраторы: там видны свойства, ошибки применения и сам код. Режим «1С:Предприятие» удобен бухгалтеру или администратору без доступа к Конфигуратору: файл грузится в пару кликов. Командная строка нужна для массовой установки на десятки баз и для автоматизации. Механизм расширений есть в платформе с версии 8.3.6, всё ниже относится к 8.3 с интерфейсом «Такси».

Что проверить до загрузки файла .cfe

Файл расширения — это не обработка. Он встраивается в базу и меняет поведение типовых объектов: форм, модулей, ролей. Поэтому пять минут подготовки окупаются.

📌 Что проверить:

• 💾 Резервная копия. Перед первой установкой незнакомого расширения в рабочую базу сделайте выгрузку .dt или копию через СУБД. Тестируйте расширение сначала на копии базы.
• 🧩 Для какой конфигурации сделан файл. Расширение собирают под конкретную конфигурацию и обычно под конкретный диапазон релизов. Спросите у разработчика, на каком релизе он проверял доработку.
• 🔢 Версия платформы. У расширения есть свойство «Режим совместимости». Его значение не должно быть выше, чем у основной конфигурации и чем позволяет установленная платформа. Номер платформы на сервере и клиентах должен быть не ниже того, под который собрано расширение.
• 🔐 Права. В Конфигураторе нужны административные права в базе. В режиме Предприятия у пользователя должна быть роль с правом «Администрирование расширений конфигурации» — в типовых конфигурациях оно входит в полные права.
• 📄 Источник файла. Расширение может выполнять любой код в пределах прав, которые вы ему дадите. Файл от неизвестного автора с форума — повод открыть его на копии и посмотреть модули.

Подключение расширения CFE в Конфигураторе по шагам

Это основной способ. Он показывает всё: дерево объектов расширения, свойства и сообщения платформы при применении.

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

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

Шаг 2. Создайте пустое расширение

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

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

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

1. Выделите расширение в списке и откройте его дерево (двойной щелчок или команда открытия в окне списка).
2. В меню Конфигурация для открытого расширения выберите «Загрузить конфигурацию из файла …». Пункт может находиться в подменю «Действия» окна списка — в разных сборках платформы оно скомпоновано немного по-разному.
3. Укажите файл .cfe и подтвердите замену содержимого расширения.

После загрузки в дереве появятся объекты расширения: заимствованные справочники, документы, формы, общие модули.

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

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

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

Шаг 5. Проверьте свойства и перезапустите сеансы

Откройте свойства корня расширения (Alt+Enter на верхнем узле дерева) и проверьте ключевые флаги — подробно о них ниже. Затем пользователи закрывают и заново открывают 1С: расширения подключаются к сеансу при его старте.

Безопасный режим, роли и порядок применения

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

Флаги, которые решают, работает ли доработка

Роли расширения

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

Назначение и порядок применения

У каждого расширения есть свойство «Назначение»: Исправление, Адаптация или Дополнение. Платформа применяет расширения группами в этом порядке: сначала исправления, затем адаптация, затем дополнения. Если два расширения перехватывают одну и ту же процедуру, итог зависит от этого порядка.

На практике это значит простое правило. Исправление ошибки типовой конфигурации помечайте как «Исправление», отраслевую доработку — как «Адаптация», мелкие удобства — как «Дополнение». Не полагайтесь на порядок внутри одной группы: если два расширения спорят за один обработчик, правильнее объединить код или развести перехваты.

Расширение CFE в режиме 1С:Предприятие без Конфигуратора

Этот способ подходит, когда Конфигуратор недоступен или подключает расширение не программист.

Через функцию платформы. В любой конфигурации откройте Все функции → Стандартные → Управление расширениями конфигурации. Нажмите «Добавить», выберите файл .cfe, проверьте флаги и перезапустите сеанс. Если пункта «Все функции» нет в меню, включите его отображение в параметрах программы.

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

Особенности клиент-серверной базы и пакетной установки

В клиент-серверном варианте расширение хранится в самой информационной базе на сервере 1С и в СУБД. Ставить его отдельно на каждый компьютер не нужно: все клиенты получат доработку при следующем входе.

Что учесть администратору:

• 👥 Активные сеансы. Пользователи, которые работали в момент загрузки, продолжают сеанс со старым набором расширений. Попросите всех переподключиться или дождитесь конца рабочего дня.
• 🗄️ Расширения с данными. Если расширение добавляет свои справочники или регистры, при обновлении меняется структура таблиц СУБД. Это дольше, и платформа может потребовать монопольный режим. Завершение чужих сеансов обрывает работу пользователей, поэтому делайте это вне рабочего времени и с предупреждением.
• 🧮 Разделённые базы. У расширения есть свойство «Область действия»: вся информационная база или отдельная область данных. Для обычных баз без разделения оставляйте значение для всей базы.

Установка из командной строки

Для пакетной установки используют запуск Конфигуратора с ключами /LoadCfg и /UpdateDBCfg с параметром -Extension. Пример для клиент-серверной базы:

"C:\Program Files\1cv8\8.3.24.1691\bin\1cv8.exe" DESIGNER /S "srv1c\buh" /N "Администратор" /P "пароль" /LoadCfg "D:\ext\Dorabotka.cfe" -Extension "МоеРасширение" /UpdateDBCfg -Extension "МоеРасширение" /Out "D:\ext\log.txt"

Подставьте свой номер платформы, имя сервера и базы. Для файловой базы вместо /S укажите /F "D:\Bases\Buh". Результат и ошибки смотрите в файле, указанном после /Out. Чтобы сохранить расширение из базы обратно в файл, используют /DumpCfg с тем же параметром -Extension.

Обновление и удаление расширения без потери данных

Новую версию расширения грузят в существующее, а не создают рядом второе с тем же содержимым. Два одинаковых расширения перехватят одни и те же процедуры, и код выполнится дважды.

Порядок обновления:

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

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

Ошибки при подключении расширения и что с ними делать

Тексты сообщений зависят от версии платформы, поэтому ориентируйтесь на смысл.

Ещё одна частая ситуация — файл не того типа. Расширение имеет расширение имени .cfe, полная конфигурация — .cf, выгрузка базы — .dt, внешняя обработка — .epf. Файл .cf в окно расширений не загрузится, а .epf подключают через дополнительные отчёты и обработки, не как расширение.

Частые вопросы о расширениях CFE