Как добавить расширение в конфигураторе 1С

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

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

Что такое расширение конфигурации и когда его применяют

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

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

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

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

Обязательно сделайте выгрузку информационной базы (файл .dt) через меню «Администрирование» → «Выгрузить информационную базу». Если расширение содержит ошибки или конфликтует с конфигурацией, вы сможете быстро вернуться к исходному состоянию без потери данных.

Пошаговая загрузка расширения в конфигураторе

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

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

После загрузки в списке расширений появится строка с именем расширения. Обратите внимание на колонки «Безопасный режим», «Защита от опасных действий» и «Использовать в основных ролях» — от них зависит, как расширение будет работать у пользователей.

Если окно расширений пустое и кнопка «Добавить» недоступна, проверьте, что конфигурация открыта (меню «Конфигурация» → «Открыть конфигурацию») и что у пользователя есть необходимые права.

Проверка применимости и устранение конфликтов

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

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

Контрольные точки

Как проверить результат

Статус расширения в списке

Норма

Признак применимости установлен, ошибок нет

Тревожный признак

Сообщение о неприменимости или ошибках проверки

Запуск в режиме 1С:Предприятие

Норма

Доработки доступны, формы открываются без ошибок

Тревожный признак

Ошибки при открытии форм или выполнении кода

Поведение типовых объектов

Норма

Типовые документы и отчёты работают как раньше

Тревожный признак

Типовые механизмы сломаны после подключения

Безопасный режим и защита от опасных действий

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

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

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

Для отладки кода расширения откройте его двойным щелчком в окне расширений — появится отдельное дерево объектов расширения. Установите точки останова в модулях расширения и запустите отладку обычным образом: предметы отладки расширений подключаются автоматически, если сеанс запущен из той же базы.

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

Альтернативные способы подключения

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

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

Способы подключения расширения

Конфигуратор

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

Режим 1С:Предприятие

Удобно для пользовательских расширений без конфигуратора. Ограничено настройками безопасности программы.

Пакетный режим командной строки

Подходит для автоматизации и развёртывания на многих базах. Требует навыков работы со скриптами.

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

Можно ли подключить расширение без монопольного режима?

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

Чем расширение отличается от внешней обработки?

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

Почему расширение загрузилось, но изменения не видны?

Чаще всего не выполнено обновление конфигурации базы данных (F7) либо вы проверяете результат в сеансе, запущенном до подключения расширения. Завершите сеанс и войдите заново.

Что делать, если после обновления конфигурации расширение стало неприменимым?

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

Можно ли временно отключить расширение, не удаляя его?

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