К статье
Практический материал

Администрирование · 11 мин

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

Как проверить расширения 1С после обновления конфигурации: проверка применимости, исправление ошибок, тестирование функций и типовые проблемы с расширениями.

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

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

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

Где посмотреть список расширений и их статус

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

В конфигураторе список находится в меню «Конфигурация» → «Расширения конфигурации». Здесь же видно, подключено ли расширение, и можно открыть его структуру для анализа.

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

Расширение применено, ошибок нетНормальное состояние

Проверьте вручную функции, которые оно меняет

Расширение есть в списке, но не примененоКонфликт с новой версией конфигурации

Запустите проверку применимости и прочитайте текст ошибки

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

Уточните, кто и зачем его устанавливал, восстановите из файла .cfe

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

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

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

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

Ручное тестирование функций расширения

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

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

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

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

Что делать с несовместимым расширением

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

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

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

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

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

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

Расширение от внешнего поставщика, ошибок применимости многоЗапросите у поставщика версию, совместимую с новым релизом конфигурации
Расширение своё, ошибок 1–3, причина в переименованных объектахАдаптируйте в конфигураторе: обновите заимствованные объекты и повторите проверку
Расширение-исправление, а ошибка устранена в новом релизеУдалите расширение — оно больше не нужно и может конфликтовать с типовым кодом
Функция расширения редко используется, адаптация трудоёмкаОтключите расширение и зафиксируйте решение в учётной документации

Особые случаи: безопасный режим, роли и несколько расширений

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

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

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

Как организовать контроль на будущее

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

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

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

Типичные ошибки
01
Обновление рабочей базы без прогона на копии — несовместимое расширение обнаруживается, когда пользователи уже не могут работать
02
Ограничение проверки только статусом «применено» — логические ошибки в изменённых функциях остаются незамеченными
03
Удаление несовместимого расширения без сохранения файла .cfe — доработку приходится восстанавливать с нуля
04
Игнорирование расширений-исправлений после обновления — они начинают конфликтовать с типовым кодом, в котором ошибка уже устранена
05
Отсутствие реестра расширений — никто не помнит, зачем расширение установлено и критично ли оно
Итог

Что важно запомнить

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

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

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

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

Расширение применено, но изменённая им форма выглядит как типовая. Что случилось?

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

Как понять, какие объекты конфигурации затрагивает расширение?

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

Что делать, если после обновления база вообще не запускается из-за расширения?

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

Влияют ли расширения на скорость работы после обновления?

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

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

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