Разработка и Конфигурация · 10 мин
Как подключить расширение конфигурации в 1С
Как подключить расширение конфигурации в 1С через конфигуратор и режим предприятия: загрузка файла CFE, проверка применимости, ошибки, отключение и удаление расширения.
Расширение конфигурации — это механизм платформы 1С:Предприятие, который позволяет добавлять или изменять функциональность типовой конфигурации без снятия её с поддержки. В отличие от прямой доработки, расширение хранится отдельно от основной конфигурации и не мешает штатному обновлению. Подключить его можно двумя способами: через конфигуратор и через режим «1С:Предприятие», и выбор зависит от ваших прав и сложившегося процесса внедрения.
Ниже разобраны оба способа подключения, проверка применимости расширения, типичные ошибки совместимости и безопасный порядок работы на рабочей базе. Инструкции актуальны для платформы 8.3, где механизм расширений развит наиболее полно.
Что такое расширение и когда его стоит использовать
Расширение конфигурации — это файл с расширением CFE, который содержит доработки: новые роли, подсистемы, отчёты, обработки, переопределённые формы и модули, добавленные реквизиты объектов. При подключении платформа «накладывает» расширение на основную конфигурацию, и пользователь видит объединённый результат.
Расширения оправданы, когда нужно доработать типовую конфигурацию (Бухгалтерия, Управление торговлей, ЗУП и другие) и при этом сохранить возможность автоматического обновления. Также расширения удобны для подключения внешних печатных форм, дополнительных отчётов и небольших отраслевых доработок, которые вендоры поставляют именно в формате CFE.
Есть и ограничения. Расширение не может изменять структуру данных произвольно: например, состав изменяемых типов и ряд объектов метаданных ограничен версией платформы. Сложные доработки с глубоким изменением логики учёта иногда проще выполнить в основной конфигурации, приняв затраты на сопровождение обновлений.
Подготовка: права, резервная копия и проверка на тестовой базе
Для работы с расширениями пользователю нужны административные права: в конфигураторе — право «Администрирование» и доступ к изменению конфигурации, в режиме предприятия — роль, дающая доступ к стандартной обработке управления расширениями. Если база клиент-серверная, убедитесь, что у вас есть возможность завершать сеансы пользователей или договоритесь с администратором.
Перед подключением любого расширения на рабочей базе выполните выгрузку информационной базы (файл DT) или сделайте резервную копию средствами СУБД. Это обязательное условие: некорректное расширение способно блокировать запуск предприятия или вызывать ошибки в прикладных механизмах, и откат через копию — самый быстрый способ восстановления.
Отдельно проверьте совместимость версий. Расширение, разработанное под конкретную версию конфигурации, может перестать работать после обновления основной конфигурации, если вендор изменил переопределяемые модули или формы. Поэтому после каждого обновления типовой конфигурации расширения нужно перепроверять.
Подключение расширения через конфигуратор
Это основной способ для разработчиков и администраторов. Он даёт полный контроль над списком расширений и позволяет сразу увидеть ошибки применимости.
- 1Откройте базу в конфигураторе под пользователем с административными правами.
- 2В меню выберите «Конфигурация → Расширения конфигурации».
- 3В открывшемся окне нажмите «Добавить» и укажите файл с расширением CFE.
- 4Задайте имя расширения, при необходимости снимите флажки «Безопасный режим» и «Защита от опасных действий» только если доверяете источнику.
- 5Нажмите «Записать» и дождитесь проверки применимости.
- 6Обновите конфигурацию базы данных (F7), если платформа это потребует, и перезапустите сеанс предприятия.
После добавления расширения в список платформа автоматически выполняет проверку применимости: сопоставляет объекты расширения с объектами основной конфигурации. Если проверка прошла, расширение отобразится в списке с установленным флажком «Используется». Ошибки проверки выводятся в окне сообщений с указанием конкретных объектов.
Обратите внимание на колонки «Безопасный режим» и «Защита от опасных действий». В безопасном режиме расширению запрещены обращения к файловой системе, COM-объектам и внешним компонентам. Для расширений из недоверенных источников безопасный режим лучше оставить включённым — это существенно снижает риски.
Подключение через режим «1С:Предприятие»
Когда доступ к конфигуратору ограничен политикой компании, расширение можно подключить прямо из пользовательского режима. Для этого используется стандартная обработка «Управление расширениями конфигурации».
Порядок такой: откройте меню «Все функции» (если команда скрыта, включите её отображение через «Сервис → Параметры»), в списке выберите «Стандартные → Управление расширениями конфигурации». В открывшейся форме нажмите «Добавить из файла», укажите CFE-файл и подтвердите загрузку. После добавления платформа предложит перезапустить сеанс — без перезапуска расширение не заработает.
В некоторых типовых конфигурациях есть дополнительный удобный механизм — «Дополнительные отчеты и обработки» из библиотеки стандартных подсистем. Он подходит для внешних отчётов и обработок (файлы ERF/EPF), но это не то же самое, что расширение конфигурации: механизм не позволяет переопределять типовые формы и модули.
Проверка применимости и типичные ошибки
Проверка применимости выполняется автоматически при записи расширения и при обновлении конфигурации базы данных. Вручную её можно запустить кнопкой «Проверить применимость» в окне расширений конфигуратора. Проверять нужно в двух режимах: «Основная конфигурация» и «Конфигурация базы данных», если они различаются.
Если расширение конфликтует с другими, порядок применения регулируется положением в списке: расширения применяются сверху вниз, и при конфликте переопределений побеждает то, что выше. Перемещать расширения можно кнопками со стрелками в окне списка.
Отключение, обновление и удаление расширения
Временно отключить расширение можно, сняв флажок «Используется» в списке расширений — само расширение при этом остаётся в базе. Это удобно для диагностики: если после обновления конфигурации появились ошибки, отключите расширения по очереди и найдите проблемное.
Обновление расширения до новой версии выполняется через кнопку «Загрузить из файла» (или повторное добавление с тем же именем): старая версия заменяется новой, после чего снова требуется проверка применимости и перезапуск сеансов. Удаление выполняется кнопкой «Удалить» в списке — расширение полностью выгружается из базы.
Как проверить результат
Флажок «Используется» установлен, ошибок применимости нет
Жёлтый или красный индикатор, сообщения об ошибках в окне проверки
Новые команды, формы и отчёты доступны пользователям после перезапуска
Элементы не появились или вызывают ошибку при открытии
Проведение документов и отчёты работают как раньше
Ошибки в типовых механизмах после подключения расширения
Особенности клиент-серверных баз и публикации на веб-сервере
В клиент-серверном варианте расширения хранятся в базе данных и применяются на стороне сервера, поэтому дополнительной настройки кластера обычно не требуется. Однако перезапуск сеансов остаётся обязательным: активные сеансы продолжают работать со старым набором метаданных. Для массового перезапуска используйте консоль кластера или обработку завершения сеансов.
Если база опубликована на веб-сервере и пользователи работают через браузер или тонкий клиент по HTTP, расширения применяются так же, но после подключения полезно убедиться, что веб-клиент корректно открывает переопределённые формы — часть возможностей (например, некоторые элементы управления) в веб-клиенте ограничена.
Как выбрать действие
Что важно запомнить
Расширение подключается через список расширений в конфигураторе или в режиме предприятия, требует проверки применимости и перезапуска сеансов. Работайте только с резервной копией, проверяйте расширения на тестовой базе и не отключайте безопасный режим без необходимости.
Частые вопросы
Можно ли подключить расширение, не заходя в конфигуратор?
Да. В режиме «1С:Предприятие» откройте «Все функции → Стандартные → Управление расширениями конфигурации», добавьте CFE-файл и перезапустите сеанс. Пользователю нужны права на администрирование расширений.
Почему расширение добавилось, но ничего не изменилось?
Чаще всего сеанс не был перезапущен: расширение применяется только при новом подключении к базе. Закройте и откройте программу заново. Также проверьте, что у расширения установлен флажок «Используется» и проверка применимости прошла без ошибок.
Что делать, если после обновления конфигурации расширение перестало работать?
Откройте список расширений и выполните проверку применимости — платформа покажет, какие объекты конфликтуют. Обычно поставщик расширения выпускает обновлённую версию под новый релиз типовой конфигурации. До её получения проблемное расширение можно временно отключить, сняв флажок «Используется».
Можно ли подключить несколько расширений одновременно?
Да, платформа поддерживает любое разумное количество расширений. Ограничение одно: если два расширения переопределяют один и тот же объект (форму, модуль), применится то, которое выше в списке. Порядок меняется кнопками перемещения в окне расширений.
Опасно ли отключать безопасный режим у расширения?
Да, если источник расширения не вызывает полного доверия. Без безопасного режима код расширения может обращаться к файловой системе сервера, запускать внешние приложения и работать с COM-объектами. Отключайте защиту только для расширений, полученных от надёжного поставщика или разработанных внутри компании.
Чем расширение отличается от внешней обработки?
Внешняя обработка (EPF) — самостоятельный файл, который запускается вручную или через механизм дополнительных отчётов и обработок и не изменяет типовые объекты. Расширение (CFE) встраивается в конфигурацию: может переопределять типовые формы, модули, добавлять реквизиты и роли, работая постоянно для всех пользователей.