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

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

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

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

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

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

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

Как понять, что расширение требует обновления

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

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

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

Расширение не примененоКритическая ситуация

Откройте текст ошибки в списке расширений — там указан конфликтующий объект

Ошибка при запуске сеансаБлокирующая проблема

Потребуется отключить расширение через конфигуратор

Расширение применено, но работает неверноСкрытая несовместимость

Протестируйте доработанный функционал на копии базы

Подготовка: резервная копия и список расширений

Перед любыми манипуляциями с расширениями сделайте резервную копию базы. Для файловой базы достаточно выгрузки через конфигуратор («Администрирование» → «Выгрузить информационную базу») или копирования файла 1Cv8.1CD при закрытых сеансах. Для клиент-серверной базы используйте штатные средства СУБД или выгрузку в dt.

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

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

Способ 1: загрузить обновлённую версию от разработчика

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

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

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

Проверка результата после обновления

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

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

Контрольные точки

Как проверить результат

Статус в списке расширений
Норма

Расширение применено, ошибок нет

Тревожный признак

Отметка о невозможности применения

Работа доработанного функционала
Норма

Документы, печатные формы и отчёты работают как раньше

Тревожный признак

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

Журнал регистрации
Норма

Нет новых ошибок после тестирования

Тревожный признак

Ошибки в обработчиках и фоновых заданиях

Типичные ошибки и ограничения

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

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

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

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

Что делать, если расширение невозможно исправить

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

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

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

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

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

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

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

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

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

Расширение применено без ошибок, значит ли это, что оно работает правильно?

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

Как отключить расширение, если база не открывается в режиме предприятия?

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

Можно ли перенести расширение из одной базы в другую?

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

Удалится ли расширение при обновлении конфигурации?

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

Чем расширение лучше прямой доработки конфигурации?

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

Итог

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

Проверка и обновление расширений — обязательная часть каждого обновления конфигурации 1С. Работайте на копии базы, сохраняйте старые версии .cfe, используйте обновления от разработчика, а при их отсутствии исправляйте конфликты в конфигураторе. Финальный критерий успеха — не статус «применено», а корректная работа доработанного функционала у обычных пользователей.