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

Другое · 5 мин

Как изменить режим совместимости расширения в 1С

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

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

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

Где находится настройка режима совместимости

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

Порядок действий
  1. 1
    Открыть конфигуратор и найти расширение в дереве конфигурации
  2. 2
    Открыть свойства расширения и выбрать нужный режим совместимости
  3. 3
    Сохранить расширение и обновить конфигурацию базы
  4. 4
    Проверить загрузку расширения в режиме предприятия

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

Как изменить режим совместимости расширения

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

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

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

Расширение в списке установленных
Норма

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

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

Отмечено как несовместимое или отсутствует

Запуск форм и команд расширения
Норма

Выполняется без сообщений

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

Появляются ошибки компиляции или выполнения

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

Проверка результата и ограничения

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

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

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

Одна из частых ошибок — выбор слишком нового режима совместимости на базе, где установлена более старая версия платформы. Это может привести к отказу в загрузке расширения. Другая ошибка — изменение режима без резервного копирования, что затрудняет откат при возникновении проблем.

Типичные ошибки
01
Выбор слишком нового режима совместимости для текущей платформы
02
Изменение всех расширений сразу без проверки каждого

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

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

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

Расширение зашифровано или правка недоступнаОбратитесь к разработчику или установите обновлённую версию
После смены режима появились ошибкиВерните предыдущий режим и восстановите резервную копию

Альтернативы и когда обращаться к администратору

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

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

Итог

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

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

Можно ли изменить режим совместимости у любого расширения?

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

Нужно ли перезапускать конфигуратор после смены режима?

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

Что делать, если после смены режима расширение не отображается?

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

Влияет ли режим совместимости на работу уже созданных документов?

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