Как подключить расширение конфигурации в 1С

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

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

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

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

Механизм расширений работает только при выполнении технических условий. Первое — версия платформы: расширения появились в платформе 8.3.6, но полноценные возможности (изменение форм, ролей, подсистем) доступны в более поздних релизах. Чем выше версия платформы, тем стабильнее механизм.

Второе условие — режим совместимости конфигурации. Откройте конфигуратор, вызовите свойства корня конфигурации и найдите поле «Режим совместимости». Если там стоит «Не использовать» или значение ниже 8.3.6, расширения будут недоступны. Для типовых конфигураций (Бухгалтерия, Управление торговлей, ERP) этот параметр обычно уже корректен.

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

Четвёртое — соответствие расширения конфигурации. Расширение, написанное под «1С:Бухгалтерию 3.0», не встанет корректно на «Управление торговлей» или на другой релиз той же бухгалтерии, если задействованные в расширении объекты изменились. Всегда уточняйте у разработчика расширения, под какую конфигурацию и релиз оно собрано.

Где найти управление расширениями в 1С

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

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

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

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

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

1. 1
   Сделайте резервную копию базы или убедитесь, что актуальная копия существует
2. 2
   Откройте «Все функции → Стандартные → Управление расширениями конфигурации» или путь через «Администрирование»
3. 3
   Нажмите «Добавить» и выберите файл расширения с расширением .cfe
4. 4
   Дождитесь загрузки: расширение появится в списке с именем и версией
5. 5
   Снимите флажок «Безопасный режим», если расширению требуется доступ к файловой системе, COM-объектам или внешним компонентам
6. 6
   Проверьте, что флажок в колонке активности установлен (расширение включено)
7. 7
   Завершите сеанс и запустите 1С заново
8. 8
   Проверьте работу добавленной функциональности

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

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

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

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

Если расширение обменивается файлами, обращается к веб-сервисам или использует внешние компоненты, снимите флажок «Безопасный режим» в строке расширения. Дополнительно может потребоваться отключить флажок «Защита от опасных действий» — иначе платформа будет выдавать предупреждения при выполнении потенциально опасных операций.

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

Маршрут решения

Как выбрать действие

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

Расширение работает с файлами, FTP, веб-сервисами или внешними компонентамиОтключите безопасный режим, предварительно убедившись в надёжности источника

После подключения появляются окна «Предупреждение безопасности»Отключите флажок «Защита от опасных действий» для этого расширения

Источник расширения неизвестен, а оно требует отключить защитуНе подключайте в рабочей базе; сначала проверьте код на копии или у разработчика

Проверка результата и обновление расширения

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

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

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

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

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

Норма

Флажок активности установлен, версия соответствует полученному файлу

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

Строки нет или флажок снят — расширение не применено

Работа функциональности после перезапуска

Норма

Новые команды, формы или отчёты открываются и выполняются без ошибок

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

Ошибки при открытии объектов или отсутствие заявленных команд

Журнал регистрации

Норма

Нет ошибок с упоминанием имени расширения

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

Ошибки применения расширения или обращения к отсутствующим объектам

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

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

Отключение и удаление расширения

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

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

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

Частые вопросы о подключении расширений 1С

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

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

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

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

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

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

Снимается ли конфигурация с поддержки при подключении расширения?

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

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

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

Нужны ли права администратора для подключения расширения?

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