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

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

Как проверить версию БСП в 1С

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

Библиотека стандартных подсистем (БСП) — это фундамент большинства типовых конфигураций 1С: Бухгалтерии предприятия, Зарплаты и управления персоналом, Управления торговлей и многих отраслевых решений. Версия БСП определяет, какие механизмы доступны конфигурации: обмен данными, обновление, работа с файлами, права доступа и десятки других подсистем. Поэтому вопрос «какая версия БСП используется» возникает регулярно — при обновлении конфигурации, установке расширений, анализе ошибок и интеграции со сторонними решениями.

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

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

Что такое версия БСП и зачем её знать

БСП развивается собственными релизами с нумерацией вида 3.1.x.xxx. Каждая типовая конфигурация 1С внедряет конкретную версию библиотеки, причём не всегда самую свежую: вендор обновляет БСП в составе конфигураций с задержкой. Поэтому версия БСП и версия конфигурации — разные вещи, и путать их нельзя.

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

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

Проверка версии БСП в конфигураторе

Самый надёжный способ — посмотреть версию непосредственно в дереве конфигурации. Для этого нужны права на запуск конфигуратора и доступ к конфигурации базы (не только к поставщику).

Откройте конфигуратор, перейдите в меню «Конфигурация → Открыть конфигурацию» и дождитесь построения дерева метаданных. Далее есть два равнозначных пути. Первый: найдите общий модуль ОбновлениеИнформационнойБазыБСП — в нём обычно размещены процедуры, связанные с версией библиотеки, и в комментариях или в процедуре регистрации версий указан номер релиза БСП. Второй: откройте общий модуль СтандартныеПодсистемыПовтИсп и найдите функцию, возвращающую версию библиотеки — в актуальных релизах она называется ВерсияБиблиотеки().

Дополнительно версию можно увидеть через свойства конфигурации, если разработчик заполнил поле «Версия» — но учтите, что там указывается версия прикладной конфигурации (например, 3.0.xxx.xx для Бухгалтерии), а не версия БСП. Это частая причина путаницы.

Порядок действий в конфигураторе
  1. 1
    Запустите конфигуратор нужной информационной базы
  2. 2
    Откройте конфигурацию: Конфигурация → Открыть конфигурацию
  3. 3
    Найдите общий модуль СтандартныеПодсистемыПовтИсп
  4. 4
    Найдите функцию ВерсияБиблиотеки() и посмотрите возвращаемое значение
  5. 5
    Сверьте результат с константой версии в пользовательском режиме

Программное получение версии БСП

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

Выполните следующий код в консоли кода, внешней обработке или через отладку:

ВерсияБСП = СтандартныеПодсистемыПовтИсп.ВерсияБиблиотеки();

Сообщить(ВерсияБСП);

bsl
ВерсияБСП = СтандартныеПодсистемыПовтИсп.ВерсияБиблиотеки();
Сообщить("Версия БСП: " + ВерсияБСП);
// Альтернатива без повторного использования:
// ВерсияБСП = СтандартныеПодсистемыСервер.ВерсияБиблиотеки();

Функция вернёт строку вида «3.1.x.xxx». Если вызов завершился ошибкой «Процедура или функция с указанным именем не определена», это означает одно из двух: либо конфигурация построена на очень старой версии БСП, где функция называлась иначе, либо библиотека внедрена частично и модуль отсутствует. В таком случае проверьте наличие самого общего модуля СтандартныеПодсистемыПовтИсп в дереве конфигурации.

Для старых релизов (линейка 2.x и ранее) версия библиотеки могла храниться иначе — например, возвращаться функцией ПолучитьВерсиюБСП() или фиксироваться только в константе. Если конфигурация древняя, ориентируйтесь на константу и на документацию поставки.

Проверка версии в пользовательском режиме

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

Типовой путь: раздел «Администрирование» → «Обслуживание» → «Информация о программе» (в некоторых конфигурациях — «Поддержка и сервис» → сведения о версиях). В открывшейся форме выводится версия конфигурации, версия платформы и версия библиотеки стандартных подсистем. Если такого пункта нет, значит, конфигурация сильно доработана или построена на старом релизе БСП.

Второй источник — константа, в которой БСП фиксирует результат обновления информационной базы. Она называется «Версия библиотеки стандартных подсистем» (внутреннее имя может отличаться в зависимости от релиза). Посмотреть её можно через «Все функции → Константы», если у пользователя есть соответствующие права, либо через стандартную обработку редактирования констант.

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

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

Во-первых, сопоставьте значения из двух независимых источников: из модуля СтандартныеПодсистемыПовтИсп и из константы. Если они совпадают — версия достоверна. Во-вторых, проверьте формат: версия БСП выглядит как четырёхкомпонентный номер (3.1.x.xxx), тогда как версия платформы имеет вид 8.3.xx.xxxx, а версия конфигурации обычно трёхкомпонентная. Смешение этих номеров — самая частая ошибка.

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

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

Формат номера
Норма

Четыре компонента, например 3.1.x.xxx

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

Формат 8.3.xx.xxxx — это версия платформы, а не БСП

Совпадение источников
Норма

Код и константа дают одинаковое значение

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

Значения различаются — обновление ИБ не завершено

Источник данных
Норма

Модуль СтандартныеПодсистемыПовтИсп или константа версии БСП

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

Свойство «Версия» конфигурации — это версия прикладного решения

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

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

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

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

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

Типичные ошибки
01
Путать версию конфигурации с версией БСП — приводит к неверному выбору расширений и обработок
02
Смотреть версию платформы 8.3.x вместо версии библиотеки — номера никак не связаны
03
Доверять константе сразу после обновления, не дождавшись отработки обработчиков обновления ИБ
04
Судить о версии БСП по документации поставки в сильно доработанной конфигурации

Когда версию БСП нужно обновлять и чем это грозит

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

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

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

FAQ

Где посмотреть версию БСП, если нет доступа к конфигуратору?

Откройте в режиме предприятия раздел «Администрирование → Обслуживание → Информация о программе» — там выводится версия библиотеки. Альтернатива — константа «Версия библиотеки стандартных подсистем» через «Все функции → Константы» при наличии прав.

Чем версия БСП отличается от версии конфигурации?

Версия конфигурации — это номер релиза прикладного решения (например, Бухгалтерии предприятия), а версия БСП — номер внедрённой в него библиотеки стандартных подсистем. Они обновляются независимо и имеют разную нумерацию.

Почему функция ВерсияБиблиотеки() выдаёт ошибку?

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

Версия в константе и в коде различаются — это нормально?

Да, если обновление конфигурации выполнено недавно. Константа обновляется при запуске в режиме предприятия после отработки обработчиков обновления ИБ. Дождитесь завершения обновления (включая отложенные обработчики) и сверьте значения снова.

Можно ли обновить БСП отдельно от конфигурации?

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

Как узнать версию БСП в базе, к которой есть только доступ по веб-клиенту?

Используйте отчёт «Информация о программе» в разделе администрирования — он доступен и в веб-клиенте. Если его нет, попросите пользователя с правами администратора открыть константу версии библиотеки через «Все функции».

Итог

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

Версию БСП надёжнее всего смотреть в модуле СтандартныеПодсистемыПовтИсп через конфигуратор или программным вызовом ВерсияБиблиотеки(). В пользовательском режиме помогут отчёт «Информация о программе» и константа версии. Не путайте версию библиотеки с версией конфигурации и платформы, а после обновления дожидайтесь завершения обработчиков обновления ИБ перед сверкой.