1С:Библиотека стандартных подсистем, редакция 3.2. Новое в версиях

Версия 3.2.1

Версия 3.2.1

Версия 3.2.1 является новой редакцией продукта 1С:Библиотека стандартных подсистем. Она предназначена для разработки на платформе 1С:Предприятие 8.5.1 и выше в режиме совместимости Версия 8.5.1. Поддерживаемые варианты интерфейса - Версия 8.5 и Такси. Полный перечень нововведений см. ниже в разделах Новые возможности и изменения (для пользователей) и Новые возможности для разработчиков. Также для разработчиков приведены инструкции в разделе Переход на версию 3.2.1 с версии 3.1.12, которые включают в себя обязательные действия по переходу.

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

Новые возможности и изменения в версии 3.2.1

Обновление версии ИБ

Электронная подпись

Новые возможности для разработчиков в версии 3.2.1

Базовая функциональность

Напоминания пользователя

Подключаемые команды

Печать

Текущие дела

Управление доступом

Переход на версию 3.2.1 с версии 3.1.12

Обязательные действия по переходу

В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).

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

Измененные локализуемые общие модули:

Удаленные локализуемые общие модули:

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

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

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

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

Адресный классификатор
Базовая функциональность
    &НаКлиенте
    Процедура Подключаемый_ОбработатьДействиеИнформационногоСообщения(ЭлементИлиКоманда, НавигационнаяСсылка = Неопределено, СтандартнаяОбработка = Неопределено)
      ОбщегоНазначенияКлиент.ОбработатьДействиеИнформационногоСообщения(ЭтотОбъект, ЭлементИлиКоманда, НавигационнаяСсылка, СтандартнаяОбработка);
    КонецПроцедуры
Бизнес-процессы и задачи
Взаимодействия
Даты запрета изменения
Дополнительные отчеты и обработки
Запрет редактирования реквизитов объектов
Защита персональных данных
Контактная информация
Контроль ведения учета
Обмен данными
Обновление версии ИБ
Оценка производительности
Печать
Полнотекстовый поиск
Получение файлов из Интернета
Пользователи
Работа с почтовыми сообщениями
Работа с файлами
Рассылка отчетов
Свойства
Склонение представлений объектов
Структура подчиненности
Удаление помеченных объектов
Управление доступом
Учет оригиналов первичных документов
Шаблоны сообщений
Электронная подпись

Необязательные действия по переходу

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

Свойства
Контактная информация
Контроль ведения учета

Подключаемые команды

Для автоматического добавления обработчика события необходимо воспользоваться обработкой ПереходНаВерсию321.epf, входящей в дистрибутив.

Получение файлов из Интернета

Особенности обновления с ранних версий на версию 3.2.1

При обновлении с ранних версий библиотеки (до 3.2.1) следует:

Ограничение обновления с версий меньше 3.0.3

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

Например, в конфигурации версии 1.1.1 и больше используется версия БСП 3.0.3, а в новую версию 1.2.1 встраивается версия БСП 3.2.1, тогда:

  1. Если релизы конфигурации публикуются на портале 1С:Обновление программ (https://releases.1c.ru), то при публикации новой версии 1.2.1 в свойстве Минимальная версия для запуска обработчиков указать тот номер версии, в которой используется БСП 3.0.3 (в данном примере – 1.1.1). Тогда при обновлении конфигурации в режиме предприятия автоматически будет выполнен требуемый обязательный запуск.
  2. Дополнительно для случаев, когда обновление выполняется через конфигуратор, в целях предотвращения некорректной ситуации также следует предусмотреть вывод предупреждения в процедуре ПриОпределенииВозможностиОбновления общего модуля ОбновлениеИнформационнойБазыКлиентПереопределяемый:
Процедура ПриОпределенииВозможностиОбновления(Знач ВерсияДанных) Экспорт
    
    ДопустимаяВерсия = "1.1.1";
    
    ВерсияДанныхБезНомераСборки = ОбщегоНазначенияКлиентСервер.ВерсияКонфигурацииБезНомераСборки(ВерсияДанных);
    Результат = ОбщегоНазначенияКлиентСервер.СравнитьВерсииБезНомераСборки(ВерсияДанныхБезНомераСборки, ДопустимаяВерсия);
    Если ВерсияДанных <> "0.0.0.0" И Результат < 0 Тогда
        Сообщение = НСтр("ru = 'Недопустимая попытка обновления с версии %2. 
            |Обновление допустимо только с версии %1 и выше.
            |Необходимо восстановить информационную базу из резервной копии
            |и повторить обновление согласно файлу 1cv8upd.htm'");
        Сообщение = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(Сообщение, ДопустимаяВерсия, ВерсияДанных);
        ВызватьИсключение Сообщение;
    КонецЕсли;
    
КонецПроцедуры

Переход на исправительные релизы 3.2.1

Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.2.1.1, 3.2.1.20, 3.2.1.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).

Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.

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

После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.

С версии 3.2.1.250 и меньше

Адресный классификатор
Работа с почтовыми сообщениями
Работа с файлами
Электронная подпись