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