1С:Библиотека стандартных подсистем
Новые возможности для разработчиков
Переход на версию 3.1.1 с версии 3.0.2
Переход на исправительные релизы 3.1.1
Особенности обновления с ранних версий
Версия 3.1.1 является новой редакцией продукта 1С:Библиотека стандартных подсистем. Версия 3.1.1 предназначена для разработки на платформе 1С:Предприятие версии 8.3.14 и выше с отключенным режимом совместимости с версией 8.3.14. Полный перечень нововведений см. ниже в разделе Новые возможности и изменения.
В состав библиотеки включена новая подсистема ИнтерфейсOData. Она позволяет настроить автоматический REST-сервис, с помощью которого сторонние приложения могут читать и изменять данные в информационной базе. Подробнее см. документацию. Для настройки сервиса можно воспользоваться командой в разделе Администрирование – Настройка синхронизации – Настройки стандартного интерфейса OData.
· Загрузка классификатора банков выполняется через единый механизм загрузки классификаторов – через Интернет-поддержку (раздел Администрирование – Интернет-поддержка и сервисы – Классификаторы, курсы валют – Обновление классификаторов).
· Предоставляется возможность скачивания файла обновления классификаторов с портала 1C:Обновление программ (https://releases.1c.ru/) и загрузки на другом компьютере, не имеющего доступа в Интернет.
· Для администраторов:
o вместо регламентного задания Загрузка классификатора банков предусмотрено регламентное задание Обновление классификаторов
o для загрузки классификатора вручную предусмотрена отдельная роль – Получение обновлений классификаторов.
Валюты
· Предусмотрено оперативное обновление классификатора валют через Интернет. Возможность предоставляется при наличии подключения к Интернет-поддержке (раздел Администрирование – Интернет-поддержка и сервисы – Классификаторы, курсы валют – Обновление классификаторов).
· Предоставляется возможность скачивания файла обновления классификаторов с портала 1C:Обновление программ (https://releases.1c.ru/) и загрузки на другом компьютере, не имеющего доступа в Интернет.
Контактная информация
· Предусмотрено оперативное обновление классификатора стран мира через Интернет. Возможность предоставляется при наличии подключения к Интернет-поддержке (раздел Администрирование – Интернет-поддержка и сервисы – Классификаторы, курсы валют – Обновление классификаторов).
· Предоставляется возможность скачивания файла обновления классификаторов с портала 1C:Обновление программ (https://releases.1c.ru/) и загрузки на другом компьютере, не имеющего доступа в Интернет.
Базовая функциональность
· В платформе 1С:Предприятие версии 8.3.13 появилась возможность проверять на клиенте некоторые свойства загружаемых файлов до их помещения на сервер. С целью поддержки новых возможностей для процедур ЗагрузитьФайл и ЗагрузитьФайлы общего модуля ФайловаяСистемаКлиент в состав свойств параметра ПараметрыЗагрузки добавлено свойство ДействиеПередНачаломПомещенияФайлов.
· В связи с появлением объекта ОписаниеПереданногоФайла в платформе 1С:Предприятие версии 8.3.13 в состав значения, возвращаемого асинхронной процедурой ФайловаяСистемаКлиент.ЗагрузитьФайлы, добавлены свойства ПолноеИмя и ИмяФайла.
· Для упрощения обработки ошибок при получении идентификаторов объектов метаданных по полному имени (когда полное имя может быть некорректным, например, получено из внешних источников), в функции ИдентификаторОбъектаМетаданных и ИдентификаторыОбъектовМетаданных общего модуля ОбщегоНазначения добавлен необязательный параметр ВызыватьИсключение (значение по умолчанию Истина).
· Функция СтрокаВДату программного интерфейса общего модуля СтроковыеФункцииКлиентСервер для преобразования дат со временем теперь поддерживает распознавание времени. Для этого добавлен второй необязательный параметр ЧастьДаты, который определяет возвращаемый вариант даты: дата, время, дата и время. По умолчанию, если этот параметр не задан, будет возвращена только дата.
Взаимодействия
· Для передачи параметров в процедуру ОткрытьФормуОтправкиSMS общего модуля ВзаимодействияКлиент предусмотрена функция-конструктор ПараметрыФормыОтправкиSMS в этом же модуле.
Работа с почтовыми сообщениями
· Для фильтрации небезопасного содержимого письма, в частности, скриптов и картинок, загружаемых из Интернета, предусмотрена процедура ОтключитьНебезопасноеСодержимое в общем модуле РаботаСПочтовымиСообщениями.
o Для обнаружения картинок письма, загружаемых из Интернета, предусмотрена функция ЕстьВнешниеРесурсы в общем модуле РаботаСПочтовымиСообщениями.
Шаблоны сообщений
· Для отправки письма, сформированного по шаблону, от произвольной учетной записи электронной почты в функции СформироватьСообщениеИОтправить программного интерфейса общего модуля ШаблоныСообщений в четвертом параметре ДополнительныеПараметры предусмотрено свойство УчетнаяЗапись.
Версия 3.1.1 предназначена для разработки на платформе 1С:Предприятие версии 8.3.14 и выше с отключенным режимом совместимости с версией 8.3.14. Поэтому предварительно необходимо адаптировать конфигурацию согласно списку изменений и порядку обновления технологической платформы версий 8.3.13 и 8.3.14. Минимальные требования к адаптации описаны в методике перевода конфигураций на платформу 1С:Предприятие 8.3.
В данной версии удалены объекты метаданных, которые были отмечены устаревшими более двух лет назад (в версии 2.3.3 и раньше), а также программный интерфейс, отмеченный устаревшим до версии 2.4.2.
Если ранее в конфигурации нерегулярно выполнялся переход с устаревшего программного интерфейса на актуальный, то перед обновлением следует найти и заменить все вызовы, указанные ниже в разделе Обязательные действия по переходу. Замены следует выполнять согласно инструкциям в документирующих комментариях к устаревшим процедурам и функциям. Для быстрого выявления нерекомендуемых вызовов устаревшего программного интерфейса также рекомендуется воспользоваться инструментом 1С:Автоматизированная проверка конфигурации (https://v8.1c.ru/acc/).
Порядок обновления конфигураций, включающих 1C:Библиотека технологии сервиса
Если в конфигурации используется 1С:Библиотека стандартных подсистем (БСП) совместно с 1C:Библиотека технологии сервиса (БТС), то порядок перехода следующий: для перехода на версию 3.1.1 необходимо также взять БТС версии 1.2 и в конфигураторе выполнить 5 шагов.
1. Выполнить команду Конфигурация – Поддержка – Обновить конфигурацию, указав в варианте Выбор файла обновления путь к файлу поставки БСП.
В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, снять флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК.
В окне сравнения и объединения конфигураций снять все флажки и отметить переносимые объекты с помощью команды Действия – Отметить по подсистемам новой конфигурации поставщика. Из группы «Стандартные подсистемы» выбрать:
· обязательные подсистемы согласно таблице 2.1 документации;
· дополнительные подсистемы, обязательные к переносу в конфигурацию для работы в модели сервиса, согласно таблице 2.2 документации;
· все ранее внедренные подсистемы, а также подсистемы, которые дополнительно требуется внедрить в вашу конфигурацию;
· подсистемы, от которых зависят отмеченные выше подсистемы, согласно таблицам 2.1–2.3 документации (https://its.1c.ru/db/bspdoc).
Далее нажать кнопку Установить.
Важно!
Необходимо убедиться, что в список отмеченных подсистем включены все обязательные подсистемы из таблицы 2.1 документации (вместе с относящимися к ним объектами метаданных). Если предполагается работа конфигурации в модели сервиса, то обязательными также являются подсистемы из таблицы 2.2 документации. В противном случае конфигурация окажется неработоспособной.
Если подсистема Администрирование была внедрена ранее или планируется ее внедрение, то отметить ее флажком в окне сравнения и объединения конфигураций (объект метаданных «подсистема»).
Выбрать режим объединения Взять из новой конфигурации поставщика (Действия – Установить режим для всех…).
Дополнительно нужно установить или снять флажки для отдельных объектов библиотеки и их свойств согласно инструкциям в таблице 2.6 документации. В зависимости от числа обновляемых и дополнительно устанавливаемых подсистем этот шаг может занять от 15 минут до одного часа.
2. Выполнить команду Конфигурация – Поддержка – Обновить конфигурацию, указав в варианте Выбор файла обновления путь к файлу поставки БТС.
В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, снять флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК.
В окне сравнения и объединения конфигураций снять все флажки и с помощью команды Действия – Отметить по подсистемам новой конфигурации поставщика отметить все объекты подсистемы ТехнологияСервиса.
Далее нажать кнопку Установить.
3. Выполнить команду Конфигурация – Поддержка – Настройка поддержки. В открывшейся форме Настройка поддержки выбрать значение БиблиотекаСтандартныхПодсистем в выпадающем списке Конфигурация поставщика и нажать на кнопку Сравнить, объединить.
В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, установить флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК.
В окне сравнения и объединения конфигураций снять все флажки и отметить подсистему СтандартныеПодсистемы со всеми подчиненными.
Далее нажать кнопку Выполнить.
4. Выполнить команду Конфигурация – Поддержка – Настройка поддержки. В открывшейся форме Настройка поддержки выбрать значение БиблиотекаТехнологииСервиса в выпадающем списке Конфигурация поставщика и нажать на кнопку Сравнить, объединить.
В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, установить флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК.
В окне сравнения и объединения конфигураций снять все флажки и отметить подсистему ТехнологияСервиса.
Далее нажать кнопку Выполнить.
5. В дереве конфигурации выполнить команду По подсистемам. В открывшемся окне Отбор по подсистемам снять все флажки в дереве подсистем, установить флажок напротив значения <Не входящие в подсистемы> и нажать кнопку Установить.
Удалить из конфигурации все объекты метаданных, которые не входят ни в одну подсистему и не стоят на поддержке ни одной из библиотек.
Обязательные действия по переходу
В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
· имена и состав параметров экспортных процедур и функций общих модулей, модулей объектов, менеджеров, наборов записей и т.п., которые размещены в области ПрограммныйИнтерфейс;
· имена и состав параметров всех экспортных процедур и функций переопределяемых общих модулей;
· имена объектов метаданных (включая их реквизиты, табличные части и пр.), к которым допускается непосредственное обращение из прикладного кода или из запросов.
В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки.
По каждой подсистеме приведены дополнительные инструкции, когда такая совместимость в силу исключительных причин не поддерживается, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf. В этой версии состав проверок был дополнительно расширен, чтобы выявлять больше типовых проблем внедрения.
· Удален устаревший программный интерфейс общих модулей:
o АдресныйКлассификатор:
§ КлассификаторЗагружен.
o АдресныйКлассификаторКлиент:
§ ОткрытьФормуПроверкиОбновления;
§ ОткрытьФормуЗагрузкиАдресногоКлассификатора.
· Удален устаревший программный интерфейс общих модулей:
o ОбщегоНазначения:
§ ПолучитьКартинкуКомментария;
§ ЗаполнитьМассивУникальнымиЗначениями;
§ Просклонять;
§ WSПрокси;
§ ПолучитьТаблицуОписанияСвойствОбъекта;
§ ПолучитьОбщийСписокИсключенийПоискаСсылок;
§ СкопироватьXDTO;
§ ПредставлениеТипаXDTO;
§ ХранилищеОбщихНастроекСохранитьМассивИОбновитьПовторноИспользуемыеЗначения;
§ ХранилищеОбщихНастроекСохранитьИОбновитьПовторноИспользуемыеЗначения;
§ ЗаблокироватьИБ;
§ РазблокироватьИБ;
§ ИмяТипаРегистрыСведений;
§ ИмяТипаРегистрыНакопления;
§ ИмяТипаРегистрыБухгалтерии;
§ ИмяТипаРегистрыРасчета;
§ ИмяТипаДокументы;
§ ИмяТипаСправочники;
§ ИмяТипаПеречисления;
§ ИмяТипаОтчеты;
§ ИмяТипаОбработки;
§ ИмяТипаПланыОбмена;
§ ИмяТипаПланыВидовХарактеристик;
§ ИмяТипаБизнесПроцессы;
§ ИмяТипаЗадачи;
§ ИмяТипаПланыСчетов;
§ ИмяТипаПланыВидовРасчета;
§ ИмяТипаКонстанты;
§ ИмяТипаЖурналыДокументов;
§ ИмяТипаПоследовательности;
§ ИмяТипаРегламентныеЗадания;
§ ИмяТипаПерерасчеты;
§ УстановитьРазделениеСеанса;
§ ЗначениеРазделителяСеанса;
§ УстановитьПараметрыРазделенияИнформационнойБазы;
§ ЗаписатьВспомогательныеДанные;
§ УдалитьВспомогательныеДанные;
§ ЭтоРазделенныйОбъектМетаданных.
o ОбщегоНазначенияВызовСервера:
§ ХранилищеОбщихНастроекСохранитьМассивИОбновитьПовторноИспользуемыеЗначения;
§ ХранилищеОбщихНастроекСохранитьИОбновитьПовторноИспользуемыеЗначения;
§ УстановитьРазделениеСеанса.
o ОбщегоНазначенияПереопределяемый:
§ ПараметрыРаботыКлиентаПриЗапуске;
§ ПараметрыРаботыКлиента.
o ОбщегоНазначенияПовтИсп:
§ ЭтоРазделеннаяКонфигурация;
§ РазделителиКонфигурации;
§ СоставОбщегоРеквизита;
§ ЭтоРазделенныйОбъектМетаданных;
§ РазделительОсновныхДанных;
§ РазделительВспомогательныхДанных;
§ РазделениеВключено;
§ ДоступноИспользованиеРазделенныхДанных;
§ ПолучитьПреобразованиеXSLИзОбщегоМакета;
§ СеансЗапущенБезРазделителей;
§ РежимРаботыПрограммы.
o СтандартныеПодсистемыСервер:
§ ЭтоОбъектНачальногоОбразаУзлаРИБ;
§ ПроверитьСоставПланаОбмена.
o СтроковыеФункцииКлиентСервер:
§ СтрокаИзМассиваПодстрок;
§ НайтиСимволСКонца;
§ ПолучитьПараметрыИзСтроки.
· Загрузка классификатора банков выполняется средствами библиотеки Интернет-поддержки пользователей (раздел Администрирование – Интернет-поддержка и сервисы – Классификаторы, курсы валют – Обновление классификаторов).
o Если она отсутствует в конфигурации, рекомендуется запланировать ее внедрение.
o Для возможности получения обновлений классификаторов предусмотрена отдельная роль – ПолучениеОбновленийКлассификаторов – в Библиотеке интернет-поддержки пользователей. Роль ДобавлениеИзменениеБанков не предоставляет доступ к обновлению классификатора банков. Необходимо учесть это изменение в имеющихся профилях групп доступа. Рекомендуется включить роль ПолучениеОбновленийКлассификаторов в профили, имеющие роль ДобавлениеИзменениеБанков.
· Удалена устаревшая функция ПолучитьДанныеКлассификатораРФ общего модуля РаботаСБанками.
· При наличии в конфигурации Библиотеки интернет-поддержки пользователей необходимо удалить ранее выполненные вставки кода подсистемы Банки из процедур ПриСохраненииДанныхАутентификацииПользователяИнтернетПоддержки и ПриУдаленииДанныхАутентификацииПользователяИнтернетПоддержки общего модуля ИнтернетПоддержкаПользователейПереопределяемый.
· Удален устаревший программный интерфейс общего модуля БизнесПроцессыИЗадачиВызовСервера:
o УведомитьИсполнителейОНовыхЗадачах
o ПроконтролироватьЗадачи
· Удалена устаревшая функция ПересчитатьИзВалютыВВалюту общего модуля РаботаСКурсамиВалютКлиентСервер.
· При наличии в конфигурации Библиотеки интернет-поддержки пользователей необходимо удалить ранее выполненные вставки кода подсистемы Валюты из процедур ПриСохраненииДанныхАутентификацииПользователяИнтернетПоддержки и ПриУдаленииДанныхАутентификацииПользователяИнтернетПоддержки общего модуля ИнтернетПоддержкаПользователейПереопределяемый.
· Удален устаревший программный интерфейс общего модуля ВариантыОтчетов:
o ИспользуемыеРазделы
o ДобавитьОбработчикиПолногоОбновления
o ПолучитьСсылку
· Удалена устаревшая процедура ОткрытьФормуОтправкиПочтовогоСообщения общего модуля ВзаимодействияКлиент.
· Удален устаревший программный интерфейс общих модулей:
o ДополнительныеОтчетыИОбработки:
§ ПолучитьОбъектВнешнейОбработки;
§ ПриСозданииНаСервере;
§ ВыполнитьНазначаемуюКомандуНаСервере.
o ДополнительныеОтчетыИОбработкиВызовСервера:
§ ПолучитьОбъектВнешнейОбработки.
o ДополнительныеОтчетыИОбработкиКлиент
§ ПоказатьРезультатВыполненияКоманды;
§ ВыполнитьНазначаемуюКомандуНаКлиенте.
o ДополнительныеОтчетыИОбработкиКлиентСервер:
§ ТипКомандыСценарийВБезопасномРежиме.
· Удалены общие модули, содержавшие устаревший программный интерфейс:
o ДополнительныеОтчетыИОбработкиВБезопасномРежимеИнтерфейс;
o ДополнительныеОтчетыИОбработкиРегламентныеЗадания
· Удалена устаревшая функция ПолучитьИспользованиеСобытияДоступ общего модуля ЗащитаПерсональныхДанных.
· Удален устаревший программный интерфейс общего модуля УправлениеКонтактнойИнформацией:
o ЗначенияКонтактнойИнформацииОбъекта;
o ТаблицаКонтактнойИнформацииОбъекта;
o ЗаполнитьКонтактнуюИнформациюОбъектов;
o ЗаполнитьКонтактнуюИнформациюОбъекта;
o ПредыдущийФорматКонтактнойИнформацииXML;
o ПредыдущаяСтруктураКонтактнойИнформацииXML;
o АдресВФорматеКЛАДР;
o СведенияОбАдресах;
o СведенияОбАдресе;
o РегионАдресаКонтактнойИнформации;
o ГородАдресаКонтактнойИнформации;
o ПроверитьАдрес;
o ПараметрыКонтактнойИнформацией.
· В связи с изменением поведения платформы 1С: Предприятие версии 8.3.13 в модулях форм c внедренной контактной информацией у ранее размещенных процедур Подключаемый_ОбновитьКонтактнуюИнформацию необходимо добавить ключевое слово Экспорт
o Было:
Процедура Подключаемый_ОбновитьКонтактнуюИнформацию(Результат)
o Стало:
Процедура Подключаемый_ОбновитьКонтактнуюИнформацию(Результат) Экспорт
· Удален устаревший программный интерфейс общего модуля КалендарныеГрафики:
o ПолучитьМассивДатПоКалендарю;
o ПолучитьДатуПоКалендарю;
o ПолучитьРазностьДатПоКалендарю;
o ПроизводственныйКалендарьРоссийскойФедерации;
o ПолучитьДатыРабочихДней.
· Удален общий модуль НапоминанияПользователяКлиентСерверПереопределяемый, содержавший устаревший программный интерфейс.
· В состав определяемого типа КонечнаяТочкаОбменаСообщениями необходимо включить план обмена ОбменСообщениями из Библиотеки технологии сервиса.
· Удалена устаревшая процедура ПриОтключенииОбработчиковОбновления общего модуля ОбновлениеИнформационнойБазыПереопределяемый.
· Удален устаревший программный интерфейс общих модулей:
o УправлениеПечатью:
§ ПолучитьЛокальныйКаталогФайловПечати;
§ ПриСозданииНаСервере.
o УправлениеПечатьюКлиент:
§ ВыполнитьПодключаемуюКомандуПечати;
§ НачатьОбновлениеКоманд.
o УправлениеПечатьюКлиентСервер:
§ ОбновитьКоманды.
В связи с изменением поведения платформы 1C:Предприятие 8.3.13, у ранее размещенных в модулях форм процедур Подключаемый_ВыполнитьКомандуНаСервере необходимо добавить ключевое слово Экспорт
· Было:
Процедура Подключаемый_ВыполнитьКомандуНаСервере(Контекст, Результат)
· Стало:
Процедура Подключаемый_ВыполнитьКомандуНаСервере(Контекст, Результат) Экспорт
· Удален устаревший программный интерфейс общего модуля Пользователи:
o ПрочитатьПользователяИБ;
o ЗаписатьПользователяИБ;
o РольАдминистратораСистемы.
· Удален устаревший программный интерфейс общего модуля ПрефиксацияОбъектовКлиентСервер:
o ПолучитьПользовательскийПрефикс;
o ПрефиксацияОбъектовКлиентСервер;
o ПолучитьНомерНаПечать.
· Удален устаревший программный интерфейс общего модуля РаботаВБезопасномРежиме:
o ВыполнитьМетодКонфигурации;
o ВыполнитьМетодОбъекта;
o ВыполнитьВБезопасномРежиме;
o ВычислитьВБезопасномРежиме.
· Удалены общие модули, содержавшие устаревший программный интерфейс:
o ПрисоединенныеФайлы;
o ПрисоединенныеФайлыКлиент;
o ПрисоединенныеФайлыКлиентСервер;
o ФайловыеФункции.
· Процедура ПриИзмененииПредставления общего модуля СклонениеПредставленийОбъектовКлиент более не поддерживается. В модулях форм объектов склонений, где она вызывается, необходимо:
o заменить ее вызов вызовом процедуры ПросклонятьПредставление общего модуля СклонениеПредставленийОбъектовКлиент,
o удалить процедуру Подключаемый_ПросклонятьПредставлениеПоВсемПадежам.
· Удален программный интерфейс общего модуля ФизическиеЛицаКлиентСервер:
o ФамилияИмяОтчество;
o ФамилияИнициалыФизЛица.
Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
Базовая функциональность
· Процедуры ЭтоOSXКлиент общих модулей ОбщегоНазначения и ОбщегоНазначенияКлиент устарели, вместо них рекомендуется использовать ЭтоMacOSКлиент этих же общих модулей. Рекомендуется пересмотреть места вызовов этой процедуры.
Валюты
· Предусмотрено оперативное обновление классификатора валют через Интернет. Возможность предоставляется при наличии в конфигурации библиотеки Интернет-поддержки пользователей (раздел Администрирование – Интернет-поддержка и сервисы – Классификаторы, курсы валют – Обновление классификаторов). Если она отсутствует в конфигурации, рекомендуется запланировать ее внедрение.
Контактная информация
· Предусмотрено оперативное обновление классификатора стран мира через Интернет. Возможность предоставляется при наличии в конфигурации библиотеки Интернет-поддержки пользователей (раздел Администрирование – Интернет-поддержка и сервисы – Классификаторы, курсы валют – Обновление классификаторов). Если она отсутствует в конфигурации, рекомендуется запланировать ее внедрение.
Настройки программы
· Рекомендуется перенести в конфигурацию код модулей форм всех панелей администрирования, объединив его с собственными изменениями этих форм.
Склонение представлений объектов
· Процедура ПриЗаписиНаСервере общего модуля СклонениеПредставленийОбъектов устарела, вместо нее рекомендуется использовать ПриЗаписиФормыОбъектаСклонения этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.
· Процедура ПросклонятьФИОСПомощьюКомпоненты общего модуля СклонениеПредставленийОбъектов устарела, вместо нее рекомендуется использовать ПросклонятьФИО этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.
· Процедура ПросклонятьПредставлениеПоВсемПадежам общего модуля СклонениеПредставленийОбъектовКлиент устарела, вместо нее рекомендуется использовать ПросклонятьПредставление этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.
· Процедура ОбработатьКомандуСклонения общего модуля СклонениеПредставленийОбъектовКлиент устарела, вместо нее рекомендуется использовать ПоказатьСклонение этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.
Управление доступом
· Упрощен программный интерфейс процедуры ПриСозданииФормыЗначенияДоступа общего модуля УправлениеДоступом.
o Теперь вместо 5 параметров используется только 2, где второй параметр это структура, содержащая редко используемые параметры.
o Параметры Реквизит, Элементы, ТипЗначения, СозданиеНового отмечены как устаревшие и оставлены для обратной совместимости. Вместо них следует использовать структуру ДополнительныеПараметры передаваемую вторым параметром. Следует проверить все места использования.
o Для параметра ДополнительныеПараметры предусмотрена функция-конструктор ПараметрыПриСозданииФормыЗначенияДоступа в общем модуле УправлениеДоступом.
Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.1.1, 3.1.1.20, 3.1.1.300 и т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
Ограничение обновления с версий меньше 2.3.3
Обновление на версию 3.1.1 допустимо с версии 2.3.3 и больше. Если в конфигурацию встроена более старая версия библиотеки, то разработчику необходимо запретить прямой переход на новую версию конфигурации (на базе версии 3.1.1 библиотеки) и организовать его через промежуточную версию с обязательным запуском для выполнения обработчиков обновления (включая отложенные).
Например, в конфигурации версии 1.1.1 и больше используется версия БСП 2.3.3, а в новую версию 1.2.1 встраивается версия БСП 3.1.1, тогда:
1) Если релизы конфигурации публикуются на портале 1С:Обновление программ (https://releases.1c.ru), то при публикации новой версии 1.2.1 в свойстве Минимальная версия для запуска обработчиков указать тот номер версии, в которой используется БСП 2.3.3 (в данном примере – 1.1.1). Тогда при обновлении конфигурации в режиме предприятия автоматически будет выполнен требуемый обязательный запуск.
2) Дополнительно для случаев, когда обновление выполняется через конфигуратор, в целях предотвращения некорректной ситуации также следует предусмотреть вывод предупреждения в процедуре ПриОпределенииВозможностиОбновления общего модуля ОбновлениеИнформационнойБазыКлиентПереопределяемый:
Процедура ПриОпределенииВозможностиОбновления(Знач ВерсияДанных) Экспорт
ДопустимаяВерсия = "1.1.1";
ВерсияДанныхБезНомераСборки = ОбщегоНазначенияКлиентСервер.ВерсияКонфигурацииБезНомераСборки(ВерсияДанных);
Результат = ОбщегоНазначенияКлиентСервер.СравнитьВерсииБезНомераСборки(ВерсияДанныхБезНомераСборки, ДопустимаяВерсия);
Если ВерсияДанных <> "0.0.0.0" И Результат < 0 Тогда
Сообщение = НСтр("ru = 'Недопустимая попытка обновления с версии %2.
|Обновление допустимо только с версии %1 и выше.
|Необходимо восстановить информационную базу из резервной копии
|и повторить обновление согласно файлу 1cv8upd.htm'");
Сообщение = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(Сообщение, ДопустимаяВерсия, ВерсияДанных);
ВызватьИсключение Сообщение;
КонецЕсли;
КонецПроцедуры
Порядок обновления с версий 2.3.3 – 3.0.1
При обновлении с ранних версий библиотеки (до 3.0.1) следует
· выполнить в конфигураторе сравнение/объединение с файлов поставки последней версии библиотеки (на которую выполняется переход);
· и затем последовательно выполнить инструкции из всех разделов Переход с предыдущих версий для каждой пропущенной версии.
Например, если выполняется обновление с версии 3.0.1.1 сразу на версию 3.1.1.123, то следует последовательно выполнить инструкции всех разделов:
· Переход на версию 3.0.1 с предыдущих версий 3.0.1;
· Переход на версию 3.0.2 с версии 3.0.2;
· Переход на версию 3.1.1 с версии 3.0.2.