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