Программное получение версии платформы 1С Предприятие

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

Разработчики должны понимать, что существует разница между версией самой платформы, версией конфигурации и версией технологической платформы сервера. Чтобы корректно обработать эти данные, необходимо использовать встроенные свойства глобального контекста или специализированные объекты метаданных.

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

Глобальные свойства для определения версии

Самый простой способ получить информацию о запущенном экземпляре — обратиться к предопределенным глобальным свойствам. В коде на встроенном языке 1С они доступны без дополнительных объявлений и работают в любом контексте выполнения.

Основным свойством является Version (или Версия в русскоязычном интерфейсе), которое возвращает строковое представление номера платформы. Формат этой строки обычно выглядит как «8.3.15.1800», где цифры обозначают мажорную версию, минорную версию, номер релиза и номер сборки соответственно.

Для более детального анализа можно использовать свойство SessionVersion, которое показывает версию сессии. Однако стоит помнить, что в тонком клиенте эти значения могут совпадать, тогда как в веб-клиенте или при работе через COM-соединение могут наблюдаться отличия в отображении номера сборки.

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

Различия между клиентом и сервером

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

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

Для получения версии сервера необходимо выполнять код в контексте сервера. Обычно это делается с помощью выполнения кода на сервере через механизмы удаленного вызова или в модулях объектов, помеченных соответствующими директивами компиляции.

⚠️ Внимание: В веб-клиенте понятие «версия клиента» может быть абстрактным, так как исполнение кода происходит в браузере, а логика платформы эмулируется JavaScript-движком сервера.

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

Использование объекта ИнформацияОПриложении

Более структурированный и надежный способ получения данных — использование объекта InformationApplication (ИнформацияОПриложении). Этот объект предоставляет не только номер версии, но и другие системные параметры запуска.

Для доступа к данным необходимо вызвать метод InformationApplication() или обратиться к глобальному контексту. Полученный объект содержит свойства, такие как Version, Name и Copyright, которые позволяют идентифицировать платформу с высокой точностью.

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

Пример кода для получения строки версии выглядит следующим образом:

Инфо = ИнформацияОПриложении();
Сообщить(Инфо.Версия);

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

Парсинг строки версии и сравнение

Полученная строка версии требует обработки для логического сравнения. Простое сравнение строк «8.3.10.1000» и «8.3.9.2000» может дать неверный результат, если не учитывать разрядность чисел в номере сборки.

Рекомендуется разбивать строку на составляющие части с использованием разделителя «.» (точка). Затем каждая часть приводится к числу и сравнивается последовательно: сначала мажорная версия, затем минорная, релиз и сборка.

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

Компонент версии	Пример значения	Значимость
Мажорная версия	8	Глобальное изменение архитектуры
Минорная версия	3	Добавление крупных подсистем
Релиз	15	Регулярное обновление функционала
Сборка	1800	Исправления ошибок и патчи

Алгоритм сравнения версий

Разбейте строку по точке. Преобразуйте части в числа. Сравнивайте слева направо. Если первое число больше — версия новее. Если равно — переходите к следующему.

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

Особенности работы в COM-соединении

При внешнем соединении с 1С через COM (Component Object Model) механизм получения версии имеет свои особенности. Внешнее приложение (например, написанное на C# или VBA) не имеет прямого доступа к глобальному контексту 1С до момента подключения.

После создания объекта соединения V83.COMConnector и получения объекта приложения 1С:Предприятие, необходимо вызвать метод получения информации о приложении уже через интерфейс COM-объекта.

Свойство Version в COM-интерфейсе возвращает данные в том же формате, что и внутри платформы. Однако стоит учитывать, что версия COM-компоненты может отличаться от версии ядра платформы, если компоненты не были обновлены.

⚠️ Внимание: При работе через COM убедитесь, что битность компонента (x86 или x64) совпадает с битностью вызывающего приложения, иначе свойство версии может быть недоступно.

Для скриптов VBScript или PowerShell получение версии выглядит как обращение к свойству объекта. Это позволяет автоматизировать проверку требований перед запуском тяжелых процедур обработки данных.

Версия технологического сервера и лицензий

В клиент-серверном варианте работы важно различать версию платформы, установленную на клиенте, и версию сервера 1С:Предприятие (серверный процесс rmngr и rphost). Иногда администраторам требуется узнать версию именно сервисов кластера.

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

Для проверки лицензий и их соответствия версии платформы используется объект Licenses (Лицензии). Анализ доступных лицензий помогает понять, какие функциональные блоки и на какой версии платформы они могут быть активированы.

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

Часто задаваемые вопросы (FAQ)

Как узнать минорную версию платформы без разбора строки?

К сожалению, встроенных свойств, возвращающих отдельные части версии (только мажорную или только минорную) в виде чисел, в глобальном контексте нет. Необходимо программно разбирать строку свойства Версия.

Меняется ли версия платформы при обновлении конфигурации?

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

Где посмотреть полную историю сборок платформы?

Полная информация о всех выпущенных сборках, исправленных ошибках и новых возможностях содержится в файле readme.txt, который поставляется в дистрибутиве платформы, а также в разделе «Технической поддержки» на сайте фирмы 1С.

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

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

Можно ли запустить старую конфигурацию на новой платформе?

В большинстве случаев да, платформа 1С обладает обратной совместимостью. Однако при значительном разрыве версий (например, запуск конфигурации для 8.2 на платформе 8.3.20) могут потребоваться процедуры обновления структуры базы данных.