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

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

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

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

Пять минут подготовки снимают большую часть проблем, которые потом выглядят как «расширение не работает ».

📌 Версия платформы. Расширение собирают под определённый режим совместимости. Номер платформы на рабочих местах и на сервере должен быть не ниже того, на котором разработчик собирал .cfe. Узнать номер можно в окне Справка → О программе (значок «i» в правом верхнем углу).

📌 Релиз конфигурации. Расширение «цепляется» к объектам основной конфигурации по именам: к формам, реквизитам, модулям. Если разработчик писал его под другой релиз, часть объектов может не найтись. Спросите у автора, под какой релиз оно сделано, и сверьте с тем, что у вас в Справка → О программе.

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

📌 Назначение расширения. В свойствах .cfe разработчик указывает назначение: исправление, адаптация или дополнение. От него зависит порядок применения, если расширений несколько.

📌 Источник файла. Расширение исполняет код в вашей базе. Ставьте только то, что получили от известного разработчика или обслуживающей организации.

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

Способ зависит от того, кто ставит расширение и как часто его придётся менять.

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

Установка из программы через раздел «Администрирование»

Этот путь работает в типовых конфигурациях на Библиотеке стандартных подсистем: БП 3.0, ЗУП 3.1, УТ 11, КА 2, ERP 2, УНФ.

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

Если пункта «Расширения» нет

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

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

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

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

1. Запустите базу в режиме «Конфигуратор».
2. Откройте основную конфигурацию: Конфигурация → Открыть конфигурацию.
3. Выберите Конфигурация → Расширения конфигурации. Откроется окно со списком расширений.
4. Нажмите «Добавить». Появится новое расширение с именем вида «Расширение1».

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

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

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

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

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

Шаг 4. Проверьте свойства

Откройте палитру свойств расширения (корень дерева, Alt+Enter) и посмотрите:

• Безопасный режим — ограничивает расширению доступ к файлам, COM, внешним компонентам и привилегированному режиму;
• Защита от опасных действий — предупреждения при запуске опасных операций;
• Режим совместимости — должен соответствовать режиму основной конфигурации;
• Активно — флаг включения в списке расширений.

Установка расширения из хранилища конфигурации

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

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

После подключения обновления забирают командой «Получить из хранилища». Готовую версию для рабочих баз удобнее выгрузить в .cfe и раздать первым или вторым способом.

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

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

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

Номер платформы в пути замените на свой. Для серверной базы вместо /F укажите /S "сервер\база". Результат смотрите в файле лога: при ошибке Конфигуратор пишет туда причину и завершается.

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

Расширение может стоять в списке и при этом не применяться. Проверьте по порядку.

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

💡 Для серверных баз удобно посмотреть активные сеансы в консоли кластера: пока висят старые сеансы, часть пользователей работает без расширения.

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

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

Обновить или удалить расширение: в чём подвох

Обновление

Новую версию ставят поверх старой, а не рядом:

• в программе — выделите расширение в списке и выберите команду обновления из файла;
• в Конфигураторе — загрузите новый .cfe в то же расширение и выполните F7.

Если добавить новый файл как отдельное расширение, в базе окажутся два одинаковых слоя. Это даёт конфликты и двойное срабатывание кода.

Удаление

1. В программе: выделите расширение и нажмите «Удалить», затем перезапустите 1С.
2. В Конфигураторе: выделите расширение в окне Конфигурация → Расширения конфигурации, удалите его и обновите конфигурацию базы данных.

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

Порядок при обновлении типовой конфигурации

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

Безопасность: как не впустить в базу чужой код

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

• 🔒 Безопасный режим по умолчанию. Снимайте его только для расширений от проверенных авторов и только когда без этого расширение не работает.
• 🔒 Защита от опасных действий должна оставаться включённой у пользователей. Её отключение в свойствах пользователя открывает путь к запуску внешнего кода без вопросов.
• 🔒 Право на администрирование расширений — только администраторам. Бухгалтеру хватает права использовать результат.
• 🔒 Список установленного. Раз в квартал просматривайте список расширений. Ненужные и «временные» удаляйте или отключайте.
• 🔒 Код от подрядчика — проверяйте на копии. Попросите исходники в виде .cfe, а не только описание «что делает».

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