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