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