Подключение расширения конфигурации 1С: через Конфигуратор и в режиме Предприятия

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

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

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

Три минуты на проверку избавят от половины сбоев. Начните с формата файла.

• 📦 .cfe — расширение конфигурации . Именно его мы подключаем.
• 📄 .epf и .erf — внешние обработки и отчёты. Они подключаются иначе, через справочник дополнительных отчётов и обработок, и расширением не являются.
• 🗜 .zip или .rar — архив. Файл расширения нужно достать из него заранее.

Дальше три вопроса:

1. Версия платформы. Расширение собрано под определённую платформу. Если платформа в вашей базе ниже, расширение может не загрузиться. Сравнивайте по номеру: он должен быть не ниже указанного автором расширения. Номер виден в окне «О программе».
2. Совпадение конфигурации. Расширение для «Бухгалтерии предприятия 3.0» не встанет в ЗУП 3.1. Проверьте название и редакцию в описании автора.
3. Права. Нужна роль с полными правами. В Конфигуратор пускают только пользователя, у которого она есть.

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

Способ 1. Загрузка расширения через Конфигуратор

Это основной способ. Он работает на любой базе, файловой и клиент-серверной.

Открываем список расширений

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

Загружаем файл

1. В окне списка найдите команду загрузки расширения из файла. Она есть в меню Действия и на панели окна.
2. Укажите путь к .cfe.
3. Конфигуратор покажет расширение в списке. Имя берётся из самого файла.
4. Нажмите Конфигурация → Обновить конфигурацию базы данных (клавиша F7) и подтвердите изменения.

Только после шага 4 расширение попадает в рабочую базу. Без него в Конфигураторе вы его видите, а пользователи в режиме Предприятия нет. Это самая частая причина вопроса «загрузил, а ничего не изменилось».

Выставляем свойства

Выделите расширение в списке и откройте его свойства. Три из них определяют, как оно будет вести себя.

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

Способ 2. Подключение из режима Предприятия

Во многих типовых конфигурациях на базе Библиотеки стандартных подсистем есть форма управления расширениями. Искать её нужно в разделе Администрирование: откройте подраздел про печатные формы, отчёты и обработки и найдите там пункт про расширения. Точное название пункта немного отличается в зависимости от релиза и конфигурации, поэтому ориентируйтесь на раздел, а не на дословный текст.

В форме есть кнопка добавления расширения из файла. Порядок действий:

1. Нажмите кнопку добавления и выберите .cfe на диске.
2. Прочитайте предупреждение системы. Оно напоминает, что расширение выполняет код в вашей базе.
3. Подтвердите. Расширение появится в списке с признаком, подключено оно или нет.
4. Перезапустите программу: расширение применится при новом сеансе.

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

Если файл нужно подключить пакетно

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

"C:\Program Files\1cv8\8.3.xx.xxxx\bin\1cv8.exe" DESIGNER /F "D:\Bases\Buh" /N "Админ" /P "пароль" /LoadCfg "D:\Ext\myext.cfe" -Extension МоёРасширение /UpdateDBCfg -Extension МоёРасширение /Out "D:\Ext\log.txt"

Здесь 8.3.xx.xxxx — номер установленной платформы, /F — путь к файловой базе, /Out — файл журнала. Для серверной базы вместо /F используют /S с именем сервера и базы. Ключ -Extension задаёт имя расширения, с которым идёт работа.

Проверьте команду на копии, а пароль в рабочем скрипте не оставляйте открытым текстом. После запуска откройте log.txt: там будет видно, прошла ли загрузка и обновление.

Веб-клиент, тонкий и толстый клиент

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

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

На сервере 1С применённые расширения подхватываются новыми сеансами. Активные сеансы продолжают работать со старым состоянием до перезапуска. Поэтому после загрузки расширения в рабочую базу предупредите пользователей: пусть выйдут и зайдут снова.

Расширение подключено, но не работает: диагностика

Идите от простого к сложному. Большинство случаев решается на втором-третьем шаге.

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

Что делать с расширением дальше: обновить, отключить, удалить

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

Обновление до новой версии

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

Временное отключение

Снимите флаг «Активно». Расширение остаётся в базе, его данные не стираются, но код не выполняется. Так удобно проверять: пропала ли ошибка из-за расширения или причина в другом.

Удаление

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

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

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

Когда расширение подключать не стоит

Расширение не всегда лучший выход. Пара случаев, где от него больше вреда, чем пользы.

• 🧪 Нужна разовая операция. Один раз поправить данные или выгрузить список быстрее внешней обработкой. Она не остаётся в конфигурации и не мешает обновлениям.
• 🔁 Расширение дублирует типовую настройку. Многое решается без кода: настройкой печатной формы, полем в карточке, правами. Сначала проверьте раздел Администрирование, потом обращайтесь к расширениям.
• 🚫 Источник неизвестен. Файл без описания, автора и истории версий лучше не ставить даже в безопасном режиме. Сначала проверьте его на копии базы.
• 📉 Объектов в расширении много, а автор пропал. После каждого обновления релиза вам придётся самому разбираться в его коде. Такой долг лучше не брать.

Практика показывает: расширение, которое вы можете описать одной фразой («добавляет колонку в документ реализации»), живёт долго. Расширение на сорок объектов без документации ломается при первом же обновлении.

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