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

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

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

Зачем необходим режим совместимости в расширениях

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

Представьте ситуацию: вы разрабатываете расширение, используя новый метод объекта HTTPСоединение, который появился только в версии 8.3.20. Если вы не установите соответствующий режим совместимости, а попытаетесь запустить это расширение на сервере с версией 8.3.18, вы получите ошибку выполнения. Настройка режима сообщает платформе: «Веди себя так, как будто ты версия Х», тем самым либо запрещая использование новых функций, либо эмулируя поведение старых версий.

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

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

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

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

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

Конфигурация → Свойства → Режим совместимости

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

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

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

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

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

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

⚠️ Внимание: Если вы понижаете версию режима совместимости (например, с 8.3.20 до 8.3.15), код, использующий новые функции, не удалится автоматически. Он останется в модулях, но вызовет ошибку выполнения. Вам придется вручную найти и удалить или переписать такие участки кода.

Влияние на API и доступные объекты

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

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

Версия платформы	Доступные новые объекты	Изменения в поведении	Статус поддержки
8.3.10	Базовый набор	Классическое поведение	Устаревшая
8.3.15	Работа с JSON, HTTP-сервисы	Улучшена работа с памятью	Стабильная
8.3.18	Расширенные права, OAuth	Изменен механизм блокировок	Актуальная
8.3.21+	Новые типы данных, API облаков	Оптимизация запросов	Новейшая

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

Что происходит при компиляции?

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

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

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

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

Иногда проблема кроется не в коде расширения, а в настройках самого сервера 1С. Если на сервере принудительно установлен старый режим совместимости для всех баз, ваше расширение может наследовать эти ограничения. В таком случае необходимо проверить файл ragent.ini или настройки кластера серверов.

⚠️ Внимание: Интерфейсы и методы работы с расширениями могут обновляться фирмой «1С» в новых релизах платформы. Всегда сверяйте доступный функционал в официальном синтакс-помощнике для той версии, которую вы выбрали в настройках.

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

Проверка работоспособности после изменений

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

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

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

Как откатить изменения?

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

Особенности работы в облачных сервисах

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

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

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

Можно ли установить режим совместимости выше версии платформы сервера?

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

Влияет ли смена режима на скорость работы базы?

Косвенно может влиять. Новые версии режима совместимости часто включают оптимизации выполнения кода и запросов. Использование устаревшего режима может лишить вас этих преимуществ производительности.

Нужно ли переустанавливать расширение на рабочих местах после смены режима?

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

Что делать, если конфигуратор не дает выбрать нужную версию?

Убедитесь, что версия вашего конфигуратора не ниже той версии, которую вы хотите выбрать. Вы не можете установить режим совместимости 8.3.22, работая в конфигураторе версии 8.3.20.

Сохраняется ли история изменений режима совместимости?

Нет, в явной истории метаданных это не фиксируется как отдельное событие с комментарием. Рекомендуется вести журнал изменений в текстовом файле проекта или использовать системы контроля версий (Git) для отслеживания таких правок.