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

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

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

Где посмотреть список подключённых расширений

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

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

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

Как проверить версию и применимость расширения

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

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

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

Проверка безопасного режима и профиля безопасности

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

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

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

Тестирование работы расширения в режиме предприятия

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

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

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

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

Типичные ошибки при проверке и их причины

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

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

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

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

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

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

МассивРасширений = РасширенияКонфигурации.Получить();
Для Каждого Расш Из МассивРасширений Цикл
    Сообщить(Расш.Имя + " | версия: " + Расш.Версия + " | активно: " + Расш.Активно);
КонецЦикла;

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

FAQ