Версия 3.1.10 предназначена для разработки на платформе 1С:Предприятие 8.3.21 и выше в режимах совместимости Версия 8.3.21, Версия 8.3.22, Версия 8.3.23 и Версия 8.3.24.
Существенно расширена и переименована подсистема Анализ журнала регистрации, которая теперь называется Контроль работы пользователей:
Полный перечень нововведений в других подсистемах см. ниже.
При разработке конфигураций на более новых версиях платформы 1С:Предприятие больше 8.3.24 некоторые новые возможности этих версий могут быть не доступны или вызывать программные ошибки, т.к. данная версия библиотеки не адаптирована для них. Например, появление в конфигурации нового вида объекта метаданных может вызвать сбой в алгоритмах библиотеки, которые на него не рассчитаны. Аналогично, не рекомендуется вести разработку или подключать расширения конфигурации с режимами совместимости больше 8.3.24 в конфигурации на базе данной версии библиотеки. Для таких разработок следует использовать следующую версию библиотеки, которая рассчитана на новые режимы совместимости и возможности платформы 1С:Предприятие.
АдресныйКлассификатор предусмотрена функция ПроверитьОКТМОБюджетополучателя. Для работы функции требуется подключение к Интернет-поддержке пользователей и наличие постоянного соединения с интернетом. Подробнее см. комментарии к этой функции.АдресныйКлассификатор расширен функцией РазрешенДоступВИнтернет. ВыполнитьФункцию, ВыполнитьПроцедуру, ВыполнитьФункциюВНесколькоПотоков, ВыполнитьПроцедуруВНесколькоПотоков и ВыполнитьВФоне общего модуля ДлительныеОперации:
ИнформацияОбОшибке типа ИнформацияОбОшибке, а строковые свойства КраткоеПредставлениеОшибки и ПодробноеПредставлениеОшибки отмечены как устаревшие и оставлены для обратной совместимости. Также свойство ИнформацияОбОшибке возвращается функцией ДлительныеОперации.ЗаданиеВыполнено и возвращается в результате, передаваемом в процедуру оповещения, которая указана в параметре ОповещениеОЗавершении процедуры ДлительныеОперацииКлиент.ОжидатьЗавершение.СтандартныеПодсистемыКлиент.ВывестиИнформациюОбОшибке вместо метода платформы ПоказатьИнформациюОбОшибке или показа предупреждений. Функция требуется для перехвата исключений системами автоматического тестирования (так как при вызове метода платформы ПоказатьИнформациюОбОшибке не срабатывает обработчик события ОбработкаОтображенияОшибки модуля приложения).ОбщиеПараметры.ВыводитьПолныйСтекПриОшибкеДлительнойОперации процедуры ОбщегоНазначенияПереопределяемый.ПриОпределенииОбщихПараметровБазовойФункциональности задать значение Истина, то в информацию об ошибке для разработчика дополнительно включается фрагмент стека запуска длительной операции (до старта фонового задания). По умолчанию Ложь, чтобы не мешать отладке при остановке по ошибке.ОбщегоНазначения.ЗаменитьСсылки расширен свойством ИнформацияОбОшибке типа ИнформацияОбОшибке. Теперь информацию об ошибке можно показывать штатными средствами в вызывающем коде, а также отправлять в сервис регистрации ошибок.ДлительныеОперацииКлиент.ПараметрыОжидания предусмотрен параметр ЗаголовокКнопкиОтмена.ФизическиеЛицаКлиентСерверЛокализация размещена процедура ПриОпределенииЧастейПолногоИмени, которая позволяет переопределить работу функции ЧастиИмени общего модуля ФизическиеЛицаКлиентСервер в зависимости от национальной специфики.ЧастиИмени общего модуля ФизическиеЛицаКлиентСервер:
ПолноеИмя на входе принимается в двух форматах: “Фамилия,Имя,Отчество” (по умолчанию) и “Имя,Отчество,Фамилия”, задается в параметре ФорматИмени;ФизическиеЛицаКлиентСерверЛокализация размещена процедура ПриОпределенииФамилииИнициалов, которая позволяет переопределить работу функции ФамилияИнициалы общего модуля ФизическиеЛицаКлиентСервер в зависимости от национальной специфики.ФамилияИнициалы общего модуля ФизическиеЛицаКлиентСервер:
ПолноеИмя на входе принимается в двух форматах: “Фамилия,Имя,Отчество” (по умолчанию) и “Имя,Отчество,Фамилия”, задается в параметре ФорматПолногоИмени;ИнициалыВНачале.ОбщегоНазначенияКлиентСервер.НовоеЗащищенноеСоединение предусмотрен параметр ВидСоединения.Результат процедур-обработчиков прогресса и завершения длительных операций рекомендуется использовать функции:
ДлительныеОперацииКлиент.НовыйРезультатДлительнойОперации для значения передаваемого в процедуру завершения длительной операции, указанной в параметре ОповещениеОЗавершении процедуры ДлительныеОперацииКлиент.ОжидатьЗавершение.ДлительныеОперацииКлиент.НовоеСостояниеДлительнойОперации для значения передаваемого в процедуру оповещения о прогрессе длительной операции, указанной в свойстве ОповещениеОПрогрессеВыполнения функции ДлительныеОперацииКлиент.ПараметрыОжидания. Например:// Параметры:
// Результат - см. ДлительныеОперацииКлиент.НовыйРезультатДлительнойОперации
// ДополнительныеПараметры - Неопределено
//
&НаКлиенте
Процедура ПрименитьПравилаЗавершение(Результат, ДополнительныеПараметры) ЭкспортОбщегоНазначения.ТекстОбъединитьВсе, по аналогии с функцией ОбщегоНазначения.РазделительПакетаЗапросов.СпискиЗначенийИдентичны общего модуля ОбщегоНазначенияКлиентСервер.СпискиЗначенийИдентичны общего модуля ОбщегоНазначенияКлиентСервер добавлен параметр СравниватьКоличествоЗначений.ТолькоСимволыНациональногоАлфавитаВСтроке в общем модуле СтроковыеФункцииКлиентСервер. Например, ее можно использовать для проверки правильности написания ФИО.СтроковыеФункцииКлиентСерверЛокализация размещены процедуры:
ПриОпределенииСимволовНациональногоАлфавита, которая позволяет переопределить работу функции ТолькоСимволыНациональногоАлфавитаВСтроке общего модуля СтроковыеФункцииКлиентСервер в зависимости от национальной специфики.ПриОпределенииСимволовСлов, которая позволяет переопределить работу функции ЭтоРазделительСлов общего модуля СтроковыеФункцииКлиентСервер в зависимости от национальной специфики.ПроверкаВнедренияБСП.erf:
УдаленныйДоступOData: в конфигурациях, рассчитанных на работу в модели сервиса (по технологии 1С:Фреш) в роль включаются права на объекты, разделенные независимо и совместно. При этом исключаются объекты, которые исключены из выгрузки/загрузки при переходе в сервис из локальных решений.СформироватьСуммуПрописью общего модуля РаботаСКурсамиВалют позволяет выводить копейки прописью, для этого предусмотрен параметр ДробнаяЧастьПрописью.ОрганизацияПоУмолчанию общего модуля ЗащитаПерсональныхДанныхПереопределяемый рекомендуется разместить функцию ОрганизацияПоУмолчанию в модуле менеджера справочника, указанного в определяемом типе Организация. КалендарныеГрафикиЛокализация размещена процедура ПриПолученииДанныхКлассификатора, которая позволяет переопределить работу функции ДанныеКлассификатора общего модуля КалендарныеГрафики при получении файла с данными классификатора календарей в зависимости от национальной специфики. КалендарныеГрафики.БлижайшиеРабочиеДаты теперь может возвращать ближайшую рабочую дату по данным заполнения основного производственного календаря РФ по умолчанию, если календарь не заполнен. При этом будут учитываться нерабочие дни и правила переноса праздников. Для этого в возвращаемом значении КалендарныеГрафики.ПараметрыПолученияБлижайшихРабочихДат предусмотрено свойство ПолучатьДатыЕслиКалендарьНеЗаполнен. ПеревестиВТранслит функции УправлениеКонтактнойИнформацией.ПредставлениеКонтактнойИнформации теперь можно транслитерировать любую контактную информацию в латиницу. Это полезно, например, для вывода адресов в отчетах, печатных формах и рабочих местах, предназначенных для иностранных сотрудников и клиентов.ПроверкаВнедренияБСП.erf, добавлены проверки видов контактной информации в коде начального заполнения. Диагностируются ошибки если:
КонтрольРаботыПользователей предусмотрены функции НастройкиРегистрацииСобытийДоступаКДанным, РегистрироватьДоступКДанным и процедуры УстановитьНастройкиРегистрацииСобытийДоступаКДанным, УстановитьРегистрациюДоступаКДанным.МультиязычностьСервер расширен функциями СуффиксТекущегоЯзыка, СуффиксЯзыка, ИспользуетсяДополнительныйЯзык и ИменаРеквизитовСУчетомКодаЯзыка. Подробнее см. комментарии к ним и пример в процедуре ОбработкаПолученияДанныхВыбора модуля менеджера справочника _ДемоНоменклатура демонстрационной конфигурации.ДоступенПереводТекста в общем модуле ПереводТекстаНаДругиеЯзыки.Органайзер. При этом если подсистема Подключаемые команды отсутствует в конфигурации, то поведение прежнее.Идентификатор можно дополнительно уточнять вид создаваемого напоминания в процедуре НапомнитьВУказанноеВремя общего модуля НапоминанияПользователяКлиент. Подробности см. в описании к процедуре.Для упрощения записи в журнал регистрации ошибок при обработке данных в программном интерфейсе общего модуля ОбновлениеИнформационнойБазы размещена процедура ЗаписатьОшибкуВЖурналРегистрации. Подробнее см. в описании к ней. Например, вместо:
ТекстСообщения = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(
НСтр("ru = 'Не удалось обработать %1 по причине:
|%2'"),
ПредставлениеСсылки, ОбработкаОшибок.ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));
ЗаписьЖурналаРегистрации(ОбновлениеИнформационнойБазы.СобытиеЖурналаРегистрации(),
УровеньЖурналаРегистрации.Предупреждение, Метаданные.Справочники.КонтактныеЛицаПартнеров,
КонтактноеЛицоПартнера.Ссылка, ТекстСообщения);достаточно одного вызова:
ОбновлениеИнформационнойБазы.ЗаписатьОшибкуВЖурналРегистрации(КонтактноеЛицоПартнера.Ссылка, ПредставлениеСсылки, ИнформацияОбОшибке());Для упрощения разработки обработчиков обновления предопределенных элементов в общем модуле ОбновлениеИнформационнойБазы предусмотрена процедура ОбновитьПредопределенныеЭлементы. Она позволяет за один вызов добавить новые элементы и обновить существующие согласно их актуальному описанию в процедуре ПриНачальномЗаполненииЭлементов модуля менеджера объекта. При этом возможно обновлять как все элементы, так и выборочно указать, какие именно элементы и реквизиты объекта следует актуализировать. См. пример обработчика в демонстрационной конфигурации в процедуре АктуализироватьВидыКонтактнойИнформации общего модуля _ДемоОбновлениеИнформационнойБазыБСП.
ОбновлениеКонфигурации.УстановкаИУдалениеИсправлений можно устанавливать значение свойства ИспользуетсяВРаспределеннойИнформационнойБазе, чтобы сократить время установки расширений, когда они не требуются в распределенной информационной базе (РИБ). Для передачи параметров в функцию ОбновлениеКонфигурации.УстановкаИУдалениеИсправлений предусмотрена функция-конструктор ОбновлениеКонфигурации.ПараметрыУстановкиИсправлений.Отправить. См. пример в демонстрационной конфигурации в процедуре ПриОпределенииКомандПодключенныхКОбъекту общего модуля _ДемоСтандартныеПодсистемы.НайтиПохожиеСтроки общего модуля ПоискИУдалениеДублей теперь можно вызывать в безопасном режиме, например, из внешних обработок или расширений конфигурации. Для этого адаптирована функция ПараметрыПоискаПохожихСтрок общего модуля ПоискИУдалениеДублей.ДиагностикаСоединения общего модуля ПолучениеФайловИзИнтернета выполняет команду ping для определения доступности Интернет-ресурса. Однако в некоторых случаях ответ на команду ping на Интернет-ресурсе может быть отключен и диагностика соединения таким способом может вводить в заблуждение. Для отключения выполнения команды ping при диагностике предусмотрен параметр ПроверятьДоставкуПакетов. Это может быть полезно, когда заранее известно, что на запрашиваемом Интернет-ресурсе отключен ответ команды ping.
ПроверятьДоставкуПакетовПриОшибке в соответствующих параметрах функций:
СкачатьФайлНаСервере, СкачатьФайлВоВременноеХранилище общего модуля ПолучениеФайловИзИнтернета,СоздатьWSПрокси общего модуля ОбщегоНазначения,ПолучитьВерсииИнтерфейса общего модуля ОбщегоНазначения.ПолучениеФайловИзИнтернета добавлена функция ТаймаутЗагрузкиФайла. Ее рекомендуется вызывать при загрузке файлов без использования программного интерфейса подсистемы Получение файлов из Интернета (в которой уже встроен авторасчет таймаута).ПечатьДокументовПриСозданииНаСервере общего модуля УправлениеПечатьюПереопределяемый.Пример:
Процедура ПечатьДокументовПриСозданииНаСервере(Форма, Отказ, СтандартнаяОбработка) Экспорт
КомандаФормы = Форма.Команды.Добавить("МояКомандаОтправки");
КомандаФормы.Действие = "Подключаемый_ВыполнитьКоманду";
КомандаФормы.Заголовок = НСтр("ru = 'Моя команда отправки'");
КнопкаФормы = Форма.Элементы.Добавить(КомандаФормы.Имя, Тип("КнопкаФормы"), Форма.Элементы.ПодменюОтправить);
КнопкаФормы.Вид = ВидКнопкиФормы.КнопкаКоманднойПанели;
КнопкаФормы.ИмяКоманды = КомандаФормы.Имя;
КонецПроцедурыНовоеОписаниеОбщихНастроекВхода и НовоеОписаниеНастроекВхода теперь поддерживают возможности платформы 1С:Предприятие 8.3.26, доступные в общей форме НастройкиВхода. Установка значений этих свойств на предыдущих версиях платформы игнорируется, но сами значения сохраняются в константе НастройкиВходаПользователей.ПриОпределенииНастроекРегистрацииСобытийДоступаКДанным в общем модуле ПользователиПереопределяемый,НастройкиРегистрацииСобытийДоступаКДанным общего модуля Пользователи,ОбновитьНастройкиРегистрацииСобытийДоступаКДанным в общем модуле Пользователи. Они позволяют каждому механизму-потребителю хранить свои настройки отдельно, а при их изменении применять к информационной базе общий результат без случайного перетирания настроек других механизмов. При этом не следует самостоятельно отключать регистрацию события Доступ.Доступ, достаточно отключить свою часть настроек в ПользователиПереопределяемый.ПриОпределенииНастроекРегистрацииСобытийДоступаКДанным и вызвать Пользователи.ОбновитьНастройкиРегистрацииСобытийДоступаКДанным. При ошибке установки настроек Пользователи.ОбновитьНастройкиРегистрацииСобытийДоступаКДанным автоматически удаляет из настроек несуществующие имена полей, повторяет попытку установки и записывает в журнал регистрации событие Пользователи.Ошибка настройки события Доступ.Доступ с подробной информации и не вызывается исключение.Пользователи и ВнешниеПользователи при передаче свойства объекта ДополнительныеСвойства:
ДополнительныеСвойства передано свойство ОписаниеПользователяИБ, то его значение теперь учитывается в режиме ОбменДанными.Загрузка.ДополнительныеСвойства.ОписаниеПользователяИБ.Действие указано Записать, то с помощью свойства ДополнительныеСвойства.ОписаниеПользователяИБ.ТолькоОбновитьПользователяИБ можно запретить создавать пользователя информационной базы, если он не существует.Справочники.ГруппыПользователей.ВсеПользователи и Справочники.ГруппыВнешнихПользователей.ВсеВнешниеПользователи рекомендуется вызывать, соответственно, функции Пользователи.ГруппаВсеПользователи и ВнешниеПользователи.ГруппаВсеВнешниеПользователи.РаботаСФайлами предусмотрена функция ДвоичныеДанныеФайлов.СконвертироватьФайлыВПрисоединенные общего модуля РаботаСФайлами помечена как устаревшая, вместо нее добавлена процедура ПеренестиФайлыМеждуСправочникамиХранения. С ее помощью теперь возможно переносить присоединенные файлы объекта между таблицами хранения присоединенных файлов, например, при рефакторинге способа хранения файлов. Допустим в справочнике _ДемоНоменклатура решили хранить присоединенные файлы вместо справочника _ДемоНоменклатураПрисоединенныеФайлы в справочнике Файлы (или в обратную сторону) и необходимо в обработчике обновления организовать перенос файлов. Пример вызова см. Обработка._ДемоПереносПрисоединенныхФайлов.ОтправитьПисьмо, ОтправитьПисьма и ЗагрузитьПочтовыеСообщения в общем модуле РаботаСПочтовымиСообщениями. Помимо учетной записи в эти функции можно передавать также открытое соединение с почтовым сервером - объект ИнтернетПочта. Такая возможность полезна, например, при реализации собственного почтового клиента.ПодключениеКПочте в общем модуле РаботаСПочтовымиСообщениями.ПриОпределенииНастроек общего модуля РаботаСПочтовымиСообщениямиПереопределяемый предусмотрено свойство настроек ИспользоватьПротоколPOP3. В таком случае получение писем с почтового сервера будет выполняться только по протоколу IMAP, и перенастройка его на POP3 будет недоступна.ПараметрыОтправки в процедуре РаботаСПочтовымиСообщениямиКлиентПереопределяемый.ПередОткрытиемФормыОтправкиПисьма предусмотрено свойство ИнтерактивныйВыборПолучателей.ВыбратьШаблон общего модуля ШаблоныСообщенийКлиент во втором параметре ВидСообщения указать значение Произвольный. Пример использования таких шаблонов сообщений см. в демонстрационной конфигурации в форме ФормаДокумента документа _ДемоСписаниеБезналичныхДенежныхСредств.ЭлектроннаяПодписьПереопределяемый.ПриОпределенииНастроек. В ней можно указать, нужно ли выводить реквизит с типом ОпределяемыйТип.ФизическоеЛицо в справочнике СертификатыКлючейЭлектроннойПодписиИШифрования и отображать его в заявлении на сертификат электронной подписи.ЭлектроннаяПодписьКлиентСервер.РезультатПроверкиПодписиВФорме, в котором свойство РезультатПроверкиКраткий содержит результат проверки подписи с учетом данных проверки, хранящихся в базе, и заполняется с помощью процедуры ЭлектроннаяПодписьКлиентСервер.ЗаполнитьСтатусПодписи.СертификатыКлючейЭлектроннойПодписиИШифрования, в том числе по замене старого сертификата на новый, добавлена процедура ЭлектроннаяПодписьКлиентПереопределяемый.ПослеДобавленияВСправочникСертификатовЭлектроннойПодписи.ЭлектроннаяПодписьКлиент.ПроверитьСертификат и ЭлектроннаяПодпись.ПроверитьСертификат предусмотрен параметр ПараметрыПроверки и конструктор для него ЭлектроннаяПодписьКлиент.ПараметрыПроверкиСертификата. С помощью свойства ВыполнятьПроверкуУдостоверяющегоЦентра можно указать, требуется ли проверять сертификат по списку аккредитованных удостоверяющих центров, а с помощью свойства ИгнорироватьПроверкуВСпискеОтозванныхСертификатов - требуется ли проверка по списку отзыва.ДополнительныеПараметры процедуры ЭлектроннаяПодписьКлиент.ПроверитьСертификатСправочника также можно воспользоваться новыми свойствами ВыполнятьПроверкуУдостоверяющегоЦентра и ИгнорироватьПроверкуВСпискеОтозванныхСертификатов.ПроверятьСертификат в конструкторе ЭлектроннаяПодписьКлиент.ПараметрыПроверкиПодписи при вызове процедуры ЭлектроннаяПодписьКлиент.ПроверитьПодпись можно вообще отключать проверку сертификата, когда подпись неквалифицированная и используется только для проверки неизменности документа. А также, наоборот, можно включать проверку и указывать, должен ли сертификат подписи быть квалифицированным.ЭлектроннаяПодпись.ПроверитьПодпись в параметр для заполнения результата проверки подписи ЭлектроннаяПодписьКлиентСервер.РезультатПроверкиПодписи добавлено свойство ПараметрыПроверкиСертификата. АлгоритмШифрования в функцию ЭлектроннаяПодпись.Зашифровать и свойство АлгоритмШифрования в параметр ОписаниеДанных процедуры ЭлектроннаяПодписьКлиент.Зашифровать. Можно передавать явное название (“Магма”, “Кузнечик”, “ГОСТ 28147-89”), OID или представление алгоритма шифрования, которым будет переопределен алгоритм шифрования, заданный в настройках приложения.В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).
Для обновления следующих переопределяемых и локализуемых общих модулей требуется перенести из поставки библиотеки новые экспортные процедуры, удалить отсутствующие и убедиться, что комментарии, количество и имена параметров у процедур совпадают с поставкой библиотеки: - ЗащитаПерсональныхДанныхПереопределяемый, - ОбменДаннымиПереопределяемый, - ОбщегоНазначенияПереопределяемый, - ШаблоныСообщенийПереопределяемый.
Рекомендации по задействованию новых возможностей переопределяемых и локализуемых общих модулей приведены выше в разделе Новые возможности для разработчиков.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки. В исключительных (редких) случаях, когда такая совместимость не обеспечена, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки, в этом разделе приведены необходимые инструкции. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
СвойстваРасширений не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места, а также планов обмена, предназначенных для синхронизации данных между различными программами.Администрирование появилась дочерняя подсистема КонтрольРаботыПользователей, которую необходимо перенести в конфигурацию, чтобы в панели Отчеты администратора корректно группировались отчеты.ПодключаемыеКоманды, следует внедрить ее во все формы, в которых отображаются кнопки заметок.ИспользоватьКомандуЗаметки рекомендуется включать в планы обмена распределенной информационной базы (РИБ) и автономного рабочего места.НастройкиРегистрацииСобытийДоступаКДанным и РегистрироватьИзмененияПравДоступа не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места, а также планов обмена, предназначенных для синхронизации данных между различными программами.НастройкиПользователейИПрав обработки ПанельАдминистрированияБСП, если используется.ПодключаемыеКоманды, следует внедрить ее во все формы, в которых отображаются кнопки создания напоминаний.ИспользоватьКомандуНапоминаний рекомендуется включать в планы обмена распределенной информационной базы (РИБ) и автономного рабочего места.ИерархияГруппПользователей и СоставыГруппПользователей следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места только для создания начального образа (не включать в подписки на события), а также не следует включать в планы обмена, предназначенные для синхронизации данных между различными программами.Пользователи.СохраняемоеЗначениеСтрокиПароля следует дополнить вызовом методов платформы ВычислитьСохраняемоеЗначениеПароляПользователя или ПроверитьСоответствиеПароляПользователяСохраняемомуЗначению по схеме, как указано в примере к функции. Это требуется для случаев, когда администратор приложения выбрал алгоритм хеширования паролей, отличный от SHA-1. В будущих версиях функция Пользователи.СохраняемоеЗначениеСтрокиПароля будет отмечена как устаревшая.ХранилищеДвоичныхДанных и регистры сведений ХранилищеФайлов, УдалитьДвоичныеДанныеФайлов нужно включать только в начальный образ подчиненного узла в РИБ.ГруппыЗначенийДоступа следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места только для создания начального образа (не включать в подписки на события), а также не следует включать в планы обмена, предназначенные для синхронизации данных между различными программами.ПодключаемыеКоманды, следует внедрить ее во все формы, в которых отображаются кнопки отправки сообщений.Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
ОбновлениеИнформационнойБазыПереопределяемый.ПриОпределенииНастроек. Предопределенные элементы таких объектов заполняются с помощью процедуры ПриНачальномЗаполненииЭлементов модуля менеджера.
ОтредактированныеПредопределенныеРеквизиты.ВыполнитьФункцию, ВыполнитьПроцедуру, ВыполнитьФункциюВНесколькоПотоков, ВыполнитьПроцедуруВНесколькоПотоков и ВыполнитьВФоне общего модуля ДлительныеОперации. В связи с этим рекомендуется пересмотреть код запуска и обработки длительных операций:
КраткоеПредставлениеОшибки и ПодробноеПредставлениеОшибки задействовать свойство ИнформацияОбОшибке типа ИнформацияОбОшибке в составе результата длительной операции. Также свойство ИнформацияОбОшибке возвращается функцией ДлительныеОперации.ЗаданиеВыполнено и возвращается в результате, передаваемом в процедуру оповещения, которая указана в параметре ОповещениеОЗавершении процедуры ДлительныеОперацииКлиент.ОжидатьЗавершение.СтандартныеПодсистемыКлиент.ВывестиИнформациюОбОшибке вместо метода платформы ПоказатьИнформациюОбОшибке или показа предупреждений. Функция требуется для перехвата исключений системами автоматического тестирования (так как при вызове метода платформы ПоказатьИнформациюОбОшибке не срабатывает обработчик события ОбработкаОтображенияОшибки модуля приложения).УточнениеОшибки в параметрах функций ПараметрыВыполненияФункции, ПараметрыВыполненияПроцедуры и ПараметрыВыполненияВФоне общего модуля ДлительныеОперации. Например: ПараметрыВыполнения.УточнениеОшибки = НСтр("ru = 'Не удалось выполнить действие по причине:'");. Тем самым, сообщение, выводимое пользователю, будет в точности совпадать с информацией об ошибке, которая записывается в журнал регистрации при возникновении исключения.Результат процедур-обработчиков прогресса и завершения длительных операций рекомендуется использовать функции:
ДлительныеОперацииКлиент.НовыйРезультатДлительнойОперации для значения передаваемого в процедуру завершения длительной операции, указанной в параметре ОповещениеОЗавершении процедуры ДлительныеОперацииКлиент.ОжидатьЗавершение.ДлительныеОперацииКлиент.НовоеСостояниеДлительнойОперации для значения передаваемого в процедуру оповещения о прогрессе длительной операции, указанной в свойстве ОповещениеОПрогрессеВыполнения функции ДлительныеОперацииКлиент.ПараметрыОжидания. Например:// Параметры:
// Результат - см. ДлительныеОперацииКлиент.НовыйРезультатДлительнойОперации
// ДополнительныеПараметры - Неопределено
//
&НаКлиенте
Процедура ПрименитьПравилаЗавершение(Результат, ДополнительныеПараметры) ЭкспортОбработкаОшибок.СообщениеОбОшибкеДляПользователя(ИнформацияОбОшибке) и обеспечить просмотр и отправку отчета по гиперссылке Сформировать отчет об ошибке:ОтчетДляОтправки = Новый ОтчетОбОшибке(ИнформацияОбОшибке);
СтандартныеПодсистемыКлиент.ПоказатьОтчетОбОшибке(ОтчетДляОтправки);СтандартныеПодсистемыКлиент.НастроитьВидимостьИЗаголовокСсылкиОтправкиОтчетаОбОшибке из обработчика модуля формы ПриОткрытии.ПриЗакрытии вызвать процедуру СтандартныеПодсистемыКлиент.ОтправитьОтчетОбОшибке(ОтчетДляОтправки, ИнформацияОбОшибке), которая отправляет отчет, если ошибка соответствующей категории и в приложении настроена обязательная отправка.Обработка.РезультатыОбновленияПрограммы.Форма.СообщениеОНеудачномОбновлении, Обработка.ЗаменаИОбъединениеЭлементов.Форма.ЗаменаЭлементов, Обработка.ТекущиеДела.Форма.Форма.ЖурналРегистрацииВызовСервера.ЗаписатьСобытияВЖурналРегистрации на ЖурналРегистрацииКлиент.ЗаписатьСобытияВЖурналРегистрации.ФизическиеЛицаКлиентСервер.ФИОНаписаноВерно отмечена как устаревшая, вместо нее следует использовать СтроковыеФункцииКлиентСервер.ТолькоСимволыНациональногоАлфавитаВСтроке.ПолучитьДанныеКлассификатора общего модуля РаботаСБанками отмечена как устаревшая, вместо нее следует использовать функцию СведенияБИК в том же модуле.ХранилищеНастроек справочника ДополнительныеОтчетыИОбработки: для сохранения и получения настроек теперь необходимо использовать процедуры СохранитьНастройки и ЗагрузитьНастройки общего модуля ДополнительныеОтчетыИОбработки.СоздатьЭлектронноеПисьмо и СоздатьSMS общего модуля УправлениеКонтактнойИнформациейКлиент рекомендуется вызывать функцию-конструктор ПараметрыПисьмаSMS._ДемоМоиНастройки. Для программного открытия формы настроек напоминаний см. процедуру ОткрытьНастройки в общем модуле НапоминанияПользователяКлиент.Для записи в журнал регистрации ошибок при обработке данных рекомендуется вызывать процедуру ЗаписатьОшибкуВЖурналРегистрации общего модуля ОбновлениеИнформационнойБазы. Например, вместо:
ТекстСообщения = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(
НСтр("ru = 'Не удалось обработать %1 по причине:
|%2'"),
ПредставлениеСсылки, ОбработкаОшибок.ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));
ЗаписьЖурналаРегистрации(ОбновлениеИнформационнойБазы.СобытиеЖурналаРегистрации(),
УровеньЖурналаРегистрации.Предупреждение, Метаданные.Справочники.КонтактныеЛицаПартнеров,
КонтактноеЛицоПартнера.Ссылка, ТекстСообщения);разместить один вызов:
ОбновлениеИнформационнойБазы.ЗаписатьОшибкуВЖурналРегистрации(КонтактноеЛицоПартнера.Ссылка, ПредставлениеСсылки, ИнформацияОбОшибке());УстановкаИУдалениеИсправлений общего модуля ОбновлениеКонфигурации рекомендуется вызывать функцию-конструктор ОбновлениеКонфигурации.ПараметрыУстановкиИсправлений.ПриОпределенииНастроекРегистрацииСобытийДоступаКДанным в общем модуле ПользователиПереопределяемый,НастройкиРегистрацииСобытийДоступаКДанным общего модуля Пользователи,ОбновитьНастройкиРегистрацииСобытийДоступаКДанным в общем модуле Пользователи. Они позволяют каждому механизму-потребителю хранить свои настройки отдельно, а при их изменении применять к информационной базе общий результат без случайного перетирания настроек других механизмов. При этом не следует самостоятельно отключать регистрацию события Доступ.Доступ, достаточно отключить свою часть настроек в ПользователиПереопределяемый.ПриОпределенииНастроекРегистрацииСобытийДоступаКДанным и вызвать Пользователи.ОбновитьНастройкиРегистрацииСобытийДоступаКДанным. При ошибке установки настроек Пользователи.ОбновитьНастройкиРегистрацииСобытийДоступаКДанным автоматически удаляет из настроек несуществующие имена полей, повторяет попытку установки и записывает в журнал регистрации событие Пользователи.Ошибка настройки события Доступ.Доступ с подробной информации и не вызывается исключение.ПараметрыДобавленияСвойства общего модуля УправлениеСвойствами, используемой в процедуре ДобавитьСвойство, свойство Тип заменено на ТипЗначения. Если используется программное добавление дополнительных реквизитов или сведений, рекомендуется заменить в местах вызова свойство Тип на ТипЗначения. Старое свойство осталось для обратной совместимости.При обновлении с ранних версий библиотеки (до 3.1.10) следует:
Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.10.1, 3.1.10.20, 3.1.10.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
ПроверкаВнедренияБСП.erf, улучшена проверка совместного внедрения подсистем Напоминания пользователя и Подключаемые команды. Диагностируется ошибка, если в форме объекта с напоминаниями нет фрагментов кода подсистемы Подключаемые команды.ХранилищеНастроек справочника ДополнительныеОтчетыИОбработки: для сохранения и получения настроек теперь необходимо использовать процедуры СохранитьНастройки и ЗагрузитьНастройки общего модуля ДополнительныеОтчетыИОбработки.СертификатыКлючейЭлектроннойПодписиИШифрования, в том числе по замене старого сертификата на новый, добавлена процедура ЭлектроннаяПодписьКлиентПереопределяемый.ПослеДобавленияВСправочникСертификатовЭлектроннойПодписи.АлгоритмШифрования в функцию ЭлектроннаяПодпись.Зашифровать и свойство АлгоритмШифрования в параметр ОписаниеДанных процедуры ЭлектроннаяПодписьКлиент.Зашифровать. Можно передавать явное название (“Магма”, “Кузнечик”, “ГОСТ 28147-89”), OID или представление алгоритма шифрования, которым будет переопределен алгоритм шифрования, заданный в настройках приложения.ОбменДаннымиПереопределяемый расширен процедурами ПриПоискеИмениПланаОбменаЧерезУниверсальныйФормат и ПриПереопределенииРеквизитовСсылочногоТипаУзлаПланаОбмена. Необходимо перенести их из поставки библиотеки.ЭлектроннаяПодписьКлиент.ПроверитьСертификат и ЭлектроннаяПодпись.ПроверитьСертификат предусмотрен параметр ПараметрыПроверки и конструктор для него ЭлектроннаяПодписьКлиент.ПараметрыПроверкиСертификата. С помощью свойства ВыполнятьПроверкуУдостоверяющегоЦентра можно указать, требуется ли проверять сертификат по списку аккредитованных удостоверяющих центров, а с помощью свойства ИгнорироватьПроверкуВСпискеОтозванныхСертификатов - требуется ли проверка по списку отзыва.ДополнительныеПараметры процедуры ЭлектроннаяПодписьКлиент.ПроверитьСертификатСправочника также можно воспользоваться новыми свойствами ВыполнятьПроверкуУдостоверяющегоЦентра и ИгнорироватьПроверкуВСпискеОтозванныхСертификатов.ПроверятьСертификат в конструкторе ЭлектроннаяПодписьКлиент.ПараметрыПроверкиПодписи при вызове процедуры ЭлектроннаяПодписьКлиент.ПроверитьПодпись можно вообще отключать проверку сертификата, когда подпись неквалифицированная и используется только для проверки неизменности документа. А также, наоборот, можно включать проверку и указывать, должен ли сертификат подписи быть квалифицированным.ЭлектроннаяПодпись.ПроверитьПодпись в параметр для заполнения результата проверки подписи ЭлектроннаяПодписьКлиентСервер.РезультатПроверкиПодписи добавлено свойство ПараметрыПроверкиСертификата.КалендарныеГрафикиЛокализация размещена процедура ПриПолученииДанныхКлассификатора, которая позволяет переопределить работу функции ДанныеКлассификатора общего модуля КалендарныеГрафики при получении файла с данными классификатора календарей в зависимости от национальной специфики. #### С версии 3.1.10.226 и меньшеШаблоныСообщенийПереопределяемый.ПриФормированииСообщения. Перенести из поставки библиотеки новое описание и убедиться, что комментарии, количество и имена параметров у процедур общего модуля ШаблоныСообщенийПереопределяемый совпадают с поставкой библиотеки.АдресныйКлассификатор предусмотрена функция ПроверитьОКТМОБюджетополучателя. Для работы функции требуется подключение к Интернет-поддержке пользователей и наличие постоянного соединения с интернетом. Подробнее см. комментарии к этой функции.АдресныйКлассификатор расширен функцией РазрешенДоступВИнтернет. ПроверкаВнедренияБСП.erf, добавлены проверки видов контактной информации в коде начального заполнения. Диагностируются ошибки если:
Улучшен инструмент Проверка внедрения БСП, входящий в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf:
УдаленныйДоступOData: в конфигурациях, рассчитанных на работу в модели сервиса (по технологии 1С:Фреш) в роль включаются права на объекты, разделенные независимо и совместно. При этом исключаются объекты, которые исключены из выгрузки/загрузки при переходе в сервис из локальных решений.ПараметрыДобавленияСвойства общего модуля УправлениеСвойствами, используемой в процедуре ДобавитьСвойство, свойство Тип заменено на ТипЗначения. Если используется программное добавление дополнительных реквизитов или сведений, рекомендуется заменить в местах вызова свойство Тип на ТипЗначения. Старое свойство осталось для обратной совместимости.Версия 3.1.9 предназначена для разработки на платформе 1С:Предприятие 8.3.21 и выше в режимах совместимости Версия 8.3.21, Версия 8.3.22, Версия 8.3.23 и Версия 8.3.24.
В состав библиотеки включена новая подсистема Машиночитаемые доверенности, которая предоставляет программный и пользовательский интерфейс для работы с машиночитаемыми доверенностями (МЧД) в формате, соответствующему приказу Минцифры России от 18.08.2021 № 857 «Об утверждении единых требований к формам доверенностей, необходимых для использования квалифицированной электронной подписи». С ее помощью можно создавать, загружать, проверять, регистрировать и отменять доверенности в распределенном реестре ФНС, устанавливать и проверять электронные подписи с машиночитаемыми доверенностями. Используется в конфигурации совместно с подсистемой Электронная подпись.
Если в прикладном решении встроена подсистема НастройкиПрограммы и присутствует библиотека 1С:Библиотека интернет-поддержки (БИП), то необходимо обновить ее до версии 2.6.5 или новее, добавив в состав конфигурации одноименную подсистему НастройкиПрограммы из БИП.
Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.9.
КодыАдреса общего модуля АдресныйКлассификатор, СведенияОбАдресе и СведенияОбАдресах общего модуля РаботаСАдресами добавлено поле ОКТМОБюджетополучателя.ПроверитьОКТМОБюджетополучателя в программном интерфейсе общего модуля АдресныйКлассификатор . Для работы функции требуется подключение к Интернет-поддержке пользователей и наличие постоянного соединения с интернетом.АдресныйКлассификатор расширен функцией РазрешенДоступВИнтернет.Для объединения списков-значений в общем модуле ОбщегоНазначенияКлиентСервер предусмотрена процедура ДополнитьСписок. При этом если в списке-приемнике уже есть элемент с добавляемым значением, то у него заменяется представление на новое из списка-источника.
Для проверки допустимых значений параметров процедур и функций в процедуре ОбщегоНазначенияКлиентСервер.ПроверитьПараметр предусмотрен необязательный параметр ОжидаемыеЗначения. Например, если процедура УстановитьЦвет может принимать в своем параметре Цвет только три допустимых строковых значения Красный, Желтый и Зеленый, то значение параметра можно проверить следующим образом:
ОбщегоНазначенияКлиентСервер.ПроверитьПараметр("Цвета.УстановитьЦвет", "Цвет", Цвет, Тип("Строка"), "Красный,Желтый,Зеленый");Для ветвления кода, который зависит от ограничений учебной версии платформы, в программный интерфейс вынесена функция СтандартныеПодсистемыСервер.ЭтоУчебнаяПлатформа.
В клиентском коде рекомендуется использовать функции ЭтоБазоваяВерсияКонфигурации и ЭтоУчебнаяПлатформа общего модуля СтандартныеПодсистемыКлиент, а также ОбщегоНазначенияКлиентСервер.ИмяCOMСоединителя вместо устаревших одноименных свойств структуры, возвращаемой функциями ПараметрыРаботыКлиента и ПараметрыРаботыКлиентаПриЗапуске общего модуля СтандартныеПодсистемыКлиент.
В клиент-серверном варианте работы ускорен внешний отчет Проверка внедрения БСП (входит в состав дистрибутива). Для этого в разделе Администрирование - Общие настройки - Производительность установить максимальное количество одновременно работающих потоков. Параметр следует устанавливать исходя из технических возможностей сервера, и его значение не должно превышать количество ядер процессора на сервере.
Для упрощения преобразования значений в формат JSON и обратно в модуле ОбщегоНазначения предусмотрены функции ЗначениеВJSON и JSONВЗначение.
Для проверки признака, является ли информационная база распределенной, предусмотрена функция ЭтоРаспределеннаяИнформационнаяБаза в общем модуле ОбщегоНазначения.
В инструменте Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, реализованы проверки обращения к интернет-ресурсам и некорректных отложенных обработчиков обновления.
HTTPСоединение, FTPСоединение, WSОпределения, WSПрокси не указывается параметр Прокси, который должен быть получен с помощью функции ПолучениеФайловИзИнтернета.ПолучитьПрокси. В таком случае, при настроенном в информационной базе прокси-сервере эти интернет-ресурсы будут недоступны. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.ОбластьДанныхОсновныеДанные). В конфигурациях, рассчитанных на работу в модели сервиса (по технологии 1С:Фреш), для обновления таких данных предназначены оперативные обработчики обновления.Перечисление.НазначенияВариантовОтчетов) в процедуре НастроитьВариантыОтчетов в модуле менеджера отчета или централизованно в общем модуле ВариантыОтчетовПереопределяемый:ДляКомпьютеровИПланшетов - вариант отчета должен отображаться в панелях отчетов только при работе в тонком, толстом или веб-клиенте 1С:Предприятие. Это значение по умолчанию;ДляСмартфонов - вариант отчета должен отображаться в панелях отчетов только при работе в мобильном приложении;ДляЛюбыхУстройств - вариант отчета должен отображаться в любых приложениях 1С:Предприятие.НастроитьВариантыОтчета в модуле менеджера отчета или в процедуре НастроитьВариантыОтчета общего модуля ВариантыОтчетовПереопределяемый. Например: ОписаниеВарианта = ВариантыОтчетов.ОписаниеВарианта(Настройки, ОписаниеОтчета, "ДоходыИРасходыПоПредприятиюМобильныйКлиент");
ОписаниеВарианта.Наименование = НСтр("ru='Доходы и расходы предприятия (моб.)'");
ОписаниеВарианта.Описание = НСтр("ru= 'Постатейный анализ доходов и расходов по предприятию в целом с возможностью выбора аналитики.'");
ОписаниеВарианта.Назначение = Перечисления.НазначенияВариантовОтчетов.ДляСмартфонов;Также предусмотрена возможность сохранять снимки отчетов для их последующего просмотра в мобильном клиенте в автономном режиме. Для программной работы с ними в модуле менеджера регистра сведений СнимкиОтчетов предусмотрены процедуры и функции:
СнимкиОтчетовПользователя,СохранитьСнимокОтчетаПользователя,ОбновитьСнимкиОтчетовПользователя.Подробнее см. в описании к ним.
Для просмотра отчетов в мобильном клиенте в автономном режиме (при отсутствии соединения с сервером) необходимо настроить выгрузку данных в автономную конфигурацию:
ВариантыОтчетов, Пользователи и регистра сведений СнимкиОтчетов - см. пример в демонстрационной конфигурации в ПланыОбмена._ДемоМобильныйКлиент.ПриЗаписи) - см. пример в демонстрационной конфигурации ПодпискиНаСобытия._ДемоЗарегистрироватьИзмененияДляАвтономногоРежима и ПодпискиНаСобытия._ДемоЗарегистрироватьИзмененияДляАвтономногоРежимаРегистры.ОбщегоНазначенияКлиентПереопределяемый процедура ПриНачалеРаботыСистемы._ДемоОбменМобильныйКлиентАвтономныйСервер_ДемоОбменМобильныйКлиент. Также в эту роль включить права для работы с объектами метаданных, участвующими в обмене - см. пример в автономной конфигурации Константы._ДемоКодНовогоУзлаПланаОбмена. Добавить данную роль, а также роль ДобавлениеИзменениеСнимковОтчетов в профили групп доступа пользователей, работающих в мобильном клиенте.ЗаписатьСвойстваОбъекта программного интерфейса общего модуля ЗагрузкаДанныхИзФайла, передав в качестве параметров ссылку на объект-владельца свойств и строку загружаемых данных.ЗаполнитьСубъектыДляРасчетаСроковХраненияПерсональныхДанных общего модуля ЗащитаПерсональныхДанных можно зарегистрировать всех субъектов с неуничтоженными персональными данными для расчета сроков хранения персональных данных.ПоложениеКнопкиДобавить в параметре процедуры ПриОпределенииНастроек общего модуля УправлениеКонтактнойИнформациейПереопределяемый). По умолчанию, кнопка выводится слева.ШиринаПоляКомментарий возможно указать точную ширину поля Комментарий для полей контактной информации с типами Телефон, АдресЭлектроннойПочты, Skype, ВебСтраница и Факс.СинхронизацияДанныхЧерезУниверсальныйФормат и демо-конфигурацией Синхронизация данных (демо) с планом обмена _ДемоСинхронизацияДанныхЧерезУниверсальныйФормат.ПакетнаяОбработка. Это событие позволяет выполнить групповую регистрацию массива ссылок по отборам, что оптимизирует интерактивную работу в обработке Регистрация изменений для обмена данными (команды Зарегистрировать изменения всех объектов выбранных типов и Зарегистрировать изменения объектов при помощи отбора) и непосредственно при выгрузке, когда происходит проверка регистрации данных.ПубличныеИдентификаторыСинхронизируемыхОбъектов будут получены и сохранены в оперативной памяти перед началом загрузки данных.Документ.ОтражениеЗарплатыВФинансовомУчете для свойств РезервБУ и РезервНУ изменен тип на Булево. Кроме этого в построчную часть объекта добавлено свойство ВзносыПоЕдиномуТарифу, которое необходимо для отражения изменений в законодательстве;Справочник.НастройкиРасчетаРезервовПоОплатеТруда добавлено свойство Организация;СБДС добавлено свойство НомерРасширенный и дополнительно, для повышения точности подбора документов, добавлены свойства ВходящийНомер, ВходящаяДата;СостояниеОбъекта. Это перечисление со значениями: Актуальный, Черновик, Устаревший. Свойство предназначено для передачи состояний объектов: Проведен, Записан и Помечен на удаление. Так, например, для документов значение Актуальный соответствует состоянию Проведен, Черновик соответствует состоянию Записан, а Устаревший говорит о том, что документ помечен на удаление. Для справочников состояния соответствуют следующим значениям: Актуальный – элемент справочника Записан, Устаревший – элемент справочника Помечен на удаление, а состояние Черновик для справочников использовать не предполагалось;Документ.СБДСПрочиеРасходы добавлено свойство ВидОперации. Рекомендуется его использовать для передачи признака платежа Комиссия банка;ВидыПродукцииИС, ТипыСкладов, ТипыСостоянийЭлектронногоДокумента, ПризнакиПредметаРасчета и ТипыШтрихкодов;КредитыИЗаймы добавлены значения КредитБанка, КредитКонтрагента, ЗаймКонтрагенту;ЕстьДвижениеНаличных, ЕстьДвижениеБезналичных, ЕстьДвижениеТоваров, ЭтоВозврат;Справочник.Договоры смягчили требования к свойству ИдентификаторГосКонтракта. Теперь свойство позволяет передавать произвольное количество символов, но не более 25. Кроме этого, добавили свойство СпособЗаполненияСтавкиНДС, которое рекомендуется использовать для передачи способа заполнения ставок НДС во входящих документах;Документ.РКОРасчетыССотрудниками добавили обязательное поле Сотрудник и необязательное поле БанковскийСчетСотрудника, а свойство Сотрудник в основном объекте удалено;Документ.РеализацияТоваровУслуг, Документ.КорректировкаРеализацииТоваров и Документ.ЗаказКлиента добавлено свойство ЭтапГосконтрактаЕИС, которое рекомендуется использовать для передачи одноименного признака;Документ.АвансовыйОтчет добавлен вид операции, который позволит различать командировочные документы от прочих, а так же в строчную часть прочих расходов добавлены свойства НомерДокументаОплаты и ДатаДокументаОплаты, которые рекомендуется использовать для передачи сведений графы 7 Книги покупок;Документ.РеализацияТоваровУслуг продублировали решение из Документ.ОтчетОРозничныхПродажах;НомерКарты стало не обязательным к заполнению;Эквайер сопровождены свойствами ДоговорЭквайера;Документ.ОтчетКомиссионера полем ВидОперацииОтчетовКоммисионеров, которое позволит отличить списание от продажи.ОбменДаннымиПереопределяемый расширен процедурами ПриПроверкеКорректностиИмениПланаОбменаEnterpriseData и ПриЗаполненииТиповИсключаемыхИзПроверкиУстраненияПроблемы. Подробности см. в описании к ним.ОтменитьПроведениеОбъектаВИБ общего модуля ОбменДаннымиXDTOСервер расширен необязательным параметром КомпонентыОбмена. ОбменДаннымиСервер расширен функцией ПолучитьWSПрокси_3_0_2_2. Подробности см. в описании к ней.ОбменДаннымиСобытия расширен процедурами ПослеЗагрузкиОбъекта и ПриРегистрацииОбработчиковЗагрузкиДанных. Подробности см. в описании к ним.ОбменДаннымиКлиент расширен процедурой ОткрытьПанельСинхронизацииДанных. Подробности см. в описании к ней.ОбменДаннымиXDTOСервер расширен процедурой ТипСвойстваПоИмениИЗначениюСвойства. Подробности см. в описании к ней.ПользователиКлиент.ЭтоПолноправныйПользователь вместо устаревших свойств ЭтоПолноправныйПользователь, ЭтоАдминистраторСистемы, ЕстьДоступДляОбновленияВерсииПлатформы структуры, возвращаемой функциями ПараметрыРаботыКлиента и ПараметрыРаботыКлиентаПриЗапуске общего модуля СтандартныеПодсистемыКлиент.Устарело свойство ЭтоПолноправныйПользователь структуры, возвращаемой функцией РаботаСФайлами.НастройкиРаботыСФайлами. Вместо него рекомендуется использовать функции Пользователи.ЭтоПолноправныйПользователь и ПользователиКлиент.ЭтоПолноправныйПользователь.
Для сканирования изображений в общем модуле РаботаСФайламиКлиент предусмотрены процедуры и функции:
ДобавитьСоСканера,ОбъединитьВМногостраничныйФайл,ДоступнаКомандаСканировать, ДоступноСканирование,ПараметрыДобавленияСоСканера, ПараметрыКонвертацииГрафическогоДокумента, ПараметрыСканирования,ТипРезультатаКонвертацииДвоичныеДанные, ТипРезультатаКонвертацииИмяФайла, ТипРезультатаКонвертацииПрисоединенныйФайл.Подробнее см. в описании к ним.
Для работы с настройками сканирования расширен программный интерфейс:
РаботаСФайлами и РаботаСФайламиКлиент предусмотрены процедуры СохранитьНастройкиСканированияПользователя и функции ПолучитьНастройкиСканированияПользователя;РаботаСФайламиКлиентСервер предусмотрена функция НастройкиСканированияПользователя. Подробнее см. в описании к ним.С версии 3.0.2.4 Библиотеки интеграции с 1С:Документооборотом можно добавлять и просматривать присоединенные файлы из 1С:Документооборот к справочникам и документам программы тем же самым образом, как и при хранении файлов в самой программе: с помощью кнопки-скрепки и гиперссылки в командной панели формы элемента справочника и документа.
В процедуре ПодписатьФайл общего модуля РаботаСФайламиКлиент предусмотрен параметр ПараметрыПодписи. С его помощью можно управлять выбором типа подписи и необходимостью выбора доверенности при подписании. Подробнее см. в описании конструктора НовыйТипПодписи в общем модуле ЭлектроннаяПодписьКлиент.
ПриОпределенииПараметровТекстаПисьма и ПриПолученииПараметровТекстаПисьма общего модуля РассылкаОтчетовПереопределяемый. Подробности см. в комментариях к ним.С помощью меток теперь можно помечать справочники и документы разноцветными значками-метками (раздел Администрирование – Общие настройки – Свойства). Метки выводятся в виде картинок или надписей, и редактируются в формах соответствующих справочников и документов. Кроме того, в списках можно увидеть колонку с метками и легенду к ней, а также доступен отбор списка по меткам. Для программной работы с метками в модуле УправлениеСвойствами предусмотрены процедуры и функции:
ПараметрыОтображенияМеток,ПриПолученииДанныхНаСервере,СвойстваПоВидуДополнительныхРеквизитов,УстановитьВидимостьЛегендыМеток,ЕстьВладельцыМеток,ЗаполнитьМеткиОбъекта. Подробнее см. в описании к ним.в модуле УправлениеСвойствамиКлиент:
РедактироватьМетки,ВыполнитьКоманду,УстановитьОтборПоМетке. Подробнее см. в описании к ним.Улучшена поддержка наборов свойств, создаваемых программно на основании различных справочников конфигурации, например, Видов номенклатуры. Для автоматического удаления таких наборов свойств при удалении элемента справочника-основания предусмотрена процедура ПередУдалениемВидаОбъекта в общем модуле УправлениеСвойствами. Ее необходимо вызвать в процедуре ПередУдалением модуля объекта справочника-основания:
// СтандартныеПодсистемы.Свойства
УправлениеСвойствами.ПередУдалениемВидаОбъекта(ЭтотОбъект);
// Конец СтандартныеПодсистемы.СвойстваПроверитьПодпись общего модуля ЭлектроннаяПодписьКлиент теперь может возвращать расширенную информацию о проверке и свойствах проверяемой подписи: не только результат проверки и причины, но и тип подписи, неподтвержденную дату подписи, срок действия сертификата, которым подписана последняя метка времени и другие свойства, см. полный список полей в функции РезультатПроверкиПодписи общего модуля ЭлектроннаяПодписьКлиентСервер.
Истина в свойстве ТребуетсяПроверка.ПараметрыПроверки процедуры ПроверитьПодпись нужно передать структуру, созданную конструктором ПараметрыПроверкиПодписи в общем модуле ЭлектроннаяПодписьКлиент с установкой признака РезультатВВидеСтруктуры.УсовершенствоватьПодпись общего модуля ЭлектроннаяПодписьКлиент добавлен параметр ИгнорироватьСрокДействияСертификата.УдалениеЭлектронныхПодписей.Подписать, Расшифровать модуля ЭлектроннаяПодписьКлиент возвращается КонтекстОперации и в случае неуспешной операции, если был введен пароль. Однако повторное действие с таким контекстом может быть также неуспешным.УстановленныеПодписи модуля ЭлектроннаяПодпись добавлен параметр ВозвращатьДанныеМЧД.СвойстваСертификата общего модуля ЭлектроннаяПодпись предусмотрены свойства ДатаНачалаЗакрытогоКлюча и ДатаОкончанияЗакрытогоКлюча, а также ДействуетДо - минимальная дата из срока окончания действия сертификата электронной подписи и срока окончания действия закрытого ключа.В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).
Для обновления следующих переопределяемых общих модулей требуется перенести из поставки библиотеки новые экспортные процедуры, удалить отсутствующие и убедиться, что комментарии, количество и имена параметров у процедур совпадают с поставкой библиотеки:
ОбменДаннымиПереопределяемый,ОбменДаннымиВМоделиСервисаПереопределяемый,ПоискИУдалениеДублейПереопределяемый,РассылкаОтчетовПереопределяемый.Рекомендации по задействованию новых возможностей переопределяемых общих модулей приведены выше в разделе Новые возможности для разработчиков.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки. В исключительных (редких) случаях, когда такая совместимость не обеспечена, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки, в этом разделе приведены необходимые инструкции. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
ПередНачаломРаботыСистемы, ПриНачалеРаботыСистемы, ПередЗавершениемРаботыСистемы и ОбработкаПолученияФормыВыбораПользователейСистемыВзаимодействия в модулях управляемого и обычного приложений на следующие:#Область ОбработчикиСобытий
Процедура ПередНачаломРаботыСистемы()
#Если МобильныйКлиент Тогда
Если ОсновнойСерверДоступен() = Ложь Тогда
Возврат;
КонецЕсли;
#КонецЕсли
// СтандартныеПодсистемы
#Если МобильныйКлиент Тогда
Выполнить("СтандартныеПодсистемыКлиент.ПередНачаломРаботыСистемы()");
#Иначе
СтандартныеПодсистемыКлиент.ПередНачаломРаботыСистемы();
#КонецЕсли
// Конец СтандартныеПодсистемы
КонецПроцедуры
Процедура ПриНачалеРаботыСистемы()
// СтандартныеПодсистемы
#Если МобильныйКлиент Тогда
Выполнить("СтандартныеПодсистемыКлиент.ПриНачалеРаботыСистемы()");
#Иначе
СтандартныеПодсистемыКлиент.ПриНачалеРаботыСистемы();
#КонецЕсли
// Конец СтандартныеПодсистемы
КонецПроцедуры
Процедура ПередЗавершениемРаботыСистемы(Отказ, ТекстПредупреждения)
// СтандартныеПодсистемы
#Если МобильныйКлиент Тогда
Выполнить("СтандартныеПодсистемыКлиент.ПередЗавершениемРаботыСистемы(Отказ, ТекстПредупреждения)");
#Иначе
СтандартныеПодсистемыКлиент.ПередЗавершениемРаботыСистемы(Отказ, ТекстПредупреждения);
#КонецЕсли
// Конец СтандартныеПодсистемы
КонецПроцедуры
Процедура ОбработкаПолученияФормыВыбораПользователейСистемыВзаимодействия(НазначениеВыбора,
Форма, ИдентификаторОбсуждения, Параметры, ВыбраннаяФорма, СтандартнаяОбработка)
// СтандартныеПодсистемы
#Если МобильныйКлиент Тогда
Выполнить("СтандартныеПодсистемыКлиент.ОбработкаПолученияФормыВыбораПользователейСистемыВзаимодействия(НазначениеВыбора,
|Форма, ИдентификаторОбсуждения, Параметры, ВыбраннаяФорма, СтандартнаяОбработка)");
#Иначе
СтандартныеПодсистемыКлиент.ОбработкаПолученияФормыВыбораПользователейСистемыВзаимодействия(НазначениеВыбора,
Форма, ИдентификаторОбсуждения, Параметры, ВыбраннаяФорма, СтандартнаяОбработка);
#КонецЕсли
// Конец СтандартныеПодсистемы
КонецПроцедуры
#КонецОбластиПриРегистрацииОбработчиковЗагрузкиДанных общего модуля ВыгрузкаЗагрузкаДанныхПереопределяемый добавить вызов процедуры ОбменДаннымиСобытия.ПриРегистрацииОбработчиковЗагрузкиДанных:Процедура ПриРегистрацииОбработчиковЗагрузкиДанных(ТаблицаОбработчиков) Экспорт
ОбменДаннымиСобытия.ПриРегистрацииОбработчиковЗагрузкиДанных(ТаблицаОбработчиков);
КонецПроцедурыКонстанта.ИспользоватьОценкуПроизводительностиСинхронизацииДанныхСправочник.СеансыОбменовДаннымиВключатьДатуВИмяФайла справочника РассылкиОтчетов отмечен как устаревший и переименован в УдалитьВключатьДатуВИмяФайла. Следует удалить все обращения к нему в коде, запросах и отчетах.Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
УправлениеКонтактнойИнформацией.ОписаниеПараметровКонтактнойИнформации исправлена опечатка в свойстве ТелефонСДобавочнымНомером, рекомендуется использовать новое название свойства. Прежнее название свойства оставлено для обратной совместимости. Глобальный:Процедура ПриПолученииНастроек(Настройки) Экспорт
//...
Настройки.ПравилаРегистрацииВМенеджере = Истина;
Настройки.ИмяМенеджераРегистрации = "МенеджерРегистрации";
Настройки.ИспользоватьКешПубличныхИдентификаторов = Ложь;
Настройки.Глобальный = Истина;
КонецПроцедурыВажно!
В информационной базе может быть только один
Глобальныйплан обмена
ИспользоватьКешПубличныхИдентификаторов в значение Истина в модуле менеджера плана обмена:Процедура ПриПолученииНастроек(Настройки) Экспорт
//...
Настройки.ПравилаРегистрацииВМенеджере = Истина;
Настройки.ИмяМенеджераРегистрации = "МенеджерРегистрации";
Настройки.ИспользоватьКешПубличныхИдентификаторов = Ложь;
КонецПроцедурыРаботаСПочтовымиСообщениями.ЗагрузитьПочтовыеСообщения при подготовке параметра ПараметрыЗагрузки.Колонки для корректного перевода рекомендуется использовать функцию РаботаСПочтовымиСообщениями.ПоляИнтернетПочтовогоСообщения.При обновлении с ранних версий библиотеки (до 3.1.9) следует:
Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.9.1, 3.1.9.20, 3.1.9.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
АдресныйКлассификатор предусмотрена функция ПроверитьОКТМОБюджетополучателя. Для работы функции требуется подключение к Интернет-поддержке пользователей и наличие постоянного соединения с интернетом. Подробнее см. комментарии к этой функции.АдресныйКлассификатор расширен функцией РазрешенДоступВИнтернет.Пользователи.СохраняемоеЗначениеСтрокиПароля следует дополнить вызовом методов платформы ВычислитьСохраняемоеЗначениеПароляПользователя или ПроверитьСоответствиеПароляПользователяСохраняемомуЗначению по схеме, как указано в примере к функции. Это требуется для случаев, когда администратор приложения выбрал алгоритм хеширования паролей, отличный от SHA-1. В будущих версиях функция Пользователи.СохраняемоеЗначениеСтрокиПароля будет отмечена как устаревшая.СвойстваСертификата общего модуля ЭлектроннаяПодпись предусмотрены свойства ДатаНачалаЗакрытогоКлюча и ДатаОкончанияЗакрытогоКлюча, а также ДействуетДо - минимальная дата из срока окончания действия сертификата электронной подписи и срока окончания действия закрытого ключа.Версия 8.3.21 библиотека теперь также предназначена для разработки на платформе 1С:Предприятие 8.3.21 и выше в режимах совместимости Версия 8.3.22, Версия 8.3.23 и Версия 8.3.24.КодыАдреса общего модуля АдресныйКлассификатор, СведенияОбАдресе и СведенияОбАдресах общего модуля РаботаСАдресами добавлено поле ОКТМОБюджетополучателя. Подробнее см. комментарии к этим функциям.ИнтернетПоддержкаИСервисы обработки ПанельАдминистрированияБСП.РаботаСПочтовымиСообщениями.ЗагрузитьПочтовыеСообщения при подготовке параметра ПараметрыЗагрузки.Колонки для корректного перевода рекомендуется использовать функцию РаботаСПочтовымиСообщениями.ПоляИнтернетПочтовогоСообщения.МашиночитаемыеДоверенностиФНСПереопределяемый предусмотрены процедуры ПриОпределенииНастроек и ПриПолученииСтатусов.МашиночитаемыеДоверенностиФНСКлиентПереопределяемый предусмотрена процедура ПриРегистрацииДоверенности.В инструменте Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, реализована проверка некорректных отложенных обработчиков обновления. Диагностируется ошибка, если отложенный обработчик обновления изменяет неразделенные объекты метаданных (объекты, не включенные в разделитель ОбластьДанныхОсновныеДанные). В конфигурациях, рассчитанных на работу в модели сервиса (по технологии 1С:Фреш), для обновления таких данных предназначены оперативные обработчики обновления. ##### Машиночитаемые доверенности
Реализованы новые функции и улучшения:
Для возможности регистрации доверенности в другом реестре, кроме Распределенного реестра ФНС в общем модуле МашиночитаемыеДоверенностиФНСПереопределяемый предусмотрены процедуры ПриПолученииСтатусаРегистрации , ПриРегистрацииДоверенности, а в МашиночитаемыеДоверенностиФНСКлиентПереопределяемый - процедура ПриОбработкеНавигационнойСсылки.
Для обработки изменения статуса доверенности в общем модуле МашиночитаемыеДоверенностиФНСКлиентПереопределяемыйпредусмотрена процедура ПриИзмененииСтатусаДоверенности. В ней можно сообщить, например, о том, что доверенность готова и можно продолжить отправку отчетности или документов по ЭДО.
МашиночитаемыеДоверенностиФНСПереопределяемый предусмотрена процедура ПриПроверкеДоверенностиПодписи. Она возвращает результаты проверок в структуре РезультатПроверкиДляПротокола, описанной в общем модуле МашиночитаемыеДоверенностиФНС. Для получения общего результата проверки см. функцию РезультатПроверкиПодписиПоМЧД.КлассификаторыМЧД рекомендуется включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.УстановленныеПодписи модуля ЭлектроннаяПодпись добавлен параметр ВозвращатьДанныеМЧД.СторонаМЧД. Эти объекты также должны быть указаны в определяемых типах Организация, ФизическоеЛицо, Контрагент.МашиночитаемыеДоверенностиФНСПереопределяемый вписать код в процедуры ПриЗаполненииРеквизитовОрганизации, ПриЗаполненииРеквизитовФизическогоЛица, ПриЗаполненииРеквизитовКонтрагента, ПриЗаполненииНалоговыхОргановДействия. См. пример в демонстрационной конфигурации.МашиночитаемыеДоверенностиФНС, МашиночитаемыеДоверенностиФНСКлиент, МашиночитаемыеДоверенностиФНСКлиентПереопределяемый, МашиночитаемыеДоверенностиФНСПереопределяемыйПодписатьФайл общего модуля РаботаСФайламиКлиент предусмотрен параметр ПараметрыПодписи. С его помощью можно управлять выбором типа подписи и выбора доверенности при подписании. Подробнее см. в описании конструктора НовыйТипПодписи в общем модуле ЭлектроннаяПодписьКлиент. ПроверкаВнедренияБСП.erf, реализована проверка обращения к интернет-ресурсам. Диагностируется ошибка, если при создании объектов HTTPСоединение, FTPСоединение, WSОпределения, WSПрокси не указывается параметр Прокси, который должен быть получен с помощью функции ПолучениеФайловИзИнтернета.ПолучитьПрокси. В таком случае, при настроенном в информационной базе прокси-сервере эти интернет-ресурсы будут недоступны. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.Версия 3.1.8 предназначена для разработки на платформе 1С:Предприятие 8.3.21 и выше в режиме совместимости Версия 8.3.21.
Если в прикладном решении встроена подсистема НастройкиПрограммы и присутствует библиотека 1С:Библиотека интернет-поддержки (БИП), то необходимо обновить ее до версии 2.6.5, добавив в состав конфигурации одноименную подсистему НастройкиПрограммы из БИП.
Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.8.
Длительность отложенного обновления. В нем обработчики обновления визуально сгруппированы по порядку от критичных к менее критичным, наглядна видна последовательность их выполнения, а также выводится TOP-10 самых длительных обработчиков каждой группы.ПроверитьАдреса общего модуля АдресныйКлассификатор больше не требуется поле ФорматАдреса для структуры, входящей в массив параметра Адреса.ВыполнитьФункциюВНесколькоПотоков и ВыполнитьПроцедуруВНесколькоПотоков общего модуля ДлительныеОперации. Теперь перезапуск рабочих процессов в клиент-серверном варианте работы программы или аварийное завершение управляющего или исполняющего фонового задания не приводит к прерыванию выполнения многопоточной длительной операции. Для этого:
ЗаданиеВыполнено общего модуля ДлительныеОперации теперь возвращает расширенный результат без вызова исключения, если передать Истина для нового необязательного параметра РасширенныйРезультат. Эта функция также выполняет перезапуск управляющего фонового задания многопоточной длительной операции, как написано выше. Следует учитывать, что идентификатор задания, полученный при запуске многопоточной длительной операции изменяется при перезапуске, поэтому для проверки завершения длительной операции недопустимо напрямую проверять состояние фонового задания. Вместо этого следует использовать процедуру ОжидатьЗавершение общего модуля ДлительныеОперацииКлиент, а если это невозможно, тогда использовать функцию ЗаданиеВыполнено на сервере.ПараметрыОжидания общего модуля ДлительныеОперацииКлиент добавлен параметр ОтменятьПриЗакрытииФормыВладельца (значение по умолчанию Истина, когда указан параметр ФормаВладелец и эта форма-владелец открыта).ПодключитьКомпонентуИзМакета общего модуля ОбщегоНазначения добавлен параметр Изолированно, а в конструктор ПараметрыПодключенияКомпоненты общего модуля ОбщегоНазначенияКлиент добавлено поле Изолированно. Подробнее о выборе типа подключения внешних компонент см. в документации к платформе 1С:Предприятие.Ключи функции ПрочитатьДанныеИзБезопасногоХранилища общего модуля ОбщегоНазначения, а достаточно передать в нем значение Неопределено.ЗаписатьДанныеВБезопасноеХранилище общего модуля ОбщегоНазначения в значение параметра Ключи можно указать значение Неопределено, а в параметр Данные передать структуру с ключами и новыми значениями.ОбщегоНазначения предусмотрена функция ПрочитатьДанныеВладельцевИзБезопасногоХранилища.УдалитьДанныеИзБезопасногоХранилища общего модуля ОбщегоНазначения удалить конфиденциальную информацию, передав в параметре Владелец массив из нескольких объектов-владельцев.ОбщегоНазначения предусмотрены функции ПредметыСтрокой и ПредставленияСсылок. Они являются дополнением к имеющейся функции ПредметСтрокой.ОбщегоНазначения размещена функция ЭтоПредопределенныеЭлементы.ОбщегоНазначения предусмотрена функция СлужебныеСвязиДанных. Она является дополнением к имеющейся функции ЭтоСлужебнаяСвязьДанных.ФайловаяСистемаКлиент предусмотрена процедура НапечататьИзПриложенияПоИмениФайла.Справочник.Организации) рекомендуется использовать новую функцию ОбъектМетаданныхПоПолномуИмени общего модуля ОбщегоНазначения.РегламентныеЗаданияСервер расширен функцией СвойстваПоследнегоЗадания. Подробнее см. в описании к ней.РазделениеВключено и ДоступноИспользованиеРазделенныхДанных в общий модуль ОбщегоНазначенияКлиент, которые работают как одноименные функции общего модуля ОбщегоНазначения.ОбщийКаталогВременныхФайлов общего модуля ФайловаяСистема. Это обеспечит доступ со всех серверов кластера к временному файлу, например, для его обработки в фоновых заданиях, работающих параллельно.СистемнаяИнформацияКлиента общего модуля ОбщегоНазначения. Это позволяет отказаться от необходимости самостоятельно передавать параметры с клиента на сервер при запуске и убрать лишние серверные вызовы. Тип плафтормы возвращается в виде строки имени значения системного перечисления. Для его получения предусмотрена функция ИмяТипаПлатформы общего модуля ОбщегоНазначенияКлиентСервер.РаботаСБанкамиПереопределяемый следующими процедурами:
ПриОпределенииНастроекЗагрузкиКлассификатораБанков - для включения выполнения процедуры ПриОбработкеОбластиДанных,ПриОбработкеОбластиДанных - для выполнения дополнительных действий в области данных.Взаимодействия предусмотрены процедуры и функции для управления настройками подсистемы:
УстановитьИспользованиеПочтовогоКлиента, ИспользуетсяПочтовыйКлиент;УстановитьИспользованиеОтправкиПисемВФорматеHTML, ИспользуетсяОтправкаПисемВФорматеHTML;УстановитьИспользованиеПрочегоВзаимодействия, ИспользуютсяПрочиеВзаимодействия;ПараметрыПодключения для параметра ПараметрыПодключения метода ПодключитьКомпоненту общих модулей ВнешниеКомпонентыКлиент и ВнешниеКомпонентыСервер добавлено поле Изолированно. Подробнее о выборе типа подключения внешних компонент см. в документации к платформе 1С:Предприятие.ГрупповоеИзменениеОбъектовПереопределяемый процедурой ПриОпределенииРедактируемыхРеквизитовОбъекта.РазблокированиеРеквизитов. Она позволяет пропустить проверку использования объекта перед разблокировкой, а также посмотреть отчет о местах использования. Разработчик также может управлять внешним видом этой формы: указать текст верхней надписи в шапке формы, тексты предупреждений для каждого реквизита, а также выводить реквизиты в группах. Для этого предусмотрена функция НовыйБлокируемыйРеквизит общего модуля ЗапретРедактированияРеквизитовОбъектов, которая позволяет задавать расширенные описания блокируемых реквизитов в функциях ПолучитьБлокируемыеРеквизитыОбъекта модулей менеджеров объектов. Пример реализации см. в демонстрационной конфигурации в справочнике _ДемоНоменклатура и плане счетов _ДемоОсновной.КонструкторФормул.ДобавитьСписокПолейНаФорму во втором параметре Параметры задать свойству ИспользоватьФоновыйПоиск значение Истина, а в модуль формы следует добавить процедуры Подключаемый_ОбработчикКонструктораФормулСервер, Подключаемый_ОбработчикКонструктораФормулКлиент, Подключаемый_ВыполнитьФоновыйПоискВСпискеПолей, Подключаемый_СтрокаПоискаОчистка. Подробности см. в документации. Пример реализации см. в модуле формы ХранилищаНастроек.ХранилищеВариантовОтчетов.Формы.ВыборПоляОтчета.КонструкторФормул также расширен вспомогательной процедурой ОбработчикКонструктораФормул, а в общем модуле КонструкторФормулКлиент предусмотрена вспомогательная процедура СтрокаПоискаОчистка. Подробности см. в описаниях к ним.ПриОпределенииНастроек общего модуля УправлениеКонтактнойИнформациейПереопределяемый можно включить отображение иконок контактной информации слева от заголовка вида, а также переопределить внешний вид и обработчики команд контактной информации. Также возможно добавление и удаление стандартных команд контактной информации, отображаемых в справочниках и документах. См. пример в демонстрационной конфигурации в процедуре ПриОпределенииНастроек общего модуля УправлениеКонтактнойИнформациейПереопределяемый.
УправлениеКонтактнойИнформацией расширен вспомогательными функциями ОписаниеКоманд, КомандыТипаКонтактнойИнформации, ОписаниеКомандыПоИмени и СвойстваКоманды. Подробности см. в описаниях к ним.ПриСозданииНаСервере установить значение Ложь у свойства РазрешитьДобавлениеПолей параметра ДополнительныеПараметрыКонтактнойИнформации. См. пример в демонстрационной конфигурации в процедуре ПриСозданииНаСервере модуля формы документа _ДемоЗаказПокупателя.ПриСозданииНаСервере общего модуля УправлениеКонтактнойИнформацией рекомендуется использовать свойство РазмещеныНаФорме параметра ДополнительныеПараметрыКонтактнойИнформации вместо устаревшего свойства ИсключаемыеВиды, которое было названо менее очевидно. Кроме того, использование свойства РазмещеныНаФорме несколько ускорит открытие формы при большом количестве статических элементов. См. пример в демонстрационной конфигурации в процедуре ПриСозданииНаСервере модуля формы элемента справочника _ДемоКонтрагенты.СоздатьЭлектронноеПисьмо общего модуля УправлениеКонтактнойИнформациейКлиент расширен пятым параметром ИмяРеквизита.НапоминанияПользователя:
ПриСозданииНаСервере,ПараметрыРазмещения,ПриЧтенииНаСервере,ПриЗаписиНаСервере,ОбработкаОповещения,ПриИзмененииНастройкиНапоминания.ФормаДокумента документа _ДемоСчетНаОплатуПокупателю в демонстрационной конфигурации.ПриПолученииНастроек заполняется параметр РежимВыборочнойРегистрации. Параметр может принимать одно из следующих значений - Отключен, Модифицированность, СогласноПравиламXML:
ОбменДаннымиСервер расширен методам:
НастройкиПланаОбменаПоУмолчанию,ОписаниеВариантаНастройкиОбменаПоУмолчанию,ПараметрыКонтекстаПолученияОписанияВариантаНастройки,ПолучитьWSПрокси_3_0_2_1. Подробнее см. в описании к ним.ОбменДаннымиXDTOСервер расширен методом КлассКлючевыеСвойстваФормата. Подробнее см. в описании к нему.ОбменДаннымиКлиент расширен методом ОбработкаНавигационнойСсылкиВФормеУзла. Подробнее см. в описании к нему.ОбменДаннымиВМоделиСервиса расширен методом ПередЗаписьюОбщихДанных. Подробнее см. в описании к нему.При отложенном обновлении все данные в программе обрабатываются равномерно (в параллельном режиме обновления). Однако часть этих данных может быть более критична для начала работы, чем другие. Например, справочники и регистры, без которых невозможен ввод новых документов, критичнее, чем данные архивных периодов. Для того чтобы ускорить обработку важных данных и быстрее разблокировать основные функции программы, у отложенных параллельных обработчиков обновления можно указывать свойство Порядок. Обработка данных при этом будет оптимизирована: менее критичные данные будут обновлены лишь после полного завершения обработки более критичных. Подробнее см. раздел Порядок выполнения отложенных обработчиков обновления в документации. Пример:
Обработчик = Обработчики.Добавить();
Обработчик.Версия = "1.2.3.4";
Обработчик.Идентификатор = Новый УникальныйИдентификатор("b3be66c5-708d-42c8-a019-818036d09d06");
Обработчик.Процедура = "Справочник.СтавкиНДС.ОбработатьДанныеДляПереходаНаНовуюВерсию";
...
Обработчик.Порядок = Перечисления.ПорядокОбработчиковОбновления.Критичный;ОбновлениеИнформационнойБазы расширен функцией ПараметрыВыборкиАктуальныхДанных, подробнее см. в описании к ней.Описание обработчиков обновления проверяется корректность заполнения свойства Порядок: обнаруживаются некорректные случаи, когда в читаемых данных более критичного обработчика указаны данные, обновляемые менее критичными (см. Функции для технического специалиста - Обработки - Описание обработчиков обновления).В инструменте Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, улучшена проверка состава плана обмена ОбновлениеИнформационнойБазы. Если обработчик обновления размещен в модуле менеджера объекта, то проверяется наличие объекта в составе плана обмена. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.
Для предотвращения ошибок реструктуризации вида Записи регистра стали неуникальными, а также для автоматической очистки устаревших данных, достаточно добавить устаревший объект метаданных (с префиксом Удалить) в переопределяемую процедуру ПриЗаполненииОбъектовПланируемыхКУдалению общего модуля ОбновлениеИнформационнойБазыПереопределяемый с помощью процедуры ДобавитьОбъектПланируемыйКУдалению общего модуля ОбновлениеИнформационнойБазы. Подробнее см. в документации в разделе Очистка устаревших данных.
ОбсужденияКлиент расширен функцией ОбсужденияДоступны, с помощью которой можно выяснить, подключена ли в данный момент Система взаимодействия.ПользовательСистемыВзаимодействия общего модуля Обсуждения можно получить идентификатор пользователя системы взаимодействия. Для этого нужно указать Истина для необязательного параметра ТолькоИдентификатор. Это полезно, когда нужен только идентификатор, а не пользователь системы взаимодействия, что вдвое сокращает количество вызовов системы взаимодействия.ОтправкаSMSКлиент процедурой ОткрытьФормуНастроек.ПриОпределенииНастроекПечати общего модуля УправлениеПечатьюПереопределяемый, а в модуле менеджера объекта печати определены процедуры ПриОпределенииНастроекПечати и ПриОпределенииПолучателей. Пример см. в демонстрационной конфигурации в модуле менеджера документа _ДемоСчетНаОплатуПокупателю.ПередПечатью общего модуля УправлениеПечатьюПереопределяемый можно переопределить данные печатной формы перед формированием, например, исключить объект из массива объектов для печати. См. пример в демонстрационной конфигурации в процедуре ПередПечатью общего модуля УправлениеПечатьюПереопределяемый.ПриПолученииКомандПечати общего модуля УправлениеПечатьюПереопределяемый можно задать дополнительные настройки команд печати, например, изменить условия видимости. См. пример в демонстрационной конфигурации в процедуре ПриПолученииКомандПечати общего модуля УправлениеПечатьюПереопределяемый.ДанныеПечати, который полностью переопределяет автоматическую коллекцию полей, можно создать макет ДополнительныеДанныеПечати и описать в нем лишь дополнительные поля, которые не попали в автоматический список полей объекта. Например, это могут быть поля объекта, физически размещаемые в отдельном регистре.Период и при получении значений других полей этой СКД будет учитываться, что значения полей зависят от периода. См. пример в макете ДополнительныеДанныеПечати в справочнике _ДемоМестаХранения - к полям справочника добавляется периодическое поле Заведующий, при выводе в печатной форме документа поля Место хранения.Заведующий значение будет зависеть от даты в документе.ПодключаемыеОтчетыИОбработки - см. подробнее в документации в разделе Подключаемые команды - Использование при разработке конфигурации - Подключение отчетов и обработок к механизмам конфигурации.ПриОпределенииНастроекПечати общего модуля УправлениеПечатьюПереопределяемый в параметре Настройки предусмотрено свойство ПроверкаПроведенияПередПечатью (значение по умолчанию Ложь).ПодключаемыеОтчетыИОбработки;ПриОпределенииНастроек и указать в ней к каким объектам подключена печатная форма:Процедура ПриОпределенииНастроек(НастройкиПрограммногоИнтерфейса) Экспорт
НастройкиПрограммногоИнтерфейса.Размещение.Добавить(Метаданные.Документы.<ИмяДокумента>);
КонецПроцедурыОбработка._ДемоПечатьДоговораКуплиПродажи.ПФ_MXL_ДоговорКуплиПродажи см. в демонстрационной конфигурации.ПриОпределенииВидовПодключаемыхКоманд общего модуля ПодключаемыеКомандыПереопределяемый можно изменять вариант отображения (обычное, компактное) для групп командной панели с видом ГруппаКнопок. См. пример компактного отображения команд группы НастройкаПорядкаЭлементов в демонстрационной конфигурации в процедуре ПриОпределенииВидовПодключаемыхКоманд общего модуля НастройкаПорядкаЭлементов.ПодключаемыеКомандыКлиент.НачатьВыполнениеКоманды, ПодключаемыеКоманды.ВыполнитьКоманду и ПодключаемыеКомандыКлиентСервер.ОбновитьКоманды. Для этого в коллекции параметров ПараметрыРазмещения процедуры ПриСозданииНаСервере общего модуля ПодключаемыеКоманды предусмотрен новый параметр - ВладелецКоманд, позволяющий связать таблицу формы или объект с выводимыми командами на форме. При указании параметра размещения ВладелецКоманд становится необязательным использование параметра Источник в процедурах НачатьВыполнениеКоманды общего модуля ПодключаемыеКомандыКлиент, ВыполнитьКоманду общего модуля ПодключаемыеКоманды и ОбновитьКоманды общего модуля ПодключаемыеКомандыКлиентСервер. См. пример использования в форме РеестрСкладскихДокументов регистра сведений _ДемоРеестрСкладскихДокументов.ПоискИУдалениеДублей расширен функцией НайтиПохожиеСтроки. При необходимости можно уточнить условия поиска похожих строк (алгоритм нечеткого поиска) с помощью функции ПараметрыПоискаПохожихСтрок этого же модуля.ФизическоеЛицо и Подразделение, если они не требуются для ведения учета, либо связь пользователей с одноименными справочниками реализована в конфигурации иначе. Для этого в параметре Настройки процедуры ПриОпределенииНастроек общего модуля ПользователиПереопределяемый установить свойства ФизическоеЛицоИспользуется и ПодразделениеИспользуется в значение Ложь. Для программной проверки использования этих реквизитов также предусмотрены функции ФизическоеЛицоИспользуется и ПодразделениеИспользуется общего модуля Пользователи.Пользователи расширен новыми функциями:
НайтиПоИдентификатору позволяет найти пользователя в справочнике без учета существования пользователя информационной базы.НайтиПоСсылке возвращает пользователя информационной базы по ссылке на элемент справочника. Возвращает Неопределено, если пользователь информационной базы не существует или его идентификатор не указан в элементе справочника.НайтиПоИмени общего модуля Пользователи теперь возвращает ссылку на внешнего пользователя вместо пустой ссылки на справочник Пользователи, если пользователь ИБ связан с внешним пользователем.НовоеОписаниеПользователяИБ общего модуля Пользователи возвращает свойства АдресЭлектроннойПочты, ЗапрещеноВосстанавливатьПароль, АутентификацияOpenID, АутентификацияOpenIDConnect, АутентификацияТокеномДоступа, ЗащитаОтОпасныхДействий, которые учитываются в процедуре СкопироватьСвойстваПользователяИБ общего модуля Пользователи. Это необходимо для корректной работы видов аутентификации Аутентификация по протоколу OpenID-Connect и Аутентификация токеном доступа.СоздатьПароль общего модуля Пользователи:
СвойстваПароля типа Структура, которая включает все остальные параметры. Для него предусмотрена функция-конструктор СвойстваПароля в общем модуле Пользователи;СвойстваПароля возможно передать свойство ГСЧ типа ГенераторСлучайныхЧисел.НаименьшаяДлина, Сложный и УчестьНастройки отмечены как устаревшие и оставлены для обратной совместимости. Вместо них следует использовать первый параметр СвойстваПароля. Рекомендуется проверить все места использования.ОтдельныеНастройкиДляВнешнихПользователей, КоличествоПопытокВводаПароляДоБлокировки, ДлительностьБлокировкиВводаПароля и ПоказыватьВСпискеВыбора можно установить с помощью процедуры УстановитьОбщиеНастройкиВхода и функции НовоеОписаниеОбщихНастроекВхода;ПредупреждатьОбОкончанииСрокаДействияПароля можно установить с помощью процедуры УстановитьНастройкиВхода и функции НовоеОписаниеНастроекВхода.ПроверкаВнедренияБСП.erf, повышена наглядность результатов проверки доступа к неразделенным данным. Теперь отдельно выводятся списки неразделенных данных, которых нет в контролирующей подписке, и объектов, некорректно включенных в несколько разделителей. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.ПараметрыЗагрузки функции ЗагрузитьПочтовыеСообщения теперь можно задавать Отбор. См. пример использования в форме Форма обработки _ДемоПроверкаВходящихСообщений.ПередПолучениемСтатусовПисем, ПослеПолученияСтатусовПисем общего модуля РаботаСПочтовымиСообщениямиПереопределяемый. Подробности см. в комментариях к ним.РаботаСФайламиКлиент предусмотрена процедура ОткрытьФормуСпискаФайлов для открытия списка Файлы.УправлениеСвойствами предусмотрены процедуры и функции:
ДобавитьСвойство,ПараметрыДобавленияСвойства,ДобавитьЗначениеСвойства,ПараметрыДобавленияЗначенияСвойства. Подробнее см. в описании к ним.ОшибкаПоКлассификатору общего модуля ЭлектроннаяПодпись добавлен необязательный параметр ОшибкаНаСервере. Подробнее см. в комментарии к ней.ПриНачальномЗаполненииЭлементов и ПриНачальномЗаполненииЭлемента общего модуля ШаблоныСообщенийПереопределяемый. См. пример в демонстрационной конфигурации.СоздатьШаблон программного интерфейса общего модуля ШаблоныСообщений можно предопределить выбранные печатные формы, добавить файлы-вложения и установить признак присоединения файлов владельца к письму. Для этого функция-конструктор ОписаниеПараметровШаблона общего модуля ШаблоныСообщений расширена новыми свойствами. Подробнее см. в комментарии к ней.ПриЗаполненииПочтыПолучателейВСообщении программного интерфейса общего модуля ШаблоныСообщенийПереопределяемый или в одноименной процедуре модуля менеджера владельца у параметра ПолучателиПисьма добавлена колонка ВариантОтправки, в которой можно установить вариант отправки письма получателю: Кому, Копия, СкрытаяКопия и ОбратныйАдрес.СформироватьСообщение и СформироватьСообщениеИОтправить предусмотрено новое свойство ЗначенияПараметровСКД, позволяющее динамически передать параметры в запрос СКД перед формированием письма или сообщения SMS по шаблону.ШаблоныСообщений предусмотрены процедуры для управления настройками подсистемы: УстановитьИспользованиеШаблоновСообщений и ИспользуютсяШаблоныСообщений.ПередВыполнениемКомандыПечатиВнешнейПечатнойФормы общего модуля ДополнительныеОтчетыИОбработкиКлиентПереопределяемый устарела. Вместо нее рекомендуется использовать свойство ПроверкаПроведенияПередПечатью параметра Настройки процедуры ПриОпределенииНастроекПечати общего модуля УправлениеПечатьюПереопределяемый.В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).
Для обновления следующих переопределяемых общих модулей требуется перенести из поставки библиотеки новые экспортные процедуры, удалить отсутствующие и убедиться, что комментарии, количество и имена параметров у процедур совпадают с поставкой библиотеки:
ГрупповоеИзменениеОбъектовПереопределяемый,ОбменДаннымиПереопределяемый,ОбменДаннымиВМоделиСервисаПереопределяемый,ОбщегоНазначенияКлиентПереопределяемый,РаботаСФайламиПереопределяемый,УправлениеКонтактнойИнформациейПереопределяемый,УправлениеПечатьюПереопределяемый,ШаблоныСообщенийПереопределяемый.Рекомендации по задействованию новых возможностей переопределяемых общих модулей приведены выше в разделе Новые возможности для разработчиков.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки. В исключительных (редких) случаях, когда такая совместимость не обеспечена, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки, в этом разделе приведены необходимые инструкции. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
ОбработкаПолученияФормыВыбораПользователейСистемыВзаимодействия и комментарий глобальной переменной ПараметрыПриложения.ПриДобавленииПараметровРаботыКлиентаПриЗапуске общего модуля ОбщегоНазначенияПереопределяемый теперь вызывается в неразделенном режиме, как и процедура ПриДобавленииПараметровРаботыКлиента. Код, который не рассчитан на такой вызов, нужно обернуть условием Если ОбщегоНазначения.ДоступноИспользованиеРазделенныхДанных() Тогда.ДоставлятьСерверныеОповещенияБезСистемыВзаимодействия и РегистрироватьПоказателиСерверныхОповещений не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места, а также планов обмена, предназначенных для синхронизации данных между различными программами.ПередЗапускомПрограммы общего модуля ОбщегоНазначенияПереопределяемый больше не вызывается из сеансов фоновых заданий. Он вызывается только из клиентских сеансов и сеансов регламентных заданий (когда имя процедуры запущенного фонового задания указано в одном из регламентных заданий).ПроверятьПоФИАС справочника ВидыКонтактнойИнформации отмечен как устаревший и переименован в УдалитьПроверятьПоФИАС. Следует удалить все обращения к нему в коде, запросах и отчетах.НастройкиПрограммы из БИП.
НастройкиПользователейИПравПриСозданииНаСервере общего модуля НастройкиПрограммыПереопределяемый выполнялось переопределение объектов БИП, то перенести код в процедуру ПриСозданииФормыИнтернетПоддержкаИСервисы общего модуля НастройкиПрограммыБИППереопределяемый.РегистрыСведений.АрхивСообщенийОбменовРегистрыСведений.НастройкиАрхиваСообщенийОбменовРегистрыСведений.КонтурСинхронизацииРегистрыСведений.ЗадачиОбменаДаннымиВнутренняяПубликацияРегистрыСведений.ОбъектыНезарегистрированныеПриЗацикливанииПорядокОбрабатываемыхДанных рекомендуется включать только в состав начального образа планов обмена распределенной информационной базы (РИБ) и автономного рабочего места (АРМ).ФиксацияОбработкиДанныхОбработчиками не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.ВходВПрограммуРазрешен общего модуля Пользователи теперь ожидает в параметре ОписаниеПользователяИБ свойства, соответствующие этим видам аутентификации. В тех местах, где в параметр ОписаниеПользователяИБ передавалась структура, требуется добавить в эту структуру новые свойства АутентификацияOpenIDConnect и АутентификацияТокеномДоступа и корректно заполнить их.РаботаСФайлами.ПриЗаписиНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи, Параметры) на следующий: РаботаСФайлами.ПриЗаписиНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи, ЭтотОбъект).РаботаСФайлами.ПриСозданииНаСервере(ЭтотОбъект, ДобавляемыеЭлементы), необходимо дополнить параметром: НастройкиРаботыСФайламиВФорме = РаботаСФайлами.НастройкиРаботыСФайламиВФорме();
НастройкиРаботыСФайламиВФорме.КопироватьПрисоединенныеФайлы = Истина;
РаботаСФайлами.ПриСозданииНаСервере(ЭтотОбъект, ДобавляемыеЭлементы, НастройкиРаботыСФайламиВФорме);ЗначениеКопирования. Подробнее см. в документации и демонстрационной базе в форме документа _ДемоЗаказПокупателя.ИсторияРассылкиОтчетов, СертификатыПолучателейРассылкиОтчетов и константы ХранитьИсториюРассылкиОтчетов, КоличествоМесяцевХраненияИсторииРассылкиОтчетов не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.СпискиОтзываСертификатов не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
РазблокированиеРеквизитов и открывать вместо них стандартную общую форму РазблокированиеРеквизитов, в которой теперь предусмотрены все необходимые возможности. Она позволяет пропустить проверку использования объекта перед разблокировкой, а также посмотреть отчет о местах использования. Разработчик также может управлять внешним видом этой формы: указать текст верхней надписи в шапке формы, тексты предупреждений для каждого реквизита, а также выводить реквизиты в группах.
ПолучитьБлокируемыеРеквизитыОбъекта модулей менеджеров объектов с помощью функции НовыйБлокируемыйРеквизит общего модуля ЗапретРедактированияРеквизитовОбъектов.ПроверитьСсылкиНаОбъект общего модуля ЗапретРедактированияРеквизитовОбъектовКлиент устарела. Рекомендуется открывать общую форму РазблокированиеРеквизитов вместо собственных форм РазблокированиеРеквизитов, в которых задействована устаревшая процедура.РазблокированиеРеквизитов, а прикладная форма открывается со стандартными параметрами ЗаблокированныеРеквизиты и Ссылка, рекомендуется открывать её с помощью процедуры РазрешитьРедактированиеРеквизитовОбъекта общего модуля ЗапретРедактированияРеквизитовОбъектовКлиент.ПриСозданииНаСервере общего модуля УправлениеКонтактнойИнформацией использовать новое свойство РазмещеныНаФорме параметра ДополнительныеПараметрыКонтактнойИнформации вместо устаревшего свойства ИсключаемыеВиды, которое было названо менее очевидно. Кроме того, использование свойства РазмещеныНаФорме несколько ускорит открытие формы при большом количестве статических элементов. См. пример в демонстрационной конфигурации в процедуре ПриСозданииНаСервере модуля формы элемента справочника _ДемоКонтрагенты.Skype, АдресЭлектроннойПочты, ВебСтраница, Телефон и Факс:
КонтактнаяИнформацияОписаниеДополнительныхРеквизитов, тип – ТаблицаЗначений, добавить колонку: ИмяРеквизитаКомментарий – Строка.КомментарийКонтактнаяИнформацияПоле<ИмяВидаКонтактнойИнформации>;ГруппаКомментарийКонтактнаяИнформацияПоле<ИмяВидаКонтактнойИнформации>. Свойства: Отображение – Нет, Группировка – Горизонтальная, ОтображатьЗаголовок – Ложь;ГруппаКомментарийКонтактнаяИнформацияПоле<ИмяВидаКонтактнойИнформации> нужно перетащить ранее созданный реквизит с именем КомментарийКонтактнаяИнформацияПоле<ИмяВидаКонтактнойИнформации>, отключив отображение заголовка и установив подсказку ввода «Примечание».ГруппаКонтактнаяИнформацияПоле<ИмяВидаКонтактнойИнформации> перетащить ранее созданный реквизит с именем вида КонтактнаяИнформацияПоле<ИмяВидаКонтактнойИнформации>, установив соответствующее отображение заголовка (Лево или Верх) в зависимости от положения заголовка, передаваемого в процедуру УправлениеКонтактнойИнформацией.ПриСозданииНаСервере._ДемоКонтрагенты.ПриОткрытии с вызовом процедуры ПриОткрытии общего модуля ОбменДаннымиКлиент и подключаемые процедуры Подключаемый_ЗавершениеПроверкиДоступностиExchangeAdministrationManage_3_0_1_1, Подключаемый_ОбработкаНавигационнойСсылки:&НаКлиенте
Процедура ПриОткрытии(Отказ)
ОбменДаннымиКлиент.ПриОткрытии(ЭтотОбъект, Отказ);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_ЗавершениеПроверкиДоступностиExchangeAdministrationManage_3_0_1_1(Результат, ДополнительныеПараметры) Экспорт
ОбменДаннымиКлиент.ЗавершениеПроверкиДоступностиExchangeAdministrationManage_3_0_1_1(ЭтотОбъект);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_ОбработкаНавигационнойСсылки(Элемент, НавигационнаяСсылка, СтандартнаяОбработка)
ОбменДаннымиКлиент.ОбработкаНавигационнойСсылкиВФормеУзла(ЭтотОбъект, Элемент, НавигационнаяСсылка, СтандартнаяОбработка);
КонецПроцедурыАрхивСообщенийОбменов.ОбъектыНезарегистрированныеПриЗацикливании необходимо указать планы обменов УОП.АвтономнаяРаботаПроверитьВозможностьЗаписиОбщихДанныхАвтономнаяРаботаПроверитьВозможностьЗаписиОбщихДанныхДокументАвтономнаяРаботаПроверитьВозможностьЗаписиОбщихДанныхКонстантаАвтономнаяРаботаПроверитьВозможностьЗаписиОбщихДанныхНаборЗаписейАвтономнаяРаботаПроверитьВозможностьЗаписиОбщихДанныхНаборЗаписейРасчетаОбменДаннымиВМоделиСервиса.ПередЗаписьюОбщихДанных (см. пример ниже).Процедура _ДемоАвтономнаяРаботаПроверитьВозможностьЗаписиОбщихДанных(Источник, Отказ) Экспорт
ОбменДаннымиВМоделиСервиса.ПередЗаписьюОбщихДанных(Источник, Отказ);
КонецПроцедурыCheckDSL.erf.ВыгрузитьРегистр модуля объекта обработки КонвертацияОбъектовИнформационныхБаз необходимо вызывать функцию ВыгрузкаРегистра.ОбменДаннымиУчетныеЗаписиЭлектроннойПочты, в составе которого необходимо перечислить все типы объектов, хранящих параметры работы электронной почты. По умолчанию указан СправочникСсылка.УчетныеЗаписиЭлектроннойПочты.ПриОпределенииНастроекПечати общего модуля УправлениеПечатьюПереопределяемый и определить одноименную процедуру в модулях менеджеров этих объектов. Процедура ПриОпределенииОбъектовСКомандамиПечати общего модуля УправлениеПечатьюПереопределяемый устарела.
ПриОпределенииНастроекПечати их модулей менеджеров можно указывать, определены ли в них обработчики ДобавитьКомандыПечати и ПриОпределенииПолучателей. Подробнее см. документацию к подсистеме.Партнеры, КонтактныеЛицаПартнеров и другие) рекомендуется выполнить дополнительные изменения для отображения состояний внешних пользователей: обновить запрос и картинку значений в колонке ВнешнийДоступ, добавить обработчик ПриПолученииДанныхНаСервере и легенду. Подробнее см. в документации и демонстрационной базе в форме списке справочника _ДемоПартнеры.ДобавитьИспользованныйПароль общего модуля Пользователи. Ее больше не требуется вызывать, так как использованные пароли сохраняются автоматически при изменении пароля или сохраняемого значения пароля в объекте платформы ПользовательИнформационнойБазы.ОтправкаSMS для информирования получателей рассылки о смене паролей с помощью SMS-сообщений;Печать для печати списка паролей получателей рассылки отчетов;ЭлектроннаяПодпись для шифрования отчетов сертификатами электронной подписи.При обновлении с ранних версий библиотеки (до 3.1.8) следует:
Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.8.1, 3.1.8.20, 3.1.8.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
ПередПериодическойОтправкойДанныхКлиентаНаСервер, ПослеПериодическогоПолученияДанныхКлиентаНаСервере общего модуля ОбщегоНазначенияКлиентПереопределяемый или ПриПериодическомПолученииДанныхКлиентаНаСервере общего модуля ОбщегоНазначенияПереопределяемый, следует заменить свой отсчет времени на функцию ЗакончилосьВремяОжидания общего модуля СерверныеОповещенияКлиент. Кроме того, вызовы своих обработчиков нужно обернуть в попытку и добавить замер производительности с использованием процедур ОбработатьОшибку и ДобавитьПоказатель общих модулей СерверныеОповещенияКлиент и СерверныеОповещения. См. примеры в демонстрационной конфигурации.РаботаСФайлами.ПриЗаписиНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи, Параметры), заменить на: РаботаСФайлами.ПриЗаписиНаСервере(Отказ, ТекущийОбъект, ПараметрыЗаписи, ЭтотОбъект).РаботаСФайлами.ПриСозданииНаСервере(ЭтотОбъект, ДобавляемыеЭлементы), необходимо дополнить параметром: НастройкиРаботыСФайламиВФорме = РаботаСФайлами.НастройкиРаботыСФайламиВФорме();
НастройкиРаботыСФайламиВФорме.КопироватьПрисоединенныеФайлы = Истина;
РаботаСФайлами.ПриСозданииНаСервере(ЭтотОбъект, ДобавляемыеЭлементы, НастройкиРаботыСФайламиВФорме);ЗначениеКопирования. Подробнее см. в документации и демонстрационной базе в форме документа _ДемоЗаказПокупателя.АдминистративнаяИерархия, АдресныеОбъекты, ДомаЗданияСтроения, ДополнительныеАдресныеСведения, ЗагруженныеВерсииАдресныхСведений, ЗемельныеУчастки, ИсторияАдминистративнойИерархии, ИсторияАдресныхОбъектов, ИсторияМуниципальнойИерархии, МуниципальнаяИерархия, ПричиныИзмененияАдресныхСведений, СлужебныеАдресныеСведения, и УровниСокращенийАдресныхСведений нужно обновить в составе конфигурации. Также не следует включать их в планы обмена распределенной информационной базы (РИБ), автономного рабочего места, а также в планы обмена, предназначенные для синхронизации данных между программами, так как в каждой информационной базе или узле загрузка адресных сведений ведется независимо.В комплект поставки в папке ExtFiles\1cfresh
ПоставляемыеФайлыГАР.epf (для подсистемы Адресный классификатор), предназначенная для загрузки в программу поставляемых данных адресного классификатора формата ГАР в модели сервиса.ЗагрузкаКурсовВалют.epf (для подсистемы Валюты), предназначенная для загрузки в программу поставляемых данных курсов валют в модели сервиса.Подключаются в Менеджере сервиса, подробнее см. https://its.1c.ru/db/freshpub#content:303:hdoc.
ПроверкаВнедренияБСП.erf, повышена наглядность результатов проверки доступа к неразделенным данным. Теперь отдельно выводятся списки неразделенных данных, которых нет в контролирующей подписке, и объектов, некорректно включенных в несколько разделителей. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.Версия 3.1.7 предназначена для разработки на платформе 1С:Предприятие 8.3.17 и выше. Доступны режимы совместимости с Версия 8.3.14 по Версия 8.3.21 включительно.
Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.7.
ПодключитьКомпонентуИзМакета общего модуля ОбщегоНазначения добавлен параметр Изолированно. Подробнее о выборе типа подключения внешних компонент см. в документации к платформе 1С:Предприятие.ПриДобавленииСерверныхОповещений общего модуля ОбщегоНазначенияПереопределяемый и реализовать обработчики его отправки и получения. См. примеры в демонстрационной конфигурации.ПередПериодическойОтправкойДанныхКлиентаНаСервер общего модуля ОбщегоНазначенияКлиентПереопределяемый и их обработку в процедурах ПриПериодическомПолученииДанныхКлиентаНаСервере или ПослеПериодическогоПолученияДанныхКлиентаНаСервере общего модуля ОбщегоНазначенияПереопределяемый. При этом для отсчета времени следует применять функцию ЗакончилосьВремяОжидания общего модуля СерверныеОповещенияКлиент. Вызовы своих обработчиков нужно оборачивать в попытку и добавлять замер производительности с использованием процедур ОбработатьОшибку и ДобавитьПоказатель общих модулей СерверныеОповещенияКлиент и СерверныеОповещения. См. примеры в демонстрационной конфигурации.ОжидатьЗавершение общего модуля ДлительныеОперацииКлиент, а также заменить объект платформы СообщениеПользователю в процедурах длительных операций на процедуру СообщитьПользователю общего модуля ОбщегоНазначения. В случае если в информационной базе подключены обсуждения (система взаимодействий), то с их помощью можно более оперативно доставлять на клиент информацию о прогрессе и сообщения, которые отправляются из фонового задания.СообщенияПользователю общего модуля ДлительныеОперации. Процедура СообщитьПрогресс общего модуля ДлительныеОперации больше не отправляет прогресс через сообщения пользователю, а переведена на механизм серверных оповещений.АктОбУничтоженииПерсональныхДанных). При проведении этого документа выполняется поиск объектов информационной базы с ПДн субъектов, и затем значения их реквизитов очищаются или заменяются случайными значениями. Информация об уничтоженных данных добавляется в регистр сведений УничтоженныеПерсональныеДанные.ПриЗаполненииСведенийОбУничтожаемыхПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый. Например, персональные данные могут храниться в справочнике ФизическиеЛица в реквизитах Наименование, ФИО, ИНН, ДатаРождения.ОбменДанными.Загрузка. Поэтому при необходимости дополнительных действий при уничтожении ПДн перед записью и после записи объекта можно использовать обработчики ПередУничтожениемПерсональныхДанных и ПослеУничтоженияПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый.ПередУничтожениемПерсональныхДанныхСубъектов общего модуля ЗащитаПерсональныхДанныхПереопределяемый. Он позволяет отказаться от уничтожения ПДн, добавив субъекта в таблицу исключений с указанием причины отказа от уничтожения. Также, можно дополнить состав субъектов, например, если при уничтожении ПДн физического лица должны быть уничтожены ПДн связанных с ним кандидатов.ЗащитаПерсональныхДанных.ДобавитьСубъектыДляРасчетаСроковХранения зарегистрировать субъект для расчета срока хранения в регистре сведений СубъектыДляРасчетаСроковХранения. Таким событием может быть, например, создание нового физического лица, ввод согласия на обработку ПДн или прием сотрудника на работу. См. пример в демонстрационной конфигурации в модуле набора записей регистра сведений СогласияНаОбработкуПерсональныхДанных в процедуре ПриЗаписи.РасчетСроковХраненияПерсональныхДанных. Для расчета сроков хранения, в процедуре ПриРасчетеСроковХраненияПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый разработчик должен заполнить таблицу значений, в которую различные подсистемы добавляют рассчитанные сроки хранения. Датой, после которой данные подлежат уничтожению, будет определена самая поздняя из всех заполненных для этого субъекта. Рассчитанные сроки хранения записываются в регистр сведений СрокиХраненияПерсональныхДанных.ОрганизацияПоУмолчанию общего модуля ЗащитаПерсональныхДанныхПереопределяемый можно заполнить организацию значением по умолчанию при создании документов АктОбУничтоженииПерсональныхДанных, СогласиеНаОбработкуПерсональныхДанных и ОтзывСогласияНаОбработкуПерсональныхДанных.ДатаУничтоженияДанныхСубъекта общего модуля ЗащитаПерсональныхДанных можно получить дату уничтожения ПДн субъекта.ИспользоватьУничтожениеПерсональныхДанныхСубъектов общего модуля ЗащитаПерсональныхДанных можно определить, включено ли уничтожение персональных данных в настройках программы.УдаленныйДоступOData при помощи инструмента Проверка внедрения БСП рекомендуется перечислять такие объекты в процедуре ПриЗаполненииЗависимыхТаблицДляВыгрузкиЗагрузкиOData общего модуля ИнтерфейсODataПереопределяемый.Удалить) в переопределяемую процедуру ПриЗаполненииОбъектовПланируемыхКУдалению общего модуля ОбновлениеИнформационнойБазыПереопределяемый с помощью процедуры ДобавитьОбъектПланируемыйКУдалению общего модуля ОбновлениеИнформационнойБазы. Подробнее см. в документации в разделе Очистка устаревших данных.ПользовательСистемыВзаимодействия общего модуля Обсуждения можно получить идентификатор пользователя системы взаимодействия. Для этого нужно указать Истина для необязательного параметра ТолькоИдентификатор. Это полезно, когда нужен только идентификатор, а не пользователь системы взаимодействия, что вдвое сокращает количество вызовов системы взаимодействия.Подписать модуля ЭлектроннаяПодписьКлиент добавлен конструктор НовыйТипПодписи, который позволяет управлять списком выбора, отображением и доступностью типа подписи в форме подписания.В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).
Для обновления следующих переопределяемых общих модулей требуется перенести из поставки библиотеки новые экспортные процедуры, удалить отсутствующие и убедиться, что комментарии, количество и имена параметров у процедур совпадают с поставкой библиотеки:
ЗащитаПерсональныхДанныхПереопределяемый,ОбщегоНазначенияКлиентПереопределяемый,ОбщегоНазначенияПереопределяемый,РассылкаОтчетовПереопределяемый,ТекущиеДелаПереопределяемый.Рекомендации по задействованию новых возможностей переопределяемых общих модулей приведены выше в разделе Новые возможности для разработчиков.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки. В исключительных (редких) случаях, когда такая совместимость не обеспечена, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки, в этом разделе приведены необходимые инструкции. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
АдминистративнаяИерархия, АдресныеОбъекты, ДомаЗданияСтроения, ДополнительныеАдресныеСведения, ЗагруженныеВерсииАдресныхСведений, ЗемельныеУчастки, ИсторияАдминистративнойИерархии, ИсторияАдресныхОбъектов, ИсторияМуниципальнойИерархии, МуниципальнаяИерархия, ПричиныИзмененияАдресныхСведений, СлужебныеАдресныеСведения, и УровниСокращенийАдресныхСведений нужно обновить в составе конфигурации. Также не следует включать их в планы обмена распределенной информационной базы (РИБ), автономного рабочего места, а также в планы обмена, предназначенные для синхронизации данных между программами, так как в каждой информационной базе или узле загрузка адресных сведений ведется независимо.СостояниеОтправкиСерверныхОповещений и регистры сведений ОтправленныеСерверныеОповещения и ПериодическиеСерверныеОповещения не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.ДоставлятьСерверныеОповещенияБезСистемыВзаимодействия и РегистрироватьПоказателиСерверныхОповещений не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места, а также планов обмена, предназначенных для синхронизации данных между различными программами.СообщитьПрогресс общего модуля ДлительныеОперации могла использоваться не только для информирования о прогрессе длительной операции, но и для управления прикладной логикой. Такие места необходимо пересмотреть, например, перенести логику в обработчик завершения длительной операции. Это связано с тем, что для оптимизации производительности отправленные оповещения прогресса теперь доставляются на клиент не чаще одного раза в три секунды.ДнейДоСкрытияПерсональныхДанныхСубъектов. Следует удалить все обращения к ней в коде, запросах и отчетах.НастройкиПользователейИПрав обработки ПанельАдминистрированияБСП. Если эта форма дорабатывалась в конечной конфигурации, то убедиться, что при обновлении изменения не были потеряны.СпискиОтзываСертификатов не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
ЗаполнитьОбластиПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый заполнить коллекцию категорий персональных данных, которые будут использоваться при описании состава персональных данных в процедуре ПриЗаполненииСведенийОбУничтожаемыхПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый.ЗащитаПерсональныхДанных отмечены как устаревшие:
ИзменитьНастройкиСкрытияПерсональныхДанных, следует использовать ИзменитьНастройкиУничтоженияПерсональныхДанных;ЭтоОбъектСоСкрытымиПерсональнымиДанными, следует использовать ЭтоОбъектСУничтоженнымиПерсональнымиДанными;СкрытьПерсональныеДанныеСубъектов и ПослеЗагрузкиДанных, рекомендуется удалить все обращения к ним в коде.ИмяФормыДлительнойОперации общего модуля ДополнительныеОтчетыИОбработкиКлиент отмечена, как устаревшая. Вместо неё рекомендуется использовать оповещение, передаваемое в параметр Обработчик процедуры ВыполнитьКомандуВФоне того же общего модуля.ПередЗагрузкойДанныхИзНастроекНаСервере и ПриСозданииНаСервере общего модуля ТекущиеДелаПереопределяемый. Если данные процедуры используются для переопределения поведения в подключенных к текущим делам объектах, рекомендуется перенести их в модули конфигурации и заменить места вызова.При обновлении с ранних версий библиотеки (до 3.1.7) следует:
Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.7.1, 3.1.7.20, 3.1.7.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
АктОбУничтоженииПерсональныхДанных). При проведении этого документа выполняется поиск объектов информационной базы с ПДн субъектов, и затем значения их реквизитов очищаются или заменяются случайными значениями. Информация об уничтоженных данных добавляется в регистр сведений УничтоженныеПерсональныеДанные.ПриЗаполненииСведенийОбУничтожаемыхПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый. Например, персональные данные могут храниться в справочнике ФизическиеЛица в реквизитах Наименование, ФИО, ИНН, ДатаРождения.ОбменДанными.Загрузка. Поэтому при необходимости дополнительных действий при уничтожении ПДн перед записью и после записи объекта можно использовать обработчики ПередУничтожениемПерсональныхДанных и ПослеУничтоженияПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый.ПередУничтожениемПерсональныхДанныхСубъектов общего модуля ЗащитаПерсональныхДанныхПереопределяемый. Он позволяет отказаться от уничтожения ПДн, добавив субъекта в таблицу исключений с указанием причины отказа от уничтожения. Также, можно дополнить состав субъектов, например, если при уничтожении ПДн физического лица должны быть уничтожены ПДн связанных с ним кандидатов.ЗащитаПерсональныхДанных.ДобавитьСубъектыДляРасчетаСроковХранения зарегистрировать субъект для расчета срока хранения в регистре сведений СубъектыДляРасчетаСроковХранения. Таким событием может быть, например, создание нового физического лица, ввод согласия на обработку ПДн или прием сотрудника на работу. См. пример в демонстрационной конфигурации в модуле набора записей регистра сведений СогласияНаОбработкуПерсональныхДанных в процедуре ПриЗаписи.РасчетСроковХраненияПерсональныхДанных. Для расчета сроков хранения, в процедуре ПриРасчетеСроковХраненияПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый разработчик должен заполнить таблицу значений, в которую различные подсистемы добавляют рассчитанные сроки хранения. Датой, после которой данные подлежат уничтожению, будет определена самая поздняя из всех заполненных для этого субъекта. Рассчитанные сроки хранения записываются в регистр сведений СрокиХраненияПерсональныхДанных.ОрганизацияПоУмолчанию общего модуля ЗащитаПерсональныхДанныхПереопределяемый можно заполнить организацию значением по умолчанию при создании документов АктОбУничтоженииПерсональныхДанных, СогласиеНаОбработкуПерсональныхДанных и ОтзывСогласияНаОбработкуПерсональныхДанных.ДатаУничтоженияДанныхСубъекта общего модуля ЗащитаПерсональныхДанных можно получить дату уничтожения ПДн субъекта.ИспользоватьУничтожениеПерсональныхДанныхСубъектов общего модуля ЗащитаПерсональныхДанных можно определить использование в базе механизма уничтожения персональных данных.ЗащитаПерсональныхДанныхПереопределяемый требуется перенести из поставки библиотеки новые экспортные процедуры, удалить отсутствующие и убедиться, что комментарии, количество и имена параметров у процедур совпадают с поставкой библиотеки.ДнейДоСкрытияПерсональныхДанныхСубъектов. Следует удалить все обращения к ней в коде, запросах и отчетах.НастройкиПользователейИПрав обработки ПанельАдминистрированияБСП. Если эта форма дорабатывалась в конечной конфигурации, то убедиться, что при обновлении изменения не были потеряны.ЗаполнитьОбластиПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый заполнить коллекцию областей персональных данных, которые будут использоваться при описании состава персональных данных в процедуре ПриЗаполненииСведенийОбУничтожаемыхПерсональныхДанных общего модуля ЗащитаПерсональныхДанныхПереопределяемый.ЗащитаПерсональныхДанных отмечены как устаревшие:
ИзменитьНастройкиСкрытияПерсональныхДанных, следует использовать ИзменитьНастройкиУничтоженияПерсональныхДанных;ЭтоОбъектСоСкрытымиПерсональнымиДанными, следует использовать ЭтоОбъектСУничтоженнымиПерсональнымиДанными;СкрытьПерсональныеДанныеСубъектов и ПослеЗагрузкиДанных, рекомендуется удалить все обращения к ним в коде.ПередПериодическойОтправкойДанныхКлиентаНаСервер, ПослеПериодическогоПолученияДанныхКлиентаНаСервере общего модуля ОбщегоНазначенияКлиентПереопределяемый или ПриПериодическомПолученииДанныхКлиентаНаСервере общего модуля ОбщегоНазначенияПереопределяемый, следует заменить свой отсчет времени на функцию ЗакончилосьВремяОжидания общего модуля СерверныеОповещенияКлиент. Кроме того, вызовы своих обработчиков нужно обернуть в попытку и добавить замер производительности с использованием процедур ОбработатьОшибку и ДобавитьПоказатель общих модулей СерверныеОповещенияКлиент и СерверныеОповещения. См. примеры в демонстрационной конфигурации.УдаленныйДоступOData при помощи инструмента Проверка внедрения БСП рекомендуется перечислять такие объекты в процедуре ПриЗаполненииЗависимыхТаблицДляВыгрузкиЗагрузкиOData общего модуля ИнтерфейсODataПереопределяемый.АдминистративнаяИерархия, АдресныеОбъекты, ДомаЗданияСтроения, ДополнительныеАдресныеСведения, ЗагруженныеВерсииАдресныхСведений, ЗемельныеУчастки, ИсторияАдминистративнойИерархии, ИсторияАдресныхОбъектов, ИсторияМуниципальнойИерархии, МуниципальнаяИерархия, ПричиныИзмененияАдресныхСведений, СлужебныеАдресныеСведения, и УровниСокращенийАдресныхСведений нужно обновить в составе конфигурации. Также не следует включать их в планы обмена распределенной информационной базы (РИБ), автономного рабочего места, а также в планы обмена, предназначенные для синхронизации данных между программами, так как в каждой информационной базе или узле загрузка адресных сведений ведется независимо.В комплект поставки в папке ExtFiles\1cfresh
ПоставляемыеФайлыГАР.epf (для подсистемы Адресный классификатор), предназначенная для загрузки в программу поставляемых данных адресного классификатора формата ГАР в модели сервиса.ЗагрузкаКурсовВалют.epf (для подсистемы Валюты), предназначенная для загрузки в программу поставляемых данных курсов валют в модели сервиса.Подключаются в Менеджере сервиса, подробнее см. https://its.1c.ru/db/freshpub#content:303:hdoc.
Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, улучшена проверка состава роли УдаленныйДоступOData: в ней должны быть права чтения на все параметры сеанса. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.СпискиОтзываСертификатов не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.НаборыДополнительныхРеквизитовИСведений и его описание было перенесено в процедуру ПриПолученииПредопределенныхНаборовСвойств общего модуля УправлениеСвойствамиПереопределяемый, то в этом случае в формах объектов со свойствами могут быть утеряны пользовательские настройки внешнего вида форм (например, размер окна и расположение полей). Для того чтобы не потерять эти настройки, требуется добавить обработчик обновления, в котором вызвать процедуру УправлениеСвойствами.ВосстановитьНастройкиФормСДополнительнымиРеквизитами.РазрешенныеНеаккредитованныеУЦ рекомендуется включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места. Enterprise Data реализованы следующие возможности:
Договоры расширено полем ИдентификаторГосКонтракта, что позволяет синхронизировать информацию о государственных контрактах между приложениями;КодТРУ, дополнительно формат расширен новым перечислением ТипыПлатежнойСистемыККТ;КБК и ПотенциальноВозможныйГодовойДоход стали необязательными. Это расширяет возможность конвертации справочника из программ, где патенты учитываются в урезанном виде;Версия 3.1.6 предназначена для разработки на платформе 1С:Предприятие 8.3.17 и выше. Доступны режимы совместимости с Версия 8.3.14 по Версия 8.3.21 включительно.
Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.6.
В состав библиотеки включена новая подсистема Конструктор формул, предоставляющая удобную форму редактирования формул, в которой выводятся доступные операнды и операторы. При наличии подсистемы Мультиязычность операнды и операторы формулы отображаются на текущем языке интерфейса.
ПередЗапускомПрограммы общего модуля ОбщегоНазначенияПереопределяемый можно выполнить произвольные действия перед запуском программы, например, настроить начальную страницу и другие параметры интерфейса в зависимости от режима работы.МетаданныеСправочники, МетаданныеДокументы и т.п. (начинаются со слова Метаданные).ВыборОбъектовМетаданных возможен выбор объектов метаданных ОбщиеРеквизиты, HTTPСервисы и ВнешниеИсточникиДанных. В режиме выбора По видам объектов теперь также отображаются узнаваемые картинки для всех видов объектов метаданных.ОбщегоНазначенияКлиентСервер появились функции ДатаHTTP и ДатаRFC1123 для преобразования даты в формат RFC-1123 и обратно, используемые при работе с файлами, получаемыми из интернета.ДлительныеОперации для запуска процедуры длительной операции вызвать функцию ВыполнитьПроцедуруВНесколькоПотоков (или ВыполнитьФункциюВНесколькоПотоков), передав третьим параметром сформированный набор данных. Подробное описание параметров см. в комментарии к этим функциям.ЗагрузкаАдресногоКлассификатора регистра сведений АдресныеОбъекты.ПараметрыОжидания общего модуля ДлительныеОперацииКлиент:
Заголовок позволяет отобразить произвольный заголовок в окне ожидания выполнения длительной операции.ОповещениеПользователя добавлены новые свойства:
Картинка определяет отображаемую картинку в оповещении по завершению длительной операции.Важное позволяет отметить оповещение как важное, и тогда оповещение также будет выведено в центр оповещений.ПриДобавленииПереименованийОбъектовМетаданных общего модуля ОбщегоНазначенияПереопределяемый. Теперь переименования ролей отслеживаются автоматически.ПриОпределенииСвойствЭлементовФормыНастроек модуля отчета можно задавать следующие свойства группы: Заголовок, ЦветФона, Подсказка, ОтображениеПодсказки, Высота, Ширина, РастягиватьПоВертикали и РастягиватьПоГоризонтали. См. процедуру СвойстваГруппыЭлементовФормы общего модуля ОтчетыСервер и пример в процедуре ПриОпределенииСвойствЭлементовФормыНастроек модуля отчета УниверсальныйОтчет.ПриНачалеВыбораЗначений общего модуля ОтчетыКлиентПереопределяемый можно переопределить форму выбора значений в полях отборов отчета. Например, это задействовано в отчете ПраваРолей для отбора по ролям и объектам метаданных с помощью общей формы ВыборОбъектовМетаданных.ПередФормированиемОтчета - см. функцию НастройкиОтчетаПоУмолчанию общего модуля ОтчетыКлиентСервер. Например, это может быть необходимо, чтобы вывести предупреждение перед формированием слишком большого отчета.ДополнительныеСвойства параметра НовыеНастройкиКД и объекта Настройки компоновщика настроек (объекта отчета) события модуля отчета ПередЗагрузкойНастроекВКомпоновщик. В них передаются свойства КлючВарианта, КлючПредопределенногоВарианта, КонтекстВарианта и ФормаПараметрыОтбор, которые позволяют точнее учитывать контекст создания отчета.ПослеЗагрузкиНастроекВКомпоновщик вместо устаревшего события ПриОпределенииПараметровВыбора (см. описание в функции НастройкиОтчетаПоУмолчанию общего модуля ОтчетыКлиентСервер). В нем возможно не только уточнять параметры выбора (например, список выбора), но и делать это с учетом загруженных фиксированных настроек. Кроме того, новое событие вызывается и при неинтерактивном формировании отчета, например, при рассылке отчетов.ОтключитьСтандартноеКонтекстноеМеню, позволяющий отключить использование контекстного меню и настройки колонки отчета. См. описание в функции НастройкиОтчетаПоУмолчанию общего модуля ОтчетыКлиентСервер.ПриНачальномЗаполненииЭлементов и ПриНачальномЗаполненииЭлемента общего модуля УправлениеКонтактнойИнформациейПереопределяемый. Кроме того, с ее помощью можно также задавать создание папок (группы справочника ВидыКонтактнойИнформации). См. примеры в демонстрационной конфигурации.ОткрытьОтчетПоПроблемам общего модуля КонтрольВеденияУчетаКлиент добавлен необязательный параметр ТочноеСоответствие, который позволяет настроить применение отбора по параметру ВидПроверок при открытии отчета.МультиязычностьСервер предусмотрена процедура ИзменитьПолеЗапросаПодТекущийЯзык изменяющая наименование мультиязычного реквизита в текст запроса на наименование реквизита согласно текущего языка пользователя. Например, для первого дополнительного языка процедура меняет Наименование на НаименованиеЯзык1. Подробнее см. комментарий к процедуре.НапоминанияПользователя расширен функцией ИспользуютсяНапоминанияПользователя для проверки возможности использования напоминаний пользователя.Процедура ПриИзмененииОпцииАвтономногоРежимаРаботы общего модуля ОбменДаннымиПереопределяемый вызывается при изменении режима работы информационной базы и позволяет выполнить дополнительные действия, например, проинициализировать связанные константы и настройки.
При синхронизации данных через универсальный формат EnterpriseData появилась возможность выполнять правила регистрации, расположенные в общем модуле конфигурации или расширения. Для этого необходимо в менеджере плана обмена в процедуре ПриПолученииНастроек указать настройки ПравилаРегистрацииВМенеджере и МенеджерРегистрации. Пример настройки:
Процедура ПриПолученииНастроек(Настройки) Экспорт
…
Настройки.ПравилаРегистрацииВМенеджере = Истина;
Настройки.МенеджерРегистрации = "_ДемоМенеджерРегистрацииДляУниверсальногоФормата";
КонецПроцедуры
Для создания общего модуля необходимо использовать конфигурацию Конвертация данных версии не меньше 3.1.1. У общего модуля должны быть установлены следующие контексты выполнения: Сервер, Внешнее соединение, Клиент (обычное приложение).
В обработке Выгрузка загрузка EnterpriseData в режиме разработчика возможно работать с общим каталогом временных файлов (опционально). Опция размещена в меню Еще и доступна в режиме загрузки данных.
ОбновлениеИнформационнойБазы расширен методами ЗаписатьСобытиеВЖурналРегистрации, ПерезапуститьОтложенноеОбновление, ПерезапуститьМонопольноеОбновление, ЗарегистрироватьПроблемуСДанными, ВключитьОтключитьОтложенноеОбновление. Подробнее см. в описании к ним.ОбновлениеИнформационнойБазыПереопределяемый расширен методом ПриЗаполненииПриоритетовТиповМетаданных. Подробнее см. в описании к нему.Параметры, которая передается на вход отложенных обработчиков обновления, расширена свойством ВерсияПодсистемыНаНачалоОбновления. В нем передается полный номер версии подсистемы, к которой он относится, на момент начала обновления программы. Например, 3.1.5.123. Может быть полезно для ветвления логики выполнения обработчика в зависимости от версии, с которой выполняется обновление программы.Описание обработчиков обновления (Функции для технического специалиста - Описание обработчиков обновления) теперь позволяет отбирать отложенные обработчики обновления, у которых указана нестандартная процедура проверки необработанных данных. Данная возможность требуется для контроля, т.к. процедура проверки позволяет проверять доступность объекта для редактирования в процессе отложенного обновления и должна отвечать некоторым требованиям:
ПриНачальномЗаполненииЭлементов модуля менеджера справочника или общего модуля ОбновлениеИнформационнойБазыПереопределяемый.
ПриНастройкеНачальногоЗаполненияЭлементов модуля менеджера справочника или общего модуля ОбновлениеИнформационнойБазыПереопределяемый для свойства настроек ИмяКлючевогоРеквизита следует указать имя реквизита, значение которого определяет уникальный идентификатор элемента;ПриНачальномЗаполненииЭлементов общих модулей _ДемоОбновлениеИнформационнойБазыБСП и _ДемоСвойства демонстрационной конфигурации.ПриНачальномЗаполненииЭлементов в процедуре ЗаполнитьЭлементыНачальнымиДанными программный интерфейс общего модуля ОбновлениеИнформационнойБазы расширен третьим параметром НастройкиЗаполнения у которого в свойстве Реквизиты определяется список обновляемых реквизитов через запятую. Подробнее см. в комментарии к ней.ОбновлениеИнформационнойБазы предусмотрена процедура ЗаполнитьОбъектНачальнымиДанными, которая заполняет объект данными, описанными в процедуре ПриНачальномЗаполненииЭлементов без его записи.ПриДобавленииОбработчиковПереходаСДругойПрограммы общего модуля, имя которого задано в процедуре ПодсистемыКонфигурацииПереопределяемый.ПриДобавленииПодсистем;Оперативно и Монопольно;ПриДобавленииПодсистемы общего модуля ОбновлениеИнформационнойБазы<Сокращение> указать свойство ЗаполнятьДанныеНовыхПодсистемПриПереходеСДругойПрограммы.
НеВыполнятьПриПереходеСДругойПрограммы в значение Истина.Пользователи расширен процедурами и функциями:
УстановитьНастройкиВхода для сохранения настроек входа пользователей;НовоеОписаниеНастроекВхода для получения структуры с настройками входа по умолчанию;ДобавитьИспользованныйПароль для добавления пароля в список используемых, если в настройках для входа заполнено свойство ЗапретитьПовторениеПароляСредиПоследних.СообщитьОбОшибкеПодключения в общем модуле РаботаСПочтовымиСообщениямиКлиент.ПоясненияПоОшибке и РасширенноеПредставлениеОшибки в общем модуле РаботаСПочтовымиСообщениями.ПриНачальномЗаполненииЭлементов и ПриНачальномЗаполненииЭлемента общего модуля УправлениеСвойствамиПереопределяемый. См. примеры в демонстрационной конфигурации.УдалениеПомеченныхОбъектовПереопределяемый предусмотрены процедуры ПередУдалениемГруппыОбъектов и ПослеУдаленияГруппыОбъектов. Например, после удаления группы связанных объектов теперь возможно очистить связанные с ними данные на внешних ресурсах или выполнить другие операции, которые недопустимо выполнять в транзакции удаления.Подписать модуля ЭлектроннаяПодписьКлиент добавлен необязательный параметр ТипПодписи. Если усовершенствованные подписи недоступны в используемой версии платформы 1С:Предприятие, то параметр игнорируется, подписание выполняется в базовом формате CAdES-BES.УсовершенствоватьПодпись общего модуля ЭлектроннаяПодписьКлиент, в модуль ЭлектроннаяПодпись добавлены процедуры УсовершенствоватьПодпись и УсовершенствоватьПодписьОбъекта. Для определения доступности усовершенствования подписей в зависимости от используемой версии платформы 1С:Предприятие имеется функция ДоступнаУсовершенствованнаяПодпись.УстановленныеПодписи модуля ЭлектроннаяПодпись появился необязательный параметр ПорядковыйНомер.ОбновитьПодпись модуля ЭлектроннаяПодпись добавлен необязательный параметр ОбновитьПоПорядковомуНомеру.НовыеСвойстваПодписи модуля ЭлектроннаяПодписьКлиентСервер в качестве начального значения параметра СвойстваПодписи процедур ДобавитьПодпись и ОбновитьПодпись общего модуля ЭлектроннаяПодпись. ### Электронная подпись сервиса DSSСлужебнаяУчетнаяЗаписьDSS из планов обмена распределенной информационной базы (РИБ) и автономного рабочего места. В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).
Для обновления следующих переопределяемых общих модулей требуется перенести из поставки библиотеки новые экспортные процедуры, удалить отсутствующие и убедиться, что комментарии, количество и имена параметров у процедур совпадают с поставкой библиотеки:
ОбменДаннымиПереопределяемый,ОбновлениеИнформационнойБазыПереопределяемый,ОбщегоНазначенияПереопределяемый,ОрганизацииПереопределяемый,ОтчетыКлиентПереопределяемый,УправлениеКонтактнойИнформациейПереопределяемый,УправлениеСвойствамиПереопределяемый.Рекомендации по задействованию новых возможностей переопределяемых общих модулей приведены выше в разделе Новые возможности для разработчиков.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки. В исключительных (редких) случаях, когда такая совместимость не обеспечена, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки, в этом разделе приведены необходимые инструкции. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
КоличествоПотоковДлительныхОпераций, КаталогВременныхФайловДляLinux, КаталогВременныхФайловДляWindows, СтандартныеПодсистемыВАвтономномРежиме и регистр сведений ДлительныеОперации не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.ИспользоватьОптимизированнуюЗаписьСозданияАвтономногоРабочегоМеста не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.ПрогрессОбновления не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.ДанныеДляИзмененияМультиязычныхРеквизитов в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.ОрганизацииПереопределяемый процедура ПриОпределенииРегистрационныхДанныхИностраннойОрганизации переименована в ПриОпределенииРегистрационныхДанныхОтделенияИностраннойОрганизации.МакетыПечатныхФорм в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.ИспользоватьГруппыВнешнихПользователей в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.НастройкиВходаПользователей из состава планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.НастройкиАвторизацииИнтернетСервисов в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.АдресаСерверовМетокВремени, ДобавлятьМеткиВремениАвтоматически, ТипПодписиКриптографииПоУмолчанию, УсовершенствоватьПодписиАвтоматически, УсовершенствоватьПодписиСДатыи регистры сведений ОповещенияПользователейСертификатов, ЗаявленияНаВыпускСертификата.ДобавлениеИзменениеЭлектронныхПодписейИШифрование на новые роли ДобавлениеИзменениеЭлектронныхПодписей, ШифрованиеИРасшифровкаДанных, РасшифровкаДанных , ДобавлениеИзменениеСертификатовКлючейЭлектроннойПодписиИШифрования , ДобавлениеИзменениеПрограммЭлектроннойПодписиИШифрования согласно назначению ролей. АккредитованныеУдостоверяющиеЦентры не следует включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места.РазрешенныеНеаккредитованныеУЦ рекомендуется включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места. Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
Информация отмечена как устаревшая и переименована в УдалитьИнформация. Вместо нее следует использовать стандартную картинку Информация._ДемоОформлениеОтчетовБежевый и в процедуре ПередЗагрузкойВариантаНаСервере общего модуля ОтчетыПереопределяемый.При обновлении с ранних версий библиотеки (до 3.1.6) следует:
Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.6.1, 3.1.6.20, 3.1.6.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
Константу РазрешенныеНеаккредитованныеУЦ рекомендуется включать в состав планов обмена РИБ и автономного рабочего места (АРМ).
Enterprise Data реализованы следующие возможности:
Договоры расширено полем ИдентификаторГосКонтракта, что позволяет синхронизировать информацию о государственных контрактах между приложениями;КодТРУ, дополнительно формат расширен новым перечислением ТипыПлатежнойСистемыККТ;КБК и ПотенциальноВозможныйГодовойДоход стали необязательными. Это расширяет возможность конвертации справочника из программ, где патенты учитываются в урезанном виде;Enterprise Data до версии 1.10.6, в который добавлен документ УдержанныйНДФЛ для отражения сведений о Едином Налоговом Платеже (ЕНП).Константу АккредитованныеУдостоверяющиеЦентры не следует включать в состав планов обмена РИБ и автономного рабочего места (АРМ).
ПриДобавленииПодсистемы общего модуля ОбновлениеИнформационнойБазы<Сокращение> указать свойство ЗаполнятьДанныеНовыхПодсистемПриПереходеСДругойПрограммы.НеВыполнятьПриПереходеСДругойПрограммы в значение Истина.ОрганизацииПереопределяемый процедура ПриОпределенииРегистрационныхДанныхИностраннойОрганизации переименована в ПриОпределенииРегистрационныхДанныхОтделенияИностраннойОрганизации.В планы обмена РИБ включить новые константы АдресаСерверовМетокВремени, ДобавлятьМеткиВремениАвтоматически, ТипПодписиКриптографииПоУмолчанию, УсовершенствоватьПодписиАвтоматически, УсовершенствоватьПодписиСДаты. Включить в обработчики регистрации изменений планов обмена РИБ. Перенести в конфигурацию соответствующие изменения из формы ОбщиеНастройки обработки ПанельАдминистрированияБСП.
Версия 3.1.5 предназначена для разработки на платформе 1С:Предприятие в режиме совместимости с версиями 8.3.14, 8.3.15, 8.3.16 или 8.3.17, т.е.:
Режим совместимости установлено значение Не использовать;Режим совместимости установлено значение Версия 8.3.14 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15, Версия 8.3.16 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15, Версия 8.3.16 или Версия 8.3.17.Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.5.
В состав библиотеки включена новая подсистема Электронная облачная подпись, которая расширяет возможности подсистемы Электронная подпись. С ее помощью все основные операции подписи и шифрования выполняются в облачном сервисе КриптоПро DSS (см. страничку продукта на сайте КриптоПро).
Организованное таким способом централизованное защищенное хранение закрытых ключей пользователей позволяет отказаться от установки средств криптографии на компьютерах и имеет сертификат соответствия требованиям ФСБ России для работы с квалифицированной электронной подписью.
В подсистеме предусмотрена проверка действительности сертификатов и электронных подписей документов с использованием сервиса КриптоПро SVS (см. страничку продукта на сайте КриптоПро). Поддержка этого сервиса позволяет организовать полноценную работу с электронной подписью, не устанавливая средства криптографии на компьютеры пользователей. Предварительная настройка подсистемы выполняется в разделе Администрирование – Общие настройки – Электронная подпись и шифрование. Для разработчиков программный интерфейс подсистемы Электронная подпись не претерпел изменений, и использование новой подсистемы проходит прозрачно.
ЗавершитьРаботуПользователей расширен свойствами:
ИмяАдминистратора - имя администратор кластера серверов 1С;ПарольАдминистратора - пароль администратор кластера серверов 1С;Сообщение - текст сообщения, выдаваемого пользователям в качестве предупреждения о планируемой блокировке соединений;КодРазрешения - произвольная строка для входа в программу, несмотря на установленную блокировку (для параметра запуска /UC);ОжиданиеМин - время отсрочки начала блокировки программы, в минутах;ДлительностьМин - длительность блокировки программы с учетом отсрочки, в минутах. Например: 1С 1cv8.exe" ENTERPRISE /F "<Путь к информационной базе>" /N "Администратор" /P /C "ЗавершитьРаботуПользователей, ИмяАдминистратора=Администратор, ПарольАдминистратора=1, Сообщение=Необходимо завершить работу в программе для внепланового обновления, КодРазрешения=Обновление, ОжиданиеМин=5, ДлительностьМин=30ОбщегоНазначенияКлиентСервер реализована функция СтрокаВДату.ОбщегоНазначенияКлиентСервер реализована функция ЭтоЧисло.СтроковыеФункции и СтроковыеФункцииКлиент реализована функция ПредставлениеПериодаВТексте.ОбработкаСервисовИнтеграции, которое требуется включить при задействовании данной возможности. Подробнее о продукте см. «Интергационная шина».ПриОпределенииПризнакаЭтоБазоваяВерсияКонфигурации общего модуля ОбщегоНазначенияПереопределяемый. Он влияет на корректную работу различных механизмов конфигурации, таких как работа с внешним соединением (COM) и другие.РасчетныеПоказателиЯчеек общего модуля ОбщегоНазначенияКлиентСервер добавлен необязательный параметр ПараметрыРасчета типа возвращаемого значения функции ПараметрыРасчетаПоказателейЯчеек общего модуля ОбщегоНазначенияКлиентСервер. В новом параметре свойство РассчитатьНаСервере позволяет разработчику явно указать, выполнять расчет на сервере или на клиенте, вместо автоопределения.В процедуре ОпределитьНастройкиФормы модуля отчета значение свойства Настройки.ВариантПериода изменить на Финансовый:
Настройки.ВариантПериода = Перечисления.ВариантыПериода.Финансовый;ОпределитьНастройкиФормы модуля объекта, значение свойства настроек ВариантПредставленияПериода изменить на Гиперессылка: 1С Настройки.ВариантПредставленияПериода = Перечисления.ВариантыПредставленияПериода.Гиперессылка;СоединенияИБКлиент дополнен процедурами УстановитьРежимЗавершенияРаботыПользователей и УстановитьПризнакЗавершитьВсеСеансыКромеТекущего. Подробнее см. в комментарии к ним.ОпределитьПараметрыЗагрузкиДанныхИзФайла модуля менеджера справочника можно задавать значение нового свойства ПредставлениеОбъекта параметра Параметры. Например, загрузка данных выполняется в справочник Контрагенты, но вместо этого необходимо отобразить Клиент. Пример см. в демонстрационной конфигурации в модуле менеджере справочника _ДемоНоменклатура.ЗагрузкаДанныхИзФайла предусмотрены функции-конструкторы НастройкиЗагрузкиДанных, ОписаниеЗагружаемыхДанныхДляСправочников, НовыйСписокНеоднозначностей, ТаблицаСопоставления. Подробнее см. в демонстрационной конфигурации в модуле менеджера справочника _ДемоНоменклатура.Ложь в новый параметр ТолькоВидимые процедуры РазрешитьРедактированиеРеквизитовОбъекта общего модуля ЗапретРедактированияРеквизитовОбъектовКлиент. Однако для пользователя может быть неожиданным то, что в списке реквизитов есть такие, которые не удается найти на форме (они не видимы).Обновлен универсальный формат обмена Enterprise Data до версии 1.10.6, в который добавлен документ УдержанныйНДФЛ для отражения сведений о Едином Налоговом Платеже (ЕНП).
В версии 1.11.5 универсального формата обмена Enterprise Data реализованы следующие возможности:
Договоры расширено полем ИдентификаторГосКонтракта, что позволяет синхронизировать информацию о государственных контрактах между приложениями;КодТРУ, дополнительно формат расширен новым перечислением ТипыПлатежнойСистемыККТ;КБК и ПотенциальноВозможныйГодовойДоход стали необязательными. Это расширяет возможность конвертации справочника из программ, где патенты учитываются в урезанном виде;Для записи узла обмена при помощи длительной операции, необходимо в обработчик события формы ПередЗаписью добавить вызов процедуры ОбменДаннымиКлиент.ПередЗаписью. При этом необходимо убедится, что в последующих процедурах, таких как ПриЗаписи, не происходит изменения данных узла. Например, см. план обмена _ДемоСинхронизацияДанныхЧерезУниверсальныйФормат в демонстрационной конфигурации.
При разработке правил для универсального обмена данными рекомендуется использовать функцию ОбменДаннымиXDTO.КлассКлючевыеСвойства для обращения к ключевым свойствам объекта.
Например:
КлючевыеСвойства = ОбменДаннымиXDTOСервер.КлассКлючевыеСвойства();
Код = Лев(ДанныеИБ.Наименование, 4);
Если СтекВыгрузки.Количество() = 1 Тогда
ДанныеXDTO[КлючевыеСвойства].Вставить("Код", Код);
Иначе
ДанныеXDTO.Вставить("Код", Код);
КонецЕсли;ПриФормированиеСпискаРазрабатываемыхПодсистем общего модуля ОбновлениеИнформационнойБазыПереопределяемый устарела, вместо нее следует использовать процедуру ПриФормированииСпискаРазрабатываемыхПодсистем этого же модуля.УправлениеПечатьюКлиент предусмотрена функция-конструктор ОписаниеПараметровПечати. Подробнее см. в демонстрационной конфигурации в модуле формы ОсновнаяФорма справочника _ДемоОрганизации.ПриЗапретеРаботыСВнешнимиРесурсами и ПриРазрешенииРаботыСВнешнимиРесурсами общего модуля БлокировкаРаботыСВнешнимиРесурсамиПереопределяемый. Подробнее про блокировку работы с внешними ресурсами см. в документации - Глава 5. Пользовательская документация - раздел 5.53 Регламентные задания - Особенности выполнения регламентных заданий при копировании информационной базы.ПрофилиГруппДоступа, а достаточно только перечислить их в процедуре ПриЗаполненииПоставляемыхПрофилейГруппДоступа общего модуля УправлениеДоступомПереопределяемый. Кроме того, с ее помощью можно также задавать папки (группы справочника ПрофилиГруппДоступа) с поставляемыми профилями групп доступа.
Администратор справочника ПрофилиГруппДоступа и Администраторы справочника ГруппыДоступа рекомендуется вызывать, соответственно, функции ПрофильАдминистратор и ГруппаДоступаАдминистраторы общего модуля УправлениеДоступом.ПриЗаполненииОграниченияДоступа модулей менеджеров объектов метаданных для некоторых редких случаев, когда список элементов зависит от прав на некоторый технологический объект, теперь можно использовать функции ПравоДоступа и РольДоступна. Подробнее см. в документации.Отслеживание состояний первичных документов только по определенным печатным формам документа. Данная возможность может быть полезна, если документ имеет множество печатных форм, но только в одной требуется подпись сотрудника и только по ней следует отслеживать состояние. Для этого в программном интерфейсе общего модуля УчетОригиналовПервичныхДокументовПереопределяемый добавлена процедура переопределения списка отслеживаемых печатных форм документа;
ЗаполнитьТаблицуУчетаОригиналов.Отслеживание состояний печатных форм по сотрудникам в документах, где требуется подпись нескольких сотрудников. Для этого в программном интерфейсе:
УчетОригиналовПервичныхДокументовПереопределяемый добавлена процедура переопределения списка “многосотрудниковых” документовПриОпределенииМногосотрудниковыхДокументов;СостоянияОригиналовПервичныхДокументов, у процедуры ЗаписатьСостояниеОригиналаДокументаПоПечатнымФормам добавлен параметр Сотрудник.В случаях, когда требуется отслеживание статуса записи изменившегося состояния оригинала в программном интерфейсе общего модуля УчетОригиналовПервичныхДокументовКлиент, УчетОригиналовПервичныхДокументовВызовСервера и модуле менеджера регистра сведений СостоянияОригиналовПервичныхДокументов у процедур ЗаписатьСостоянияОригиналовПослеПечати и ЗаписатьСостоянияОригиналовДокументаПослеПечатиФормы предусмотрен параметр признака записи Записано.
Подробности см. в документации.
ШаблоныСообщений у функции СформироватьСообщениеИОтправить в возвращаемом значении предусмотрено свойство СсылкаНаПисьмо.ШаблоныСообщений предусмотрена функция-конструктор ПараметрыОтправкиПисьмаПоШаблону. Подробнее см. в комментарии к ней.Подписать и ПроверитьПодпись общих модулей ЭлектроннаяПодписьКлиент и ЭлектроннаяПодпись предусмотрено автоматическое определение параметров XMLDSig из передаваемого конверта XML. Для этого нужно оставить незаполненными свойства XPathSignedInfo и XPathПодписываемыйТег структуры, возвращаемой функцией ПараметрыXMLDSig общего модуля ЭлектроннаяПодписьКлиент и ЭлектроннаяПодпись.КонвертXML в общие модули ЭлектроннаяПодписьКлиент и ЭлектроннаяПодпись. В описании функции указан подробный состав возможностей, предусмотренных для XML документа, которые следует учитывать при использовании различных форматов документа XML.В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).
Для обновления следующих переопределяемых общих модулей требуется перенести из поставки библиотеки новые экспортные процедуры, удалить отсутствующие и убедиться, что комментарии, количество и имена параметров у процедур совпадают с поставкой библиотеки:
БизнесПроцессыИЗадачиКлиентПереопределяемый,ДополнительныеОтчетыИОбработкиПереопределяемый,ЗаполнениеОбъектовПереопределяемый,ОбновлениеИнформационнойБазыПереопределяемый,ОтчетыПереопределяемый,ПодключаемыеКомандыПереопределяемый,ПолнотекстовыйПоискСерверПереопределяемый,РаботаСПочтовымиСообщениямиПереопределяемый,РаботаСФайламиПереопределяемый,СозданиеНаОснованииПереопределяемый,СтруктураПодчиненностиПереопределяемый,ТекущиеДелаПереопределяемый,УправлениеПечатьюПереопределяемый,УчетОригиналовПервичныхДокументовПереопределяемый.Рекомендации по задействованию новых возможностей переопределяемых общих модулей приведены выше в разделе Новые возможности для разработчиков.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки. В исключительных (редких) случаях, когда такая совместимость не обеспечена, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки, в этом разделе приведены необходимые инструкции. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
ДополнитьСвязиОбъектовМетаданных общего модуля ОтчетыПереопределяемый удалена, т.к. более не востребована.Взаимодействия внедрена без подсистемы УправлениеДоступом, следует удалить подписку ЗаполнитьНаборыЗначенийДоступаТабличныхЧастейДокументовВзаимодействия, так как она переименована в ЗаполнитьНаборыЗначенийДоступаТабличныхЧастейДокументов, исключена из подсистемы Взаимодействия и включена в подсистему УправлениеДоступом.КоличествоНерассмотренныхПроблем и СтруктураЗаголовкаГиперссылкиМонитораПроблем общего модуля ОбменДаннымиСервер отмечены как устаревшие, т.к. более не востребованы.ЗагрузитьРасширенияИзменяющиеСтруктуруДанных запрещено включать в планы обмена распределенной информационной базы (РИБ) и автономного рабочего места (АРМ).РежимОчисткиФайлов, ПутьКТомуБезУчетаРегиональныхНастроек не следует включать в состав планов обмена РИБ и автономного рабочего места (АРМ).ИспользуемыеВидыДоступа, ИспользуемыеВидыДоступаПоТаблицам. В обработчики регистрации изменений планов обмена РИБ включить только регистр сведений ИспользуемыеВидыДоступа.ЗаполнитьНаборыЗначенийДоступаТабличныхЧастей<Окончание>, а их типы перенести в новый определяемый тип ВладелецСОграничениемПоНаборамЗначенийДоступаДокумент. Если документов нет, то в новом определяемом типе нужно указать тип СправочникОбъект.ИдентификаторыОбъектовМетаданных.ЗаписатьНаборыЗначенийДоступа<Окончание>, а их типы перенести в определяемый тип ВладелецНаборовЗначенийДоступаОбъект.ЗаписатьЗависимыеНаборыЗначенийДоступа<Окончание>, а их типы перенести в определяемый тип ВладелецВнешнихЗначенийВНаборахЗначенийДоступаОбъект.КлючиДоступаКРегистру, переименовать измерение ДляВнешнихПользователей в ВариантДоступа и установить все его свойства (включая тип), как у измерения ВариантДоступа регистра сведений КлючиДоступаКРегистрам. При повторном обновлении библиотек с версией БСП ниже 3.1.5, которые поставляют регистры сведений КлючиДоступаКРегистру*, операцию нужно повторить или не переносить свойства измерения ВариантДоступа.ДляОбъекта, ДляРегистра и ограничения доступа с этими шаблонами (реализованы улучшения). Кроме того, обновить стандартные шаблоны ПоЗначениям, ПоЗначениямРасширенный, ПоЗначениямИНаборамРасширенный, ПоНаборамЗначений (имена ресурсов прав служебных регистров были дополнены словом Право для корректности перевода). Для обновления шаблонов рекомендуется использовать отчет ПроверкаВнедренияБСП.erf в режиме исправления ошибок.Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
СтруктураКонтактнойИнформацииПоТипу общего модуля РаботаСАдресамиКлиентСервер устарела. Вместо нее для получения полей адреса следует использовать функцию ПоляАдреса общего модуля РаботаСАдресамиКлиентСервер, а для получения полей телефона функцию СведенияОТелефоне общего модуля УправлениеКонтактнойИнформацией.ВидКонтактнойИнформации функции ПредставлениеКонтактнойИнформации общего модуля УправлениеКонтактнойИнформацией устарел и игнорируется. Следует удалить его во всех местах вызова функции.Включать расширения конфигурации. Например, см. план обмена _ДемоОбменВРаспределеннойИнформационнойБазе в демонстрационной конфигурации.Включать расширения конфигурации должно быть снято. Например, см. план обмена _ДемоАвтономнаяРабота в демонстрационной конфигурации.ИНН, АдресРегистрации и Телефон в параметре Параметры процедуры ПриЗаполненииРеквизитовВладельцаВЗаявленииНаСертификат. См. пример в демонстрационной конфигурации в общем модуле _ДемоСтандартныеПодсистемы.ДобавитьСертификат общего модуля ЭлектроннаяПодписьКлиент с целью создания нового заявления на сертификат для организации, требуется обеспечить управление видимостью этой команды с помощью функции ДоступностьСозданияЗаявления общего модуля ЭлектроннаяПодпись. Кроме того, следует реализовать команду добавления заявления для физического лица (также с управлением видимостью, для поддержки срока начала доступности заявления для физических лиц с 01.04.2021). См. пример в демонстрационной конфигурации в формах списков справочников _ДемоОрганизации и _ДемоФизическиеЛица.Подписать и ПроверитьПодпись общих модулей ЭлектроннаяПодписьКлиент и ЭлектроннаяПодпись рекомендуется перейти на автоматическое определение параметров XMLDSig из передаваемого конверта XML. Для этого нужно оставить незаполненными свойства XPathSignedInfo и XPathПодписываемыйТег структуры, возвращаемой функцией ПараметрыXMLDSig общего модуля ЭлектроннаяПодписьКлиент и ЭлектроннаяПодпись.При обновлении с ранних версий библиотеки (до 3.1.4) следует:
Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.5.1, 3.1.5.20, 3.1.5.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
Enterprise Data реализованы следующие возможности:
Договоры расширено полем ИдентификаторГосКонтракта, что позволяет синхронизировать информацию о государственных контрактах между приложениями;КодТРУ, дополнительно формат расширен новым перечислением ТипыПлатежнойСистемыККТ;КБК и ПотенциальноВозможныйГодовойДоход стали необязательными. Это расширяет возможность конвертации справочника из программ, где патенты учитываются в урезанном виде;Enterprise Data до версии 1.10.6, в который добавлен документ УдержанныйНДФЛ для отражения сведений о Едином Налоговом Платеже (ЕНП).Добавлена возможность перехода на другую программу в модели сервиса, например Базовая -> Проф или Проф -> Корп. Для задействования данной возможности необходимо проанализировать обработчики перехода, указанные в процедуре ПриДобавленииОбработчиковПереходаСДругойПрограммы - если обрабатываются неразделенные данные, требуется установить новое свойство ОбщиеДанные в значение Истина.
Например:
Обработчик = Обработчики.Добавить();
Обработчик.ПредыдущееИмяКонфигурации = "*";
Обработчик.ОбщиеДанные = Истина;
Обработчик.Процедура = "<ИмяМодуля>.<ИмяПроцедурыОбработчикаНеразделенныхДанных>";Для конфигураций, имеющих в составе Библиотеку интернет-поддержки пользователей, в процедуре ПриОпределенииИспользуемыхВерсийВнешнихКомпонент общего модуля ПолучениеВнешнихКомпонентВМоделиСервисаПереопределяемый вставить строки:
Идентификаторы.Добавить("ExtraCryptoAPI");
Идентификаторы.Добавить("XMLDSignAddIn");Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, улучшена проверка внедрения Нерекомендуемый состав ролей подсистемы Базовая функциональность. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.ПутьКТомуБезУчетаРегиональныхНастроек. Константу не следует включать в состав планов обмена РИБ и автономного рабочего места (АРМ).РежимОчисткиФайлов. Константу не следует включать в состав планов обмена РИБ и автономного рабочего места (АРМ).Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, улучшена проверка внедрения справочников хранения присоединенных файлов подсистемы Работа с файлами. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, улучшена проверка внедрения Нерекомендуемый состав ролей подсистемы Базовая функциональность. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.ПриФормированиеСпискаРазрабатываемыхПодсистем общего модуля ОбновлениеИнформационнойБазыПереопределяемый устарела, вместо нее следует использовать процедуру ПриФормированииСпискаРазрабатываемыхПодсистем этого же модуля.Версия 3.1.4 предназначена для разработки на платформе 1С:Предприятие в режиме совместимости с версиями 8.3.14, 8.3.15 или 8.3.16, т.е.:
Режим совместимости установлено значение Не использовать;Режим совместимости установлено значение Версия 8.3.14 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15 или Версия 8.3.16.Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.4.
В эту версию включена новая подсистема Перевод текста (в группе подсистем Мультиязычность), предоставляющая программный интерфейс для автоматического перевода произвольного текст с одного языка на другой. Перевод выполняется при помощи сервисов онлайн-перевода Яндекс Переводчик и Google Translate, входящих, соответственно, в состав сервисов Yandex Cloud и Google Cloud.
Из подсистемы Базовая функциональность выделена подсистема Мультиязычность. В неё вошли все метаданные, предоставляющие возможность вывода представлений данных на нескольких языках. Подсистема Мультиязычность, в свою очередь, также разделена на подсистемы, поддерживающие мультиязычность, соответствующие основному списку подсистем: Базовая функциональность и Печать.
Новая подсистема Генерация штрихкода предоставляет программный интерфейс для генерирования изображений штрихкодов EAN8, EAN13, EAN128, Code39, Code93, Code128, Code16k, PDF417, ITF14, RSS14, EAN13AddOn2, EAN13AddOn5, QR, GS1DataBarExpandedStacked, Datamatrix.
Для упрощения вызова процедуры ВыполнитьВФоне общего модуля ДлительныеОперации в функции-конструкторе ПараметрыВыполненияВФоне параметр ИдентификаторФормы сделан необязательным. Это удобно в тех случаях, когда результат выполнения процедуры нужно размещать не в автоматически создаваемом временном хранилище на время жизни формы, а в собственном временном хранилище; или когда формы-владельца не существует, например, при вызове длительной операции из общей команды, размещенной в глобальном интерфейсе.
В общих модулях ФайловаяСистема и ФайловаяСистемаКлиент появилась функция УникальноеИмяФайла, с помощью которой можно сформировать уникальное имя файла в указанной папке. Если файл с таким именем уже существует, то к имени файла добавляется уникальный порядковый номер, например: “файл (2).txt”, “файл (3).txt” и т.п.
В редких случаях возникает необходимость определять сразу несколько минимальных или рекомендуемых версий платформы 1С:Предприятие. Например, если функции, необходимые для работы конфигурации, были включены в исправительные релизы платформы. Для этого добавлена возможность указывать сразу несколько сборок платформы в параметрах МинимальнаяВерсияПлатформы и РекомендуемаяВерсияПлатформы коллекции ОбщиеПараметры процедуры ПриОпределенииОбщихПараметровБазовойФункциональности общего модуля ОбщегоНазначенияПереопределяемый. При этом пользователю будет предлагаться для обновления тот номер сборки, который соответствует текущей версии платформы (первым трем цифрам). Например, если указать "8.3.14.1694; 8.3.15.2107; 8.3.16.1791", то при запуске на предыдущих релизах 8.3.14 будет предложено перейти на 8.3.14.1694, при работе на 8.3.15 - 8.3.15.2107, и 8.3.16 - 8.3.16.1791, соответственно.
В редких случаях в конфигурации бывает необходимо опционально задействовать новые возможности платформы 1С:Предприятие, не увеличивая минимальную версию платформы, требуемую для запуска. При помощи функции ВерсияРежимаСовместимости общего модуля СтандартныеПодсистемыСервер можно также проверить требуемый режим совместимости платформы 1С:Предприятие в тех случаях, когда конфигурация рассчитана на работу в нескольких режимах совместимости. См. также документацию 1С:Предприятие 8.3.
При работе в мультиязычной конфигурации бывает необходимо получить представления данных на требуемом языке. Для этого программный интерфейс функций ЗначениеРеквизитаОбъекта, ЗначенияРеквизитаОбъекта, ЗначениеРеквизитаОбъектов и ЗначенияРеквизитовОбъектов модуля ОбщегоНазначения расширен параметром КодЯзыка.
Также при работе в мультиязычной конфигурации для определения представлений данных может понадобиться получить признак того, что язык интерфейса текущего пользователя соответствует языку конфигурации. Для этого в программный интерфейс общего модуля ОбщегоНазначения добавлена функция ЭтоОсновнойЯзык.
В функцию РасчетныеПоказателиЯчеек общего модуля ОбщегоНазначенияКлиентСервер добавлен необязательный параметр ПараметрыРасчета типа возвращаемого значения функции ПараметрыРасчетаПоказателейЯчеек общего модуля ОбщегоНазначенияКлиентСервер. В новом параметре свойство РассчитатьНаСервере позволяет разработчику явно указать, выполнять расчет на сервере или на клиенте, вместо автоопределения. #### Банки
Для получения сведений из Справочника БИК об участниках расчетов в программном интерфейсе общего модуля РаботаСБанками предусмотрена функция СведенияБИК. Подробнее см. в описании к ней.
Для интерактивного выбора участника расчетов из Справочника БИК по номеру БИК предусмотрена процедура ВыбратьИзСправочникаБИК в общем модуле РаботаСБанкамиКлиент. В процедуре определяется количество найденных записей по переданному БИК и в случае, если запись не единственная, либо таких записей нет, открывает форму выбора. В случае, если запись одна, выбор осуществляется автоматически.
Пользователь может вводить параметры прописи валюты на иностранных языках. Для получения суммы прописью на иностранном языке программный интерфейс функции СформироватьСуммуПрописью общего модуля РаботаСКурсамиВалют расширен параметром КодЯзыка.
Пример использования:
ДанныеПечати.Вставить("СуммаПрописью",
РаботаСКурсамиВалют.СформироватьСуммуПрописью(ДанныеПечати.ИтоговаяСумма, Шапка.ВалютаДокумента, , КодЯзыка));Расширены возможности настройки отчета из контекстного меню. Из контекстного меню заголовка таблицы можно вставлять в таблицу новое поле (колонку), выбрав из списка доступных полей. Для более быстрой вставки наиболее частотных (основных) полей можно отдельно перечислить их:
ПриОпределенииОсновныхПолей общего модуля ОтчетыПереопределяемый;ОпределитьНастройкиФормы включить событие ПриОпределенииОсновныхПолей и реализовать процедуру ПриОпределенииОсновныхПолей. См. пример реализации в демонстрационной конфигурации в отчете _ДемоФайлы.Например, количество доступных полей для вывода в отчет по номенклатуре может достигать нескольких десятков. Однако если предполагается, что в отчет чаще других выводят цены, то поле Цена можно включить в список основных полей, которые будут выводиться сразу в подменю вставки новой колонки:
Процедура ПриОпределенииОсновныхПолей(Форма, ОсновныеПоля) Экспорт
ОсновныеПоля.Добавить("Регистратор");
ОсновныеПоля.Добавить("Номенклатура");
ОсновныеПоля.Добавить("Количество");
ОсновныеПоля.Добавить("Цена");
ОсновныеПоля.Добавить("Сумма");
КонецПроцедурыЗапретРедактированияРеквизитовОбъектовПереопределяемый предусмотрена процедура ПриОпределенииЗаблокированныхРеквизитов.КонтактнаяИнформацияОбъекта программного интерфейса общего модуля УправлениеКонтактнойИнформацией второй параметр ВидИлиТипКонтактнойИнформации теперь поддерживает передачу значения с типом ПеречислениеСсылка.ТипыКонтактнойИнформации. Например, для получения всех адресов организации (юридического, фактического и др.), достаточно указать тип контактной информации Перечисления.ТипыКонтактнойИнформации.Адрес.УправлениеКонтактнойИнформацией расширен функциями КонтактнаяИнформация и ОтборКонтактнойИнформации. Подробности см. в описании к этим функциям. - Для заполнения муниципальных адресов в декларациях, регламентированных отчетах и др. документах в соответствии с приказом Минфина России от 5 ноября 2015 г. N 171н “Об утверждении Перечня элементов планировочной структуры, элементов улично-дорожной сети, элементов объектов адресации, типов зданий (сооружений), помещений, используемых в качестве реквизитов адреса, и Правил сокращенного наименования адресообразующих элементов” в общем модуле РаботаСАдресами предусмотрена функция программного интерфейса СведенияОбАдресеПриказМинфинаРФ171н, которая возвращает адрес в виде структуры. Это дает возможность получать типы полей адреса (региона, района, города и т.д.) согласно перечню сокращенных наименований видов субъектов Российской Федерации, муниципальных образований, населенных пунктов, элементов планировочной структуры, элементов улично-дорожной сети и идентификационных элементов объекта адресации. Функция доступна с версии 3.1.4.146 и выше. ОбновлениеИнформационнойБазыПереопределяемый добавлены процедуры заполнения:
ПриНастройкеНачальногоЗаполненияЭлементовПриНачальномЗаполненииЭлементовПриНачальномЗаполненииЭлементаПолноеИмяОбъекта передается имя объекта метаданных, предопределенные данные которого заполняются.ОтладкаОбработчика. В таком случае обработчик будет выполняться при каждом обновлении и для его отладки достаточно запустить программу с ключом ЗапуститьОбновлениеИнформационнойБазы. Так же это может быть удобно для случаев, когда точный номер версии для обработчика не известен до его помещения в основное хранилище.Если дополнительный параметр объекта ИспользоватьОтменуПроведенияДляОчисткиДвижений принимает значение Истина, то удаление движений объектов будет выполняться как при отмене проведения, то есть с учетом всех проверок программы. Иначе сохранено старое поведение, т.е. безусловное удаление движений. Параметр рекомендуется заполнять в событии ПередЗаписьюПолученныхДанных. #### Отправка SMS
Из списка доступных провайдеров SMS удален провайдер GSM-INFORM в связи с прекращением его деятельности.
Изменен адрес сервиса отправки SMS-провайдера Билайн. Если в программе настроены SMS-рассылки через Билайн, рекомендуется переключиться на новый адрес a2p-sms.beeline.ru. Для этого следует обратиться в службу поддержку Билайна и затем изменить настройку в программе, указав новый способ авторизации и введя полученные логин и пароль (раздел Администрирование - Органайзер - Настройка отправки SMS). В будущем доступ к услуге по прежнему адресу beeline.amega-inform.ru может быть прекращен (подробности можно уточнить в службе поддержки компании Билайн).
ОрганизацииСервер и ОрганизацииПереопределяемый расширен параметром КодЯзыка. Необходимо учесть это изменение во всех функциях модуля ОрганизацииПереопределяемый, где выполнялось переопределение. КонтактнаяИнформация и РаботаСПочтовымиСообщениями. Если подсистема РаботаСПочтовымиСообщениями была внедрена ранее, то в текущую конфигурацию требуется добавить новую константу УчетнаяЗаписьДляВосстановленияПароля выполнив сравнение/объединение с конфигурацией библиотеки из комплекта поставки. Константу рекомендуется включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места (АРМ).Пользователи добавлена новая функция АвторизоватьТекущегоПользователяПриВходе, которую следует вызывать в начале процедур http-сервисов, веб-сервисов, com-соединений, если они используются для удаленного подключения обычных пользователей, чтобы обеспечить контроль ограничений на вход (по дате, по активности и т.д.).Печатные формы можно формировать на иностранном языке. Данная возможность может быть полезна, если необходимо предоставить какие-либо документы иностранному контрагенту, например: прайс-лист, счет на оплату и т. д. Для этого пользователь добавляет произвольный язык в справочник ЯзыкиПечатныхФорм, самостоятельно переводит пользовательский макет печатной формы на иностранный язык, а также вводит представления для выводимых на печать объектов.
Чтобы поддержать этот сценарий в печатной форме, необходимо выполнить ряд доработок печатных форм:
Подробности см. в документации.
Пример формирования печатной формы с поддержкой мультиязычности можно посмотреть в процедуре Печать документа _ДемоСчетНаОплатуПокупателю.
Язык, на котором требуется сформировать печатную форму, передается в параметре ПараметрыВывода.КодЯзыка процедуры Печать менеджера печати. Его необходимо использовать при получении макета и данных, выводимых в табличный документ.
По умолчанию в печатной форме для пользователя отключена возможность переключения языков. Для включения этой возможности параметр КоллекцияПечатныхФорм процедуры Печать расширен свойством ДоступенВыводНаДругихЯзыках, необходимо установить значение Истина. Например:
ПечатнаяФорма = УправлениеПечатью.СведенияОПечатнойФорме(КоллекцияПечатныхФорм, "Счет");
Если ПечатнаяФорма <> Неопределено Тогда
ПечатнаяФорма.ТабличныйДокумент = ПечатьСчетаЗаказа(МассивОбъектов, ОбъектыПечати, "Счет", ВыводитьПлатежныеРеквизиты, ПараметрыВывода.КодЯзыка);
ПечатнаяФорма.СинонимМакета = НСтр("ru = 'Счет на оплату'");
ПечатнаяФорма.ПолныйПутьКМакету = "Документ._ДемоСчетНаОплатуПокупателю.ПФ_MXL_СчетЗаказ";
ПечатнаяФорма.ДоступенВыводНаДругихЯзыках = Истина;
КонецЕсли;МакетПечатнойФормы общего модуля УправлениеПечатью расширена параметром КодЯзыка.ВыполнитьРассылкуОтчетов и ВыполнитьРассылку общего модуля РассылкаОтчетов предусмотрены функции-конструкторы их параметров ПараметрыЖурнала, ОтчетыДляРассылки и ПараметрыДоставки.УправлениеСвойствами расширен функциями ПредставлениеЗначенияСвойства и ПредставленияЗначенийСвойств.ЗначенияСвойств и ЗначениеСвойства общего модуля УправлениеСвойствами расширен параметром КодЯзыка.ЧтениеРазрешено и ИзменениеРазрешено общего модуля УправлениеДоступом теперь поддерживают необязательный параметр Пользователь, позволяющий проверить право доступа на уровне записей для произвольного пользователя. Параметр доступен только в производительном режиме, который можно определить с помощью новой функции ПроизводительныйВариант общего модуля УправлениеДоступом.ДополнительныеСведенияОрганизации общего модуля ОрганизацииСервер и параметра ДополнительныеСведения процедуры ПриОпределенииДополнительныхСведенийОрганизации общего модуля ОрганизацииПереопределяемый: в новом свойстве ЭмблемаОрганизацииДляШтампаЭлектроннойПодписи необходимо возвращать картинку с эмблемой. Пример реализации см. в демонстрационной конфигурации в процедуре ОрганизацииПереопределяемый.ПриОпределенииДополнительныхСведенийОрганизации и справочнике _ДемоОрганизации.ПараметрыXMLDSig общих модулей ЭлектроннаяПодписьКлиент и ЭлектроннаяПодпись теперь возвращает значения по умолчанию, подходящие для большинства случаев. Кроме того, не требуется заполнять алгоритмы для создания подписи при использовании сертификатов с алгоритмами открытого ключа ГОСТ 94, ГОСТ 2001, ГОСТ 2012/256 и ГОСТ 2012/512.В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).
Для обновления следующих переопределяемых общих модулей требуется перенести из поставки библиотеки новые экспортные процедуры, удалить отсутствующие и убедиться, что комментарии, количество и имена параметров у процедур совпадают с поставкой библиотеки:
ЗапретРедактированияРеквизитовОбъектовПереопределяемый;ОбновлениеИнформационнойБазыПереопределяемый;ОбщегоНазначенияПереопределяемый; - ОрганизацииПереопределяемый; ОтчетыПереопределяемый;УправлениеПечатьюПереопределяемый.Рекомендации по задействованию новых возможностей переопределяемых общих модулей приведены выше в разделе Новые возможности для разработчиков.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки. В исключительных (редких) случаях, когда такая совместимость не обеспечена, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки, в этом разделе приведены необходимые инструкции. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
БизнесПроцессОбъект объекты бизнес-процессов, подключенных к подсистеме. Состав объектов должен совпадать с составом ссылок в определяемом типе БизнесПроцесс.Во всех ролях обновить стандартные шаблоны ДляОбъекта, ДляРегистра и ограничения доступа по шаблону ДляОбъекта. Рекомендуется использовать отчет ПроверкаВнедренияБСП.erf в режиме исправления ошибок. ##### Электронная подпись
Для поддержки удобного заполнения заявления для физического лица, которое будет доступно пользователям с 01.04.2021, рекомендуется реализовать заполнение новых свойств ИНН, АдресРегистрации и Телефон в параметре Параметры процедуры ПриЗаполненииРеквизитовВладельцаВЗаявленииНаСертификат. Смотри пример в демонстрационной конфигурации в общем модуле _ДемоСтандартныеПодсистемы.
Для поддержки срока прекращения доступности заявления для организаций с 01.12.2021, при использовании процедуры ДобавитьСертификат общего модуля ЭлектроннаяПодписьКлиент с целью создания нового заявления на сертификат для организации, требуется обеспечить управление видимостью этой команды с помощью функции ДоступностьСозданияЗаявления общего модуля ЭлектроннаяПодпись. Кроме того, следует реализовать команду добавления заявления для физического лица (также с управлением видимостью, для поддержки срока начала доступности заявления для физических лиц с 01.04.2021). Смотри пример в демонстрационной конфигурации в формах списков справочников _ДемоОрганизации и _ДемоФизическиеЛица.
Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
ОбновитьРазделыДатЗапретаИзменения общего модуля ДатыЗапретаИзменения перенесена в область УстаревшиеПроцедурыИФункции. Обновление выполняется автоматически, поэтому вызовы процедуры следует удалить.ЯзыкиПечатныхФорм следует включить в состав планов обмена РИБ и автономного рабочего места (АРМ).УчетнаяЗаписьДляВосстановленияПароля следует включить в состав планов обмена РИБ и автономного рабочего места (АРМ).РежимОчисткиФайлов не следует включить в состав планов обмена РИБ и автономного рабочего места (АРМ).ПараметрыXMLDSig общих модулей ЭлектроннаяПодписьКлиент и ЭлектроннаяПодпись рекомендуется перейти к использованию значений, возвращаемых по умолчанию.При обновлении с ранних версий библиотеки (до 3.1.3) следует:
Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.4.1, 3.1.4.20, 3.1.4.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf. #### С версии 3.1.4.407 и меньше
Для конфигураций, имеющих в составе Библиотеку интернет-поддержки пользователей, в процедуре ПриОпределенииИспользуемыхВерсийВнешнихКомпонент общего модуля ПолучениеВнешнихКомпонентВМоделиСервисаПереопределяемый вставить строки:
Идентификаторы.Добавить("ExtraCryptoAPI");
Идентификаторы.Добавить("XMLDSignAddIn");Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, улучшена проверка внедрения подсистем Контактная информация и Свойства. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета. #### С версии 3.1.4.186 и меньшеИНН, АдресРегистрации и Телефон в параметре Параметры процедуры ПриЗаполненииРеквизитовВладельцаВЗаявленииНаСертификат. Смотри пример в демонстрационной конфигурации в общем модуле _ДемоСтандартныеПодсистемы.ДобавитьСертификат общего модуля ЭлектроннаяПодписьКлиент с целью создания нового заявления на сертификат для организации, требуется обеспечить управление видимостью этой команды с помощью функции ДоступностьСозданияЗаявления общего модуля ЭлектроннаяПодпись. Кроме того, следует реализовать команду добавления заявления для физического лица (также с управлением видимостью, для поддержки срока начала доступности заявления для физических лиц с 01.04.2021). Смотри пример в демонстрационной конфигурации в формах списков справочников _ДемоОрганизации и _ДемоФизическиеЛица. Версия 3.1.3 предназначена для разработки на платформе 1С:Предприятие в режиме совместимости с версиями 8.3.14, 8.3.15 или 8.3.16, т.е.:
Режим совместимости установлено значение Не использовать;Режим совместимости установлено значение Версия 8.3.14 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15 или Версия 8.3.16.Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.3.
В эту версию включена новая подсистема Учет оригиналов первичных документов. С ее помощью можно упростить учет и контроль наличия подписанных оригиналов входящих и исходящих первичных документов, например, в сценарии: документ распечатали, передали клиенту, ждем возвращения подписанного оригинала. Ключевые возможности:
Кроме того, следующие подсистемы получили существенное развитие и ряд новых функций:
Для длительного хранения электронных документов в соответствии с требованиями законодательства добавлена возможность сохранения печатных форм документов и отчетов в формате PDF/A. Эта возможность доступна при использовании платформы 8.3.16 и выше. #### Банки
В связи с вступлением в силу с 01.01.2021 положений Федерального закона от 27.12.2019 №479-ФЗ «О внесении изменений в Бюджетный кодекс Российской Федерации в части казначейского обслуживания и системы казначейских платежей» изменяются реквизиты для уплаты налогов, страховых взносов, сборов и других обязательных платежей во всех регионах. Для обеспечения возможности осуществления платежей в Казначейство по новым реквизитам в Классификаторе банков сделаны следующие изменения:
В конфигурациях, поддерживающих несколько языков интерфейса, параметры шаблонов выводятся на текущем языке пользователя. Это позволяет редактировать шаблоны сообщений пользователям, работающих в программе на разных языках. #### Электронная подпись
В связи с вступлением в силу с 01.01.2022 федерального закона от 27.12.2019 № 476-ФЗ “О внесении изменений в Федеральный закон «Об электронной подписи»”, удостоверяющий центр ООО «Научно-производственный центр “1С”» переходит к выпуску квалифицированных сертификатов только для физических лиц, включая сертификаты для сотрудников. С 01.04.2021 появится возможность оформить заявление на сертификат для физического лица так же просто, как для организаций. Для этого достаточно нажать Добавить - Заявление на выпуск сертификата в списке Настройки электронной подписи и шифрование (Мои настройки или Администрирование - Общие настройки - Электронная подпись и шифрование) и вместо варианта Организация выбрать Физическое лицо.
АдресныйКлассификатор предусмотрена функция СведенияПоОКМТО. Подробнее см. в описании к ней.Для получения сведений из Справочника БИК об участниках расчетов в программном интерфейсе общего модуля РаботаСБанками предусмотрена функция СведенияБИК. Подробнее см. в описании к ней.
Для интерактивного выбора участника расчетов из Справочника БИК по номеру БИК предусмотрена процедура ВыбратьИзСправочникаБИК в общем модуле РаботаСБанкамиКлиент. В процедуре определяется количество найденных записей по переданному БИК и в случае, если запись не единственная, либо таких записей нет, открывает форму выбора. В случае, если запись одна, выбор осуществляется автоматически.
В программный интерфейс общего модуля ВариантыОтчетов добавлена функция ИспользуемыеТаблицыОтчета, которая расширяет функцию ИспользуемыеТаблицы. Достаточно передать только метаданные отчета, а функция самостоятельно:
ИспользуемыеТаблицы;ПриОпределенииИспользуемыхТаблиц.Взаимодействия добавлен метод ЗаполнитьНаборыЗначенийДоступаПоУмолчанию. С его помощью в процедуре ПриЗаполненииНаборовЗначенийДоступа общего модуля ВзаимодействияПереопределяемый можно объединять прикладной набор значений доступа к документам подсистемы со стандартным заполнением по умолчанию.Взаимодействия добавлен метод ПредметВзаимодействия. Позволяет получить сведения о предмете взаимодействия, чтобы, например, добавить предмет в набор значений доступа взаимодействия.АдминистрированиеКластера по управлению сеансами и соединениями предусмотрены функции-конструкторы ФильтрСеансов и ФильтрСоединений.Проверка внедрения БСП:
РасчетныеПоказателиЯчеек общего модуля ОбщегоНазначенияКлиентСервер.ПредставлениеПериода, добавлена функция ПредставлениеПериодаВТексте общего модуля СтроковыеФункции. Теперь, представление формируется более корректно – в нижнем регистре или с заглавной буквы, если, например, с периода начинается предложение.МультиязычностьСервер в процедуре ПриСозданииНаСервере добавлен третий необязательный параметр ИмяСписка для переопределения имени динамического списка на форме. Это может быть полезно при наличии нескольких динамических списков на форме.ОбщегоНазначения:
ЗначениеРеквизитаОбъекта, ЗначенияРеквизитовОбъекта, ЗначенияРеквизитовОбъектов, ЗначениеРеквизитаОбъектов предусмотрен необязательный параметр КодЯзыка, позволяющий возвращать значение на требуемом языке для мультиязычных реквизитов.УстановитьЗначениеРеквизита, УстановитьЗначенияРеквизитов для сохранения значений на указанном языке для мультиязычных реквизитов.МестаИспользования модуля ОбщегоНазначения добавлен необязательный параметр ДополнительныеПараметры, позволяющий изменять настройки исключения поиска ссылок непосредственно при вызове функции МестаИспользования. Это может быть полезно при проверке ссылочной целостности с учетом прикладной специфики.ПриОпределенииОбъектовСКомандойГрупповогоИзмененияОбъектов общего модуля ГрупповоеИзменениеОбъектовПереопределяемый можно подключить команды ИзменитьВыделенные к произвольным спискам и журналам._ДемоНоменклатура.КурсВалюты.ОбменДанными.Загрузка не установлен, и при записи объекта также записываются другие связанные с ним данные, то для отключения проверки запрета изменения в общем модуле ДатыЗапретаИзменения можно вызвать процедуру ОтключитьПроверкуДатЗапрета. Также предусмотрена функция ПроверкаДатЗапретаОтключена в этом же общем модуле.НайденЗапретИзмененияДанных общего модуля ДатыЗапретаИзменения предусмотрена функция-конструктор ее параметра ПараметрыСообщенияОЗапрете.ПериодыНерабочихДней общего модуля КалендарныеГрафики.ДатыБлижайшихРабочихДней устарел, вместо него рекомендуется использовать: метод БлижайшиеРабочиеДаты для производственного календаря и метод БлижайшиеДатыВключенныеВГрафик общего модуля ГрафикиРаботы для графика работы соответственно.БлижайшиеРабочиеДаты реализован параметр УчитыватьНерабочиеПериоды, позволяющий по-разному интерпретировать периоды нерабочих дней в календарях РФ в 2020 году. Параметр НерабочиеПериоды в свою очередь позволяет уточнить, какие конкретно периоды нужно учитывать.РаботаСАдресами расширен функция ПроверитьАдреса. Подробнее см. в описании к ней.В обработчике обновления для вида контактной информации установить параметр ИсправлятьУстаревшиеАдреса в значение Истина
ПараметрыВида = УправлениеКонтактнойИнформацией.ПараметрыВидаКонтактнойИнформации("Адрес");
ПараметрыВида.ИсправлятьУстаревшиеАдреса = Истина;
УправлениеКонтактнойИнформацией.УстановитьСвойстваВидаКонтактнойИнформации(ПараметрыВида);Рекомендуется активизировать этот параметр для адресов, требующих актуального состояния (например, адреса доставки) и не включать для юридически значимых адресов (например, адрес ЕГРЮЛ, место регистрации, рождения и др., т.к. они могут фигурировать в юридических документах).
УправлениеКонтактнойИнформацией расширен функцией ВидыКонтактнойИнформацииОбъекта. Список может быть отфильтрован по типу контактной информации.УправлениеКонтактнойИнформацией, предусмотрена функция СодержитКонтактнуюИнформацию.УправлениеКонтактнойИнформацией предусмотрены функции программного интерфейса:
ОбъектыТребующиеОбновленияКонтактнойИнформации возвращает список объектов, требующих обновления;ОбновитьКонтактнуюИнформациюОбъекта конвертирует ранее сохраненную контактную информации в формат JSON;ДемоКонтактныеЛицаПартнеров демонстрационной конфигурации. - С версии 3.1.3.415 для заполнения муниципальных адресов в декларациях, регламентированных отчетах и др. документах в соответствии с приказом Минфина России от 5 ноября 2015 г. N 171н “Об утверждении Перечня элементов планировочной структуры, элементов улично-дорожной сети, элементов объектов адресации, типов зданий (сооружений), помещений, используемых в качестве реквизитов адреса, и Правил сокращенного наименования адресообразующих элементов” в общем модуле РаботаСАдресами предусмотрена функция программного интерфейса СведенияОбАдресеПриказМинфинаРФ171н, которая возвращает адрес в виде структуры. Это дает возможность получать типы полей адреса (региона, района, города и т.д.) согласно перечню сокращенных наименований видов субъектов Российской Федерации, муниципальных образований, населенных пунктов, элементов планировочной структуры, элементов улично-дорожной сети и идентификационных элементов объекта адресации. РасширенияФорматаОбмена. Подробнее см. описание свойства в ОбменДаннымиСервер.НастройкиПланаОбменаПоУмолчанию.РасширениеФормата. Подробнее см. описание свойства в ОбменДаннымиСервер.ОписаниеВариантаНастройкиОбменаПоУмолчанию.ОбновлениеИнформационнойБазы расширен новыми функциями ПрогрессОбновленияОбластейДанных, ОбработчикиОбновления и ОбновляемыеОбъекты. Подробнее см. в комментариях к ним.ОбновлениеИнформационнойБазыПереопределяемый расширен процедурой ПриВыполненииПроверкиОбъектОбработан.ОчередьОтложеннойОбработки.ПриоритетыВыполнения для корректного расчета очереди (ранее требовалось заполнять свойство у каждого зависимого обработчика).Описание обработчиков обновления (меню Все функции).
ПриФормированиеСпискаРазрабатываемыхПодсистем общего модуля ОбновлениеИнформационнойБазыПереопределяемый.ПередФормированиеСпискаОтложенныхОбработчиков общего модуля ОбновлениеИнформационнойБазыПереопределяемый.ОбновлениеИнформационнойБазы расширен процедурами ЗарегистрироватьПредопределенныеЭлементыДляОбновленияОбновлениеИнформационнойБазы и ЗаполнитьЭлементыНачальнымиДанными. Подробнее см. комментарии к этим процедурам.ОтладкаОбработчика. В таком случае обработчик будет выполняться при каждом обновлении и для его отладки достаточно запустить программу с ключом ЗапуститьОбновлениеИнформационнойБазы. Так же это может быть удобно для случаев, когда точный номер версии для обработчика не известен до его помещения в основное хранилище.ОтправитьСообщение и ОтпавитьУведомление общего модуля Обсуждения:Сообщение = Обсуждения.ОписаниеСообщения("Привет, мир!");
Получатель = ОбщегоНазначенияКлиентСервер.ЗначениеВМассиве(Администратор);
Обсуждения.ОтправитьСообщение(Пользователи.ТекущийПользователь(), Получатель, Сообщение);Обсуждения.ПередЗаписью взводится Отказ и через обработчик ожидания выполняются дополнительные действия, предусмотрена процедура ПослеЗаписи общего модуля ПодключаемыеКомандыКлиент. Ее необходимо вызывать из обработчика события ПослеЗаписи для продолжения выполнения подключаемой команды. См. пример в форме ФормаЭлемента справочника УчетныеЗаписиЭлектроннойПочты.ПараметрыВыполненияКоманды в общих модулях ПодключаемыеКоманды и ПодключаемыеКомандыКлиент.ЗначениеПометки указать реквизит формы, в котором хранится состояние флажка (значение типа Булево). Подробнее см. описание процедуры ПриОпределенииКомандПодключенныхКОбъекту в общем модуле ПодключаемыеКомандыПереопределяемый.ПриДобавленииИсключенийПоискаСсылок в общем модуле ОбщегоНазначенияПереопределяемый), теперь предусмотрена переопределяемая процедура ПослеЗаменыСсылок общего модуля ОбщегоНазначенияПереопределяемый. Например, если в результате замены дублей появляются логически одинаковые записи регистра сведений, то можно исключить регистр из автозамены дублей и обработать записи самостоятельно после замены. Пример см. в демонстрационной конфигурации в процедуре ПослеЗаменыСсылок общего модуля ОбщегоНазначенияПереопределяемый.ПриОпределенииСвязейПодчиненныхОбъектов модуля ОбщегоНазначенияПереопределяемый и поля связи с основными объектами;_ДемоБанковскиеСчета.ПриОпределенииОбъектовСКомандамиОбъединенияДублейЗаменыСсылок модуля ПоискИУдалениеДублейПереопределяемый можно подключить команды Объединить выделенные и Заменить выделенные к произвольным спискам и журналам. Пример см. в демонстрационной конфигурации в форме списка справочника _ДемоНоменклатура.ПараметрыЗамены.ЗаменаПарыВТранзакции функции ЗаменитьСсылки общего модуля ОбщегоНазначения устарел и игнорируется. Теперь для замены ссылок не открывается одной общей транзакции, а открываются отдельные транзакции на каждый объект, связанные с ним движения и последовательности.ДиагностикаСоединения общего модуля ПолучениеФайловИзИнтернета предусмотрен параметр ЗаписыватьОшибку (по умолчанию Истина), с помощью которого можно отключать автоматическую запись диагностической информации в журнал регистрации, когда это не требуется. Например, это полезно в тех случаях, когда протоколирование выполняется другими средствами.ПриОпределенииФормыВыбораПользователей общего модуля ПользователиПереопределяемый.ПриПодготовкеПараметровФормированияОтчета общего модуля РассылкаОтчетовПереопределяемый.Связанные документы предусмотрена процедура ПередВыводомСвязанногоОбъекта общего модуля СтруктураПодчиненностиПереопределяемый. Например, она может быть полезна, если необходимо отказаться от вывода элементов в определенных случаях согласно прикладной логике.ПриОпределенииСвязейПодчиненныхОбъектов общего модуля ОбщегоНазначенияПереопределяемыйУдалениеПомеченныхОбъектов:
УдалитьПомеченныеОбъекты.ПомеченныеНаУдаление. Подробнее см. описание этих функций.НачатьУдалениеПомеченных и ПерейтиКУдалениюПомеченных общего модуля УдалениеПомеченныхОбъектовКлиент. Подробнее см. описание функций.УдалениеПомеченныхОбъектовСервер и УдалениеПомеченныхОбъектовКлиент.Анализ прав доступа администратор может наглядно получать сводную и подробную информацию об уровне доступа пользователей к отчетам и таблицам информационной базы.
Настройки программы отчет необходимо разместить в рабочем месте администратора.Подключаемые команды.Варианты отчетов, то отчет АнализПравДоступа следует удалить из метаданных конфигурации.ЦентрМониторингаВключен общего модуля ЦентрМониторинга.ШаблоныСообщений процедурой ЗаполнитьОбщиеРеквизиты и функцией ИмяУзлаОбщихРеквизитов. Подробнее см. комментарий к ним.ЭлектроннаяПодписьКлиент добавлена процедура ПоказатьРезультатПроверкиСертификата.ЭлектроннаяПодпись добавлена функция ОшибкаПоКлассификатору.В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения (см. главу 2 Инструкция по внедрению библиотеки).
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки. В исключительных (редких) случаях, когда такая совместимость не обеспечена, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки, в этом разделе приведены необходимые инструкции. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf. В этой версии состав проверок был дополнительно расширен, чтобы выявлять больше типовых проблем внедрения.
ПериодыНерабочихДнейКалендаря рекомендуется включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места (АРМ).ОбработчикиОбновления рекомендуется включать только в состав начального образа планов обмена распределенной информационной базы (РИБ) и автономного рабочего места (АРМ).ОбработчикиОбновленияОбщихДанных и ПотокиОбновления не следует включать в состав планов обмена РИБ и автономного рабочего места (АРМ).УдаляемыеОбъекты, НеудаленныеОбъекты и константу ПроверятьИспользованиеУдаляемыхОбъектов не следует включать в состав планов обмена РИБ и автономного рабочего места (АРМ).Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
Контекстные отчеты теперь возможно сохранять как новые варианты отчетов и включить в рассылки отчетов. Для того чтобы эти возможности вступили в силу, рекомендуется дополнительно пересмотреть места установки параметра формы отчета ВидимостьКомандВариантовОтчетов и отказаться от его использования. ##### Вызов онлайн-поддержки
В версию 2.4.2 Библиотеки интернет-поддержки включена новая редакция данной подсистемы. Рекомендуется перейти на нее, т.к. в будущем подсистема может быть удалена из поставки Библиотеки стандартных подсистем. Подробнее см. раздел Интеграция с 1С-Коннект в файле UpdateISL.htm, который входит в состав поставки Библиотеки интернет-поддержки 2.4.2.
ПриФормированииОчередейОтложенныхОбработчиков общего модуля ОбновлениеИнформационнойБазыПереопределяемый как невостребованная.ОбработкаПолученияФормыВыбораПользователейСистемыВзаимодействия вставить вызов подсистемы Обсуждения: Если ОбщегоНазначенияКлиент.ПодсистемаСуществует("СтандартныеПодсистемы.Обсуждения") Тогда
МодульОбсужденияСлужебныйКлиент = ОбщегоНазначенияКлиент.ОбщийМодуль("ОбсужденияСлужебныйКлиент");
МодульОбсужденияСлужебныйКлиент.ПриПолученииФормыВыбораПользователейСистемыВзаимодействия(НазначениеВыбора, Форма, ИдентификаторОбсуждения, Параметры, ВыбраннаяФорма, СтандартнаяОбработка);
КонецЕсли;ЗадатьОбластьПечатиДокумента общего модуля УправлениеПечатью добавлена проверка типа параметра Ссылка (допускаются только ссылочные типы). При передаче значения некорректного типа будет записана ошибка в журнале регистрации. Необходимо проверить все места использования этой процедуры.ДанныеQRКода общего модуля УправлениеПечатью следует использовать функции ДанныеQRКода или ИзображениеШтрихкода общего модуля ГенерацияШтрихкодаВызовСервера из библиотеки 1С:Библиотека подключаемого оборудования версии 2.1.4 (или больше). В частности, в них улучшена работа в ОС Linux. Прежняя функция отмечена как устаревшая для обратной совместимости.ИзменитьСправочникХраненияФайлов общего модуля РаботаСФайлами отмечена как устаревшая. Вместо нее рекомендуется вызывать функцию СконвертироватьФайлыВПрисоединенные этого же общего модуля.Если в конфигурацию встроена подсистема ПодключаемыеКоманды, рекомендуется очистить типы параметров общей команды СвязанныеДокументы, так как подсистема сама определит объекты, в подменю Отчеты которых будет выводиться команда Связанные документы. ##### Электронная подпись
Для поддержки удобного заполнения заявления для физического лица, которое будет доступно пользователям с 01.04.2021, рекомендуется реализовать заполнение новых свойств ИНН, АдресРегистрации и Телефон в параметре Параметры процедуры ПриЗаполненииРеквизитовВладельцаВЗаявленииНаСертификат. Смотри пример в демонстрационной конфигурации в общем модуле _ДемоСтандартныеПодсистемы.
Для поддержки срока прекращения доступности заявления для организаций с 01.12.2021, при использовании процедуры ДобавитьСертификат общего модуля ЭлектроннаяПодписьКлиент с целью создания нового заявления на сертификат для организации, требуется обеспечить управление видимостью этой команды с помощью функции ДоступностьСозданияЗаявления общего модуля ЭлектроннаяПодпись. Кроме того, следует реализовать команду добавления заявления для физического лица (также с управлением видимостью, для поддержки срока начала доступности заявления для физических лиц с 01.04.2021). Смотри пример в демонстрационной конфигурации в формах списков справочников _ДемоОрганизации и _ДемоФизическиеЛица.
При обновлении с ранних версий библиотеки (до 3.1.2) следует:
Переход с предыдущих версий для каждой пропущенной версии.Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.3.1, 3.1.3.20, 3.1.3.300 из т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf. #### С версии 3.1.3.453 и меньше
ИНН, АдресРегистрации и Телефон в параметре Параметры процедуры ПриЗаполненииРеквизитовВладельцаВЗаявленииНаСертификат. Смотри пример в демонстрационной конфигурации в общем модуле _ДемоСтандартныеПодсистемы.ДобавитьСертификат общего модуля ЭлектроннаяПодписьКлиент с целью создания нового заявления на сертификат для организации, требуется обеспечить управление видимостью этой команды с помощью функции ДоступностьСозданияЗаявления общего модуля ЭлектроннаяПодпись. Кроме того, следует реализовать команду добавления заявления для физического лица (также с управлением видимостью, для поддержки срока начала доступности заявления для физических лиц с 01.04.2021). Смотри пример в демонстрационной конфигурации в формах списков справочников _ДемоОрганизации и _ДемоФизическиеЛица. Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, улучшена проверка внедрения подсистемы Обновление версии ИБ. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, улучшена проверка внедрения подсистемы БазоваяФункциональность. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, обновлен макет с эталонными значениями прав для роли ПолныеПрава, а также улучшена диагностика внедрения подсистемы Заметки пользователя. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, обновлен макет с эталонным значением прав для роли ПолныеПрава для справочника ПоставляемыеДополнительныеОтчетыИОбработки. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.Версия 3.1.2 предназначена для разработки на платформе 1С:Предприятие в режиме совместимости с версиями 8.3.14, 8.3.15 или 8.3.16, т.е.:
Режим совместимости установлено значение Не использовать;Режим совместимости установлено значение Версия 8.3.14 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15 или Не использовать;Режим совместимости установлено значение Версия 8.3.14, Версия 8.3.15 или Версия 8.3.16.Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.2.
При подготовке нового письма по предмету (заказу покупателя и т. п.) без использования шаблона можно приложить к письму печатные формы этого предмета. #### Электронная подпись
В настройках электронной подписи и шифрования (раздел Администрирование – Общие настройки – Электронная подпись и шифрование) существенно упрощена отправка заявления на выпуск нового квалифицированного сертификата электронной подписи:
Улучшена диагностика проблем, возникающих при работе с электронной подписью:
Наименования справочника РолиИсполнителей на двух дополнительных языках необходимо:
Состав общих реквизитов НаименованиеЯзык1 и НаименованиеЯзык2 у справочника РолиИсполнителей в поле Использование установить значение Использовать.Базовая функциональность (см. раздел Мультиязычные данные).Администрирование.МультиязычностьСервер, МультиязычностьКлиент и МультиязычностьПереопределяемый.ОбщегоНазначенияКлиент добавлена процедура ПоказатьВыборФорматаВложений.ЗначенияРеквизитовОбъектов и ЗначенияРеквизитаОбъектов в общем модуле ОбщегоНазначения. Например, это удобно для выборки значений реквизитов из журнала документов.ВыбратьКаталог общего модуля ФайловаяСистемаКлиент можно указать начальное значение, которое будет показано при открытии диалога выбора. Для этого в функцию добавлен необязательный параметр Каталог.ДлительныеОперации предусмотрены функции ВыполнитьФункцию и ВыполнитьПроцедуру, а также вспомогательные функции ПараметрыВыполненияФункции и ПараметрыВыполненияПроцедуры. Описание параметров см. в комментарии к этим функциям.ПредставлениеОбъекта и ПредставлениеСписка в общем модуле ОбщегоНазначения. В зависимости от того, какие свойства объекта метаданных заполнены, функции возвращают одно из них в указанном порядке: Расширенное представление объекта/списка, Представление объекта/списка, Синоним или Имя.Показывать предупреждение об установленных обновлениях программы.
ПоказыватьПредупреждениеОбУстановленныхОбновленияхПрограммы общего модуля СтандартныеПодсистемыСервер (для чтения значения настройки) и СохранитьПерсональныеНастройки общего модуля ОбщегоНазначения (для сохранения значения).Администрирование – Печатные формы, отчеты и обработки – Настройка колонтитулов, а индивидуальные настройки колонтитулов для выбранного отчета устанавливаются в расширенном режиме настройки на закладке Оформление). Если же требуется выключить, то в процедуре ПриОпределенииНастроек общего модуля ВариантыОтчетовПереопределяемый необходимо:
Для выключения общей настройки вставить строку:
Настройки.ВыводитьОбщиеНастройкиКолонтитулов = Ложь;Для выключения индивидуальной настройки вставить строку:
Настройки.ВыводитьИндивидуальныеНастройкиКолонтитулов = Ложь;ПриОпределенииСвойствЭлементовФормыНастроек общего модуля ОтчетыСервер можно переопределить внешний вид элементов шапки отчета, связанных с пользовательскими настройками:
РастягиватьПоГоризонтали элемента;СвойстваГруппыЭлементовФормы общего модуля ОтчетыСервер. Например, чтобы разместить горизонтально поля параметров Период, Имя таблицы и скрыть их заголовки:Процедура ПриОпределенииСвойствЭлементовФормыНастроек(ТипФормы, СвойстваЭлементов, ПользовательскиеНастройки) Экспорт
СвойстваГруппы = ОтчетыСервер.СвойстваГруппыЭлементовФормы();
СвойстваГруппы.Группировка = ГруппировкаПодчиненныхЭлементовФормы.ГоризонтальнаяВсегда;
СвойстваЭлементов.Группы.Вставить("ОбщиеПараметры", СвойстваГруппы);
ОбщиеПараметры = Новый Структура("Период, ИмяТаблицы");
Для Каждого Элемент Из ПользовательскиеНастройки Цикл
СвойстваПоля = СвойстваЭлементов.Поля.Найти(
Элемент.ИдентификаторПользовательскойНастройки, "ИдентификаторНастройки");
СвойстваПоля.ИдентификаторГруппы = "ОбщиеПараметры";
СвойстваПоля.ПоложениеЗаголовка = ПоложениеЗаголовкаЭлементаФормы.Нет;
КонецЦикла;
КонецПроцедурыПередЗагрузкойВариантаНаСервере), добавлено свойство настроек отчета ЗагрузитьНастройкиПриИзмененииПараметров – массив элементов типа ЗначениеПараметраНастроекКомпоновкиДанных.ОпределитьНастройкиФормы описывается следующий код:Процедура ОпределитьНастройкиФормы(Форма, КлючВарианта, Настройки) Экспорт
Параметры = Новый Массив;
Параметры.Добавить(Новый ПараметрКомпоновкиДанных("ИмяТаблицыНабораДанных"));
Настройки.ЗагрузитьНастройкиПриИзмененииПараметров = Параметры;
КонецПроцедурыИнициализироватьКомпоновщикНастроек общего модуля ОтчетыСервер. С ее помощью возникающие ошибки СКД при инициализации компоновщика настроек записываются в журнал регистрации с уровнем Ошибка.
Например, вместо:
КомпоновщикНастроек.Инициализировать(Новый ИсточникДоступныхНастроекКомпоновкиДанных(Схема));рекомендуется вызывать:
ИнициализироватьКомпоновщикНастроек(Отчет.КомпоновщикНастроек, АдресСхемы, Отчет, ВариантОтчета);ИсторияИзменений. Теперь команда по умолчанию размещается не в панели навигации, а в командной панели формы.ВнешниеКомпонентыСервер расширен функциями ПодключитьКомпоненту и ПараметрыПодключения. Подробнее см. в комментариям к ним.ДатыЗапретаИзмененияПереопределяемый добавлены две процедуры ПередПроверкойСтаройВерсииДанных для существующей версии данных и ПередПроверкойНовойВерсииДанных для новой (будущей) версии данных. Подробнее см. в комментарии к этим процедурам.ЗапретРедактированияРеквизитовОбъектов добавлена функция БлокируемыеРеквизитыОбъекта.ПериодыНерабочихДней общего модуля КалендарныеГрафики.ДатыБлижайшихРабочихДней устарел, вместо него рекомендуется использовать: метод БлижайшиеРабочиеДаты для производственного календаря и метод БлижайшиеДатыВключенныеВГрафик общего модуля ГрафикиРаботы для графика работы соответственно.БлижайшиеРабочиеДаты реализован параметр УчитыватьНерабочиеПериоды, позволяющий по-разному интерпретировать периоды нерабочих дней в календарях РФ в 2020 году.БлижайшиеРабочиеДаты реализован параметр НерабочиеПериоды, позволяющий уточнить, какие именно нерабочие периоды нужно учитывать.КонтрольВеденияУчета расширен процедурой ОбновитьПараметрыПроверокУчета. Подробнее см. в описании к ней.ПоддерживаетВыборочнуюПроверку. Оно определяет, допускается ли выполнять проверку конкретных указанных объектов. Подробнее см. в комментарии к процедуре ПриОпределенииПроверок общего модуля КонтрольВеденияУчетаПереопределяемый.
ВыполнитьПроверку общего модуля КонтрольВеденияУчета добавлен необязательный параметр ПроверяемыеОбъекты для вызова «точечной» проверки только определенных объектов.СводнаяИнформацияПоВидамПроверок общего модуля КонтрольВеденияУчета первый параметр ВидПроверок сделан необязательным.УстановитьЗначениеРеквизитаУпорядочивания в общем модуле НастройкаПорядкаЭлементов. Вызов этой процедуры может понадобиться в сценариях, в которых объект с упорядочиванием записывается в режиме ОбменДанными.Загрузка = Истина и штатная подписка на событие ПередЗаписью не срабатывает.Для принудительного обновления времени напоминаний, привязанных ко времени в предметах предусмотрена процедура ОбновитьНапоминанияПоПредметам в общем модуле НапоминанияПользователя. Принудительное обновление может понадобиться в сценариях, в которых предметы записываются в режиме ОбменДанными.Загрузка = Истина и штатная подписка на событие ПриЗаписи не срабатывает. #### Обмен данными
Начиная с версии 3.1.2.331, включена новая версия 1.8 формата EnterpriseData. В ней предусмотрены объекты для реализации обмена ЗУП 3.1 и БП 3.0, а также для обмена с сервисом 1С:Номенклатура.
В процедуре ПриОпределенииНастроек общего модуля ОбновлениеИнформационнойБазыПереопределяемый определить список объектов метаданных, для которых требуется начальным заполнением данных. Например:
Параметры.ОбъектыСНачальнымЗаполнением.Добавить(Метаданные.Справочники.РассылкиОтчетов);В модуле менеджере объекта добавить процедуры-обработчики ПриНастройкеНачальногоЗаполненияЭлементов, ПриНачальномЗаполненииЭлементов, ПриНачальномЗаполненииЭлемента и реализовать в них код заполнения. Например,
Процедура ПриНастройкеНачальногоЗаполненияЭлементов(Настройки) Экспорт
Настройки.ПриНачальномЗаполненииЭлемента = Ложь;
КонецПроцедуры
Процедура ПриНачальномЗаполненииЭлементов(КодыЯзыков, Элементы, ТабличныеЧасти) Экспорт
Элемент = Элементы.Добавить();
Элемент.ИмяПредопределенныхДанных = "ЛичныеРассылки";
Элемент.Наименование = НСтр("ru='Личные рассылки'", ОбщегоНазначения.КодЯзыкаИнформационнойБазы());
КонецПроцедуры
Процедура ПриНачальномЗаполненииЭлемента(Объект, Данные, ДополнительныеПараметры) Экспорт
КонецПроцедурыПример реализации см. в справочнике
РолиИсполнителейдемонстрационной конфигурации.
Для автоматической генерации кода заполнения данных предусмотрен инструмент Начальное заполнение данных, входящий в состав дистрибутива библиотеки в виде внешней обработки.
ОбновлениеИнформационнойБазы расширен процедурами и функциями:
КоличествоПотоковОбновления;ОтложенноеОбновлениеЗавершено;ПриоритетОтложеннойОбработки;РазрешеноМногопоточноеОбновление;УстановитьКоличествоПотоковОбновления;УстановитьПриоритетОтложеннойОбработки.Подробности см. в описании к ним.
ПоддерживаетсяУстановкаОбновлений в общий модуль ОбновлениеКонфигурацииКлиент.ИсправленияИзменены общего модуля ОбновлениеКонфигурации добавлен необязательный параметр ТолькоПроверка.ПечатьДокументов расширен программный интерфейс:
ПриПечати общего модуля УправлениеПечатьюПереопределяемый и процедуры Печать модуля менеджера объектов;ПечатьДокументов общего модуля УправлениеПечатьюКлиент.ПечатьДокументов предусмотрен конструктор параметра ДополнительныеПараметры в виде функции ПараметрыПечати в модуле УправлениеПечатьюКлиент.Подробности см. в описании этих процедур. - Для пакетного формирования нескольких печатных форм объекта расширен программный интерфейс функции
НапечатальВФайлобщего модуляУправлениеПечатью– добавлена возможность указания сразу нескольких команд печати. - Для переопределения режима работы механизма размещения подписей и печатей в печатных формах расширен программный интерфейс модуляУправлениеПечатьюПереопределяемыйпроцедуройПриОпределенииНастроекПечати. Новые возможности: - отключать автоматическую вставку печатей и подписей в печатных формах, - при отключении флажкаПодпись и печатьна формеПечатьдокументовудалять картинки подписей и печатей для того, чтобы эти картинки не мешали редактировать печатную форму. - Для расширения возможностей формыПечатьДокументовобработчик событияОбработкаОповещениявынесен в переопределяемый модульУправлениеПечатьюКлиентПереопределяемый.
ВыполнитьКоманду общего модуля ПодключаемыеКомандыКлиент.Создать на основании отображается в виде картинки, занимает меньше места, оставляя его для других важных команд;Подробнее см. в документации к библиотеке и в описании программного интерфейса модулей
СозданиеНаОснованиииСозданиеНаОснованииПереопределяемый. - Для расстановки фрагментов кода команд ввода на основании можно воспользоваться обработкойПереходНаВерсию312, входящей в состав дистрибутива. - В состав подсистемы перенесены объекты подсистемыЗаполнение объектов. - Редко используемые команды в формах, такие как просмотр отчетаДвижения документа, можно скрыть из командной панели, отображать только в менюЕще. Для управления этой возможностью добавлено свойство командыТолькоВоВсехДействиях. См.ПодключаемыеКомандыПереопределяемый.ПриОпределенииКомандПодключенныхКОбъекту.
ПоискИУдалениеДублейПереопределяемый предусмотрены процедуры, которые полностью соответствуют аналогичным обработчикам модуля менеджера объекта ВозможностьЗаменыЭлементов, ПараметрыПоискаДублей, ПриПоискеДублей:
ПриОпределенииВозможностиЗаменыЭлементов,ПриОпределенииПараметровПоискаДублей,ПриПоискеДублей.Подробнее см. в комментариях к ним. - Состав параметра
ПараметрыПоискапроцедуры-обработчикаПараметрыПоискаДублеймодуля менеджера расширен новым свойствомСравнениеСтрокНаПодобиедля управления нечетким поиском строк при поиске подобных строк. Для разных объектов конфигурации возможно задавать разные значения параметровПроцентСовпаденияСтрок,ПроцентСовпаденияНебольшихСтрок,ДлинаНебольшихСтрок, а такжеСловаИсключения. В последнем параметре указывается список слов, которые следует пропускать при сравнении на подобие. Например, для организаций и контрагентов это могут быть: ИП, ГУП, ООО, ОАО и т.д. В таком случае, наименования “Ромашка” и “ООО Ромашка” будут считаться дублями.
Пользователи добавлена функция СоздатьПароль, которая позволяет автоматически сгенерировать пароль с учетом действующих требований к сложности пароля.ОтправитьПисьма в модуле РаботаСПочтовымиСообщениями.ОтправитьПочтовоеСообщение предусмотрена функция ОтправитьПисьмо.ЧтениеУчетныхЗаписейЭлектроннойПочты может использоваться вместо имеющейся роли ДобавлениеИзменениеУчетныхЗаписейЭлектроннойПочты в случае, когда требуется ограничить пользователям добавление персональных учетных записей электронной почты.СохранитьФайлКак общего модуля РаботаСФайламиКлиент предусмотрен необязательный параметр ОбработчикЗавершения, с помощью которого можно получить имя файла после сохранения его на диск.РаботаСФайлами размещена процедура СкопироватьПрисоединенныеФайлы.ЧтениеРазрешено и ИзменениеРазрешено общего модуля УправлениеДоступом теперь поддерживают проверку объекта и набора записей до записи в базу данных.ЦентрМониторингаВключен общего модуля ЦентрМониторинга.ЭлектроннаяПодписьКлиент добавлена процедура ДобавитьСертификат. Для инициализации параметра ПараметрыДобавления этой процедуры предусмотрена функция ПараметрыДобавленияСертификата, расположенная в этом же модуле.СертификатыКлючейЭлектроннойПодписиИШифрования в общий модуль ЭлектроннаяПодписьКлиент добавлена процедура ЗаписатьСертификатВСправочник. Для инициализации параметра ДополнительныеПараметры этой процедуры предусмотрена функция ПараметрыЗаписиСертификата, расположенная в этом же общем модуле.ЭлектроннаяПодписьКлиент:
ДополнительныеПараметры (тип Структура) процедуры ПроверитьСертификатСправочника включены новые свойства КонтекстОперации и НеПоказыватьРезультаты. Подробнее см. комментарий к процедуре;Результат (тип Структура) процедуры ПроверитьСертификатСправочника расширено свойствами, содержащими сообщения об ошибках для каждой выполненной проверки. Подробнее см. комментарий к процедуре;ПроверитьПодпись добавлен необязательный параметр ПоказатьОшибку;ОписаниеДанных (тип Структура) процедур Подписать, Зашифровать и Расшифровать расширен новым свойством ПрекратитьВыполнение. Подробнее см. комментарий к процедурам;Структура) процедур Подписать, Зашифровать и Расшифровать добавлено новое свойство Отказ. Подробнее см. комментарий к процедурам.Подписать общего модуля ЭлектроннаяПодписьКлиент с параметром Данные, принимающим значение Структура со свойством ПараметрыCMS, теперь по умолчанию возвращаются данные подписи, содержащие полную цепочку сертификатов. Для других вариантов возвращаемое значение функций ПараметрыCMS общего модуля ЭлектроннаяПодписьКлиент расширено новым свойством ВключениеСертификатовВПодпись. Подробнее см. комментарий к функциям.ОткрытьИнструкциюПоТипичнымПроблемамПриРаботеСПрограммами общего модуля ЭлектроннаяПодписьКлиент добавлен необязательный параметр ИмяОшибки для перехода непосредственно к нужной проблеме в инструкции.В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
ПрограммныйИнтерфейс;В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки.
По каждой подсистеме приведены дополнительные инструкции, когда такая совместимость в силу исключительных причин не поддерживается, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf. В этой версии состав проверок был дополнительно расширен, чтобы выявлять больше типовых проблем внедрения.
ДополнительныйЯзык1, ДополнительныйЯзык2, ИспользоватьДополнительныйЯзык1, ИспользоватьДополнительныйЯзык2 и ОсновнойЯзык рекомендуется включать в планы обмена распределенной информационной базы (РИБ).ИсторияИзменений. Теперь команда по умолчанию размещается не в панели навигации, а в командной панели формы, в связи с чем, команда стала доступной не только в форме объекта, но и в форме списка. Для возможности скрытия этой команды из форм списков необходимо в процедуре ПриСозданииНаСервере модулей форм списков версионируемых объектов разместить следующий код:&НаСервере
Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)
// СтандартныеПодсистемы.ВерсионированиеОбъектов
ВерсионированиеОбъектов.ПриСозданииНаСервере(ЭтотОбъект);
// Конец СтандартныеПодсистемы.ВерсионированиеОбъектов
КонецПроцедурыВладелецГрафика в справочнике Календари был изменен на определяемый тип ВладелецГрафикаРаботы. Необходимо перечислить в определяемом типе ВладелецГрафикаРаботы типы тех справочников, которые раньше фактически использовались в качестве значений реквизита ВладелецГрафика.КалендарныеГрафикиПереопределяемый добавлен метод ПриЗаполненииИзменяемыхОбъектовЗависимыхОтПроизводственныхКалендарей. В том случае, если в обработчике ПриОбновленииДанныхЗависимыхОтПроизводственныхКалендарей обрабатываются какие-то объекты, зависимые от производственных календарей, следует перечислить имена метаданных этих объектов.ПериодыНерабочихДнейКалендаря рекомендуется включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места (АРМ).СостоянияПроверокВеденияУчета не следует включать в состав планов обмена РИБ и автономного рабочего места (АРМ), т.к. в проверка ведения учета выполняется в каждом узле независимо.ПараметрыХраненияФайловВИБ, СоздаватьПодкаталогиСИменамиВладельцев и СпособХраненияФайлов не следует включать в состав планов обмена РИБ и автономного рабочего места (АРМ), т.к. настройки хранения файлов индивидуальны для каждого узла информационной базы, в частности, тома хранения файлов располагаются на разных сетевых ресурсах.ДляОбъекта и ДляРегистра. Требуется взять их из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Инструкцию см. в документации к подсистеме Управление доступом в подразделе Обновление шаблонов ограничения доступа в ролях.ДатаПоследнегоОбновленияКлассификатораОшибок и КлассификаторОшибокКриптографии рекомендуется исключить из планов обмена РИБ.Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
УстановитьОтображениеЗаголовковГрупп общего модуля СтандартныеПодсистемыСервер отмечена как устаревшая и оставлена для обратной совместимости. Рекомендуется удалить ее вызовы.СтрокаЛатиницей общего модуля СтроковыеФункцииКлиентСервер следует использовать одноименные функции модулей СтроковыеФункции или СтроковыеФункцииКлиент;ФорматированнаяСтрока общего модуля СтроковыеФункцииКлиентСервер следует использовать одноименные функции модулей СтроковыеФункции или СтроковыеФункцииКлиент;ЗаменитьСсылки общего модуля ОбщегоНазначения для параметра ПараметрыЗамены (тип Структура) предусмотрена функция-конструктор ПараметрыЗаменыСсылок в этом же модуле. Для усиления контроля типизации, в частности, при появлении новых обязательных свойств данной структуры, рекомендуется провести замену всех мест «ручной» инициализации структуры на вызов функции-конструктора.КодОсновногоЯзыка общего модуля ОбщегоНазначения. Теперь функция возвращает код основного языка конфигурации или языка, явно заданного администратором при первом запуске программы.БизнесПроцессыИЗадачиПереопределяемый расширен процедурами: ПриНачальномЗаполненииРолейИсполнителей, ПриНачальномЗаполненииРолиИсполнителя для заполнения ролей исполнителей, ПриНачальномЗаполненииОбъектовАдресацииЗадач, ПриНачальномЗаполненииЭлементаОбъектаАдресацииЗадачи для заполнения объектов адресации задач, следует перенести код заполнения элементов из обработчиков начального заполнения в эти процедуры.ОбновитьНастройкиВерсионированияОбъектов общего модуля ВерсионированиеОбъектов удалена как невостребованная.НачатьИзменение, НачатьВыбор, НачатьОчистку, НачатьОбработкуНавигационнойСсылки и НачатьВыполнениеКоманды общего модуля ПодключаемыеКомандыКлиент вместо аналогичных ПриИзменении, НачалоВыбора, Очистка, ОбработкаНавигационнойСсылки, ВыполнитьКоманду и выглядят следующим образом:
Было:
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияПриИзменении(Элемент)
УправлениеКонтактнойИнформациейКлиент.ПриИзменении(ЭтотОбъект, Элемент);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.НачалоВыбора(ЭтотОбъект, Элемент, , СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияПриНажатии(Элемент, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.НачалоВыбора(ЭтотОбъект, Элемент, , СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияОчистка(Элемент, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.Очистка(ЭтотОбъект, Элемент.Имя);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияВыполнитьКоманду(Команда)
УправлениеКонтактнойИнформациейКлиент.ВыполнитьКоманду(ЭтотОбъект, Команда.Имя);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияАвтоПодбор(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.АвтоПодборАдреса(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияОбработкаВыбора(Элемент, ВыбранноеЗначение, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.ОбработкаВыбора(ЭтотОбъект, ВыбранноеЗначение, Элемент.Имя, СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияОбработкаНавигационнойСсылки(Элемент, НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.ОбработкаНавигационнойСсылки(ЭтотОбъект, Элемент, НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка);
КонецПроцедуры
&НаСервере
Процедура Подключаемый_ОбновитьКонтактнуюИнформацию(Результат) Экспорт
УправлениеКонтактнойИнформацией.ОбновитьКонтактнуюИнформацию(ЭтотОбъект, Объект, Результат);
КонецПроцедурыСтало:
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияПриИзменении(Элемент)
УправлениеКонтактнойИнформациейКлиент.НачатьИзменение(ЭтотОбъект, Элемент);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.НачатьВыбор(ЭтотОбъект, Элемент, , СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияПриНажатии(Элемент, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.НачатьВыбор(ЭтотОбъект, Элемент, , СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияОчистка(Элемент, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.НачатьОчистку(ЭтотОбъект, Элемент.Имя);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияВыполнитьКоманду(Команда)
УправлениеКонтактнойИнформациейКлиент.НачатьВыполнениеКоманды(ЭтотОбъект, Команда.Имя);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияАвтоПодбор(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.АвтоПодборАдреса(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияОбработкаВыбора(Элемент, ВыбранноеЗначение, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.ОбработкаВыбора(ЭтотОбъект, ВыбранноеЗначение, Элемент.Имя, СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_КонтактнаяИнформацияОбработкаНавигационнойСсылки(Элемент, НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)
УправлениеКонтактнойИнформациейКлиент.НачатьОбработкуНавигационнойСсылки(ЭтотОбъект, Элемент, НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_ПродолжитьОбновлениеКонтактнойИнформации(Результат, ДополнительныеПараметры) Экспорт
ОбновитьКонтактнуюИнформацию(Результат);
КонецПроцедуры
&НаСервере
Процедура ОбновитьКонтактнуюИнформацию(Результат)
УправлениеКонтактнойИнформацией.ОбновитьКонтактнуюИнформацию(ЭтотОбъект, Объект, Результат);
КонецПроцедурыВидыКонтактнойИнформации реквизит РедактированиеТолькоВДиалоге (Булево) отмечен как устаревший, вместо него используется реквизит ВидРедактирования (Строка). Поэтому для планов обмена по правилам конвертации с версиями БСП 3.1.1 и ниже следует предусмотреть преобразование значений из одного реквизита в другой. Пример см. в демонстрационной конфигурации в макетах плана обмена _ДемоОбменСБиблиотекойСтандартныхПодсистем225.ПослеЗаписиОбъекта для оперативной перепроверки объекта после записи формы. Для этого в обработчике события ПослеЗаписиНаСервере вставить вызов процедуры:КонтрольВеденияУчета.ПослеЗаписиНаСервере(ТекущийОбъект);ЗаполнитьЗначениеРеквизитаУпорядочивания общего модуля НастройкаПорядкаЭлементов исключена из программного интерфейса, вместо нее следует использовать процедуру УстановитьЗначениеРеквизитаУпорядочивания в этом же модуле. Рекомендуется произвести соответствующие замены в местах использования.ПанельАдминистрированияБСП) внесен ряд изменений, которые необходимости перенести в конфигурацию. Если в эти формы также вносились изменения в конфигурации, то потребуется их объединить с изменениями в библиотеке.ОбщиеПоставляемыеМакетыПечати не требуется включать в планы обменов.НачатьВыполнениеКоманды вместо ВыполнитьКоманду общего модуля ПодключаемыеКомандыКлиент и выглядят следующим образом:
Было:
&НаКлиенте
Процедура Подключаемый_ВыполнитьКоманду(Команда)
ПодключаемыеКомандыКлиент.ВыполнитьКоманду(ЭтотОбъект, Команда, Объект);
КонецПроцедуры
&НаСервере
Процедура Подключаемый_ВыполнитьКомандуНаСервере(Контекст, Результат) Экспорт
ПодключаемыеКоманды.ВыполнитьКоманду(ЭтотОбъект, Контекст, Объект, Результат);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_ОбновитьКоманды()
ПодключаемыеКомандыКлиентСервер.ОбновитьКоманды(ЭтотОбъект, Объект);
КонецПроцедурыСтало:
&НаКлиенте
Процедура Подключаемый_ВыполнитьКоманду(Команда)
ПодключаемыеКомандыКлиент.НачатьВыполнениеКоманды(ЭтотОбъект, Команда, Объект);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_ПродолжитьВыполнениеКомандыНаСервере(ПараметрыВыполнения, ДополнительныеПараметры) Экспорт
ВыполнитьКомандуНаСервере(ПараметрыВыполнения);
КонецПроцедуры
&НаСервере
Процедура ВыполнитьКомандуНаСервере(ПараметрыВыполнения)
ПодключаемыеКоманды.ВыполнитьКоманду(ЭтотОбъект, ПараметрыВыполнения, Объект);
КонецПроцедуры
&НаКлиенте
Процедура Подключаемый_ОбновитьКоманды()
ПодключаемыеКомандыКлиентСервер.ОбновитьКоманды(ЭтотОбъект, Объект);
КонецПроцедурыОтправитьПочтовоеСообщение отмечена как устаревшая, вместо нее следует использовать функции ОтправитьПисьмо, если выполняется отправка одного письма, и ОтправитьПисьма, если функция ОтправитьПочтовоеСообщение вызывалась в цикле. Для упрощения перехода на новые функции предусмотрена вспомогательная функция ПодготовитьПисьмо, параметры которой повторяют параметры функции ОтправитьПочтовоеСообщение в части подготовки письма. Рекомендуется произвести соответствующие замены.ОпределитьФормуПрисоединенногоФайла общего модуля РаботаСФайлами отмечена как устаревшая, вместо нее рекомендуется использовать одноименную процедуру общего модуля РаботаСФайламиКлиентСервер. Рекомендуется пересмотреть места использования этой процедуры.ДобавитьФайл общего модуля РаботаСФайлами для параметра ПараметрыФайла (тип Структура) предусмотрена функция-конструктор ПараметрыДобавленияФайла в этом же модуле. Для усиления контроля типизации, в частности, при появлении новых обязательных свойств данной структуры, рекомендуется провести замену всех мест «ручной» инициализации структуры на вызов функции-конструктора.Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.2.1, 3.1.2.20, 3.1.2.300 и т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
Проверка внедрения БСП, входящем в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf, обновлен макет с эталонным значением прав для роли ПолныеПрава для справочника ПоставляемыеДополнительныеОтчетыИОбработки. Для корректного выявления и исправления проблем рекомендуется использовать актуальную версию отчета.ПериодыНерабочихДнейКалендаря рекомендуется включать в состав планов обмена распределенной информационной базы (РИБ) и автономного рабочего места (АРМ).ДляОбъекта и ДляРегистра. Требуется взять их из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Инструкцию см. в документации к подсистеме Управление доступом в подразделе Обновление шаблонов ограничения доступа в ролях.КонтактнаяИнформация в полнотекстовый поиск был улучшен инструмент Проверка внедрения БСП, входящий в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf. Выявленные ошибки рекомендуется исправлять в плановом порядке.ПриНастройкеНачальногоЗаполненияЭлементов, находящихся в модулях менеджеров объектов, добавлен третий обязательный параметр ТабличныеЧасти с типом Структура, необходимый для заполнения табличных частей объекта. Следует добавить параметр у всех ранее размещенных одноименных процедур-обработчиков начального заполнения.ОбщиеПоставляемыеМакетыПечати не требуется включать в планы обменов.ПолныеПрава и АдминистраторСистемы на объекты библиотеки улучшен инструмент Проверка внедрения БСП, входящий в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf. Выявленные ошибки рекомендуется исправлять в ускоренном порядке, т.к. связаны с правами доступа.При обновлении с ранних версий библиотеки (до 3.1.1) следует:
Переход с предыдущих версий для каждой пропущенной версии.Версия 3.1.1 является новой редакцией продукта 1С:Библиотека стандартных подсистем. Версия 3.1.1 предназначена для разработки на платформе 1С:Предприятие версии 8.3.14 и выше с отключенным режимом совместимости с версией 8.3.14. Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.1.
В состав библиотеки включена новая подсистема Интерфейс OData. Она позволяет настроить автоматический REST-сервис, с помощью которого сторонние приложения могут читать и изменять данные в информационной базе. Подробнее см. документацию. Для настройки сервиса можно воспользоваться командой в разделе Администрирование – Настройка синхронизации – Настройки стандартного интерфейса OData. #### Банки
1С:Предприятие версии 8.3.13 появилась возможность проверять на клиенте некоторые свойства загружаемых файлов до их помещения на сервер. С целью поддержки новых возможностей для процедур ЗагрузитьФайл и ЗагрузитьФайлы общего модуля ФайловаяСистемаКлиент в состав свойств параметра ПараметрыЗагрузки добавлено свойство ДействиеПередНачаломПомещенияФайлов.ОписаниеПереданногоФайла в платформе 1С:Предприятие версии 8.3.13 в состав значения, возвращаемого асинхронной процедурой ФайловаяСистемаКлиент.ЗагрузитьФайлы, добавлены свойства ПолноеИмя и ИмяФайла.ИдентификаторОбъектаМетаданных и ИдентификаторыОбъектовМетаданных общего модуля ОбщегоНазначения добавлен необязательный параметр ВызыватьИсключение (значение по умолчанию Истина).СтрокаВДату программного интерфейса общего модуля СтроковыеФункцииКлиентСервер для преобразования дат со временем теперь поддерживает распознавание времени. Для этого добавлен второй необязательный параметр ЧастьДаты, который определяет возвращаемый вариант даты: дата, время, дата и время. По умолчанию, если этот параметр не задан, будет возвращена только дата.СтроковыеФункции и СтроковыеФункцииКлиент добавлена функция ФорматированнаяСтрока. Оформление текста выполняется HTML подобным языком разметки и позволяет менять цвет, шрифт, выводить картинки и создавать гиперссылки. Например, “Цена <span style=‘color: ПоясняющийТекст’>некорректная</span>”. Подробнее см. комментарий к функции.ОткрытьФормуОтправкиSMS общего модуля ВзаимодействияКлиент предусмотрена функция-конструктор ПараметрыФормыОтправкиSMS в этом же модуле.ОтключитьНебезопасноеСодержимое в общем модуле РаботаСПочтовымиСообщениями.
ЕстьВнешниеРесурсы в общем модуле РаботаСПочтовымиСообщениями.СформироватьСообщениеИОтправить программного интерфейса общего модуля ШаблоныСообщений в четвертом параметре ДополнительныеПараметры предусмотрено свойство УчетнаяЗапись.Версия 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/).
Если в конфигурации используется 1С:Библиотека стандартных подсистем (БСП) совместно с 1C:Библиотека технологии сервиса (БТС), то порядок перехода следующий: для перехода на версию 3.1.1 необходимо также взять БТС версии 1.2 и в конфигураторе выполнить 5 шагов.
обязательные подсистемы согласно таблице 2.1 документации;
дополнительные подсистемы, обязательные к переносу в конфигурацию для работы в модели сервиса, согласно таблице 2.2 документации;
все ранее внедренные подсистемы, а также подсистемы, которые дополнительно требуется внедрить в вашу конфигурацию;
подсистемы, от которых зависят отмеченные выше подсистемы, согласно таблицам 2.1–2.3 документации (https://its.1c.ru/db/bspdoc).
Далее нажать кнопку Установить.
Важно!
Необходимо убедиться, что в список отмеченных подсистем включены все обязательные подсистемы из таблицы 2.1 документации (вместе с относящимися к ним объектами метаданных). Если предполагается работа конфигурации в модели сервиса, то обязательными также являются подсистемы из таблицы 2.2 документации. В противном случае конфигурация окажется неработоспособной. Если подсистема ‘Администрирование’ была внедрена ранее или планируется ее внедрение, то отметить ее флажком в окне сравнения и объединения конфигураций (объект метаданных «подсистема»).
Выбрать режим объединения Взять из новой конфигурации поставщика (Действия – Установить режим для всех…). Дополнительно нужно установить или снять флажки для отдельных объектов библиотеки и их свойств согласно инструкциям в таблице 2.6 документации. В зависимости от числа обновляемых и дополнительно устанавливаемых подсистем этот шаг может занять от 15 минут до одного часа.
Выполнить команду Конфигурация – Поддержка – Обновить конфигурацию, указав в варианте Выбор файла обновления путь к файлу поставки БТС. В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, снять флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК. В окне сравнения и объединения конфигураций снять все флажки и с помощью команды Действия – Отметить по подсистемам новой конфигурации поставщика отметить все объекты подсистемы ‘ТехнологияСервиса’. Далее нажать кнопку Установить.
Выполнить команду Конфигурация – Поддержка – Настройка поддержки. В открывшейся форме Настройка поддержки выбрать значение ‘БиблиотекаСтандартныхПодсистем’ в выпадающем списке Конфигурация поставщика и нажать на кнопку Сравнить, объединить. В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, установить флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК. В окне сравнения и объединения конфигураций снять все флажки и отметить все подсистемы, которые внедрены в конфигурацию и относятся к подсистеме ‘СтандартныеПодсистемы’. Далее нажать кнопку Выполнить.
Выполнить команду Конфигурация – Поддержка – Настройка поддержки. В открывшейся форме Настройка поддержки выбрать значение ‘БиблиотекаТехнологииСервиса’ в выпадающем списке Конфигурация поставщика и нажать на кнопку Сравнить, объединить. В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, установить флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК. В окне сравнения и объединения конфигураций снять все флажки и отметить подсистему ‘ТехнологияСервиса’. Далее нажать кнопку Выполнить.
В дереве конфигурации выполнить команду По подсистемам. В открывшемся окне Отбор по подсистемам снять все флажки в дереве подсистем, установить флажок напротив значения <Не входящие в подсистемы> и нажать кнопку Установить. Удалить из конфигурации все объекты метаданных, которые не входят ни в одну подсистему и не стоят на поддержке ни одной из библиотек.
В этом разделе для каждой подсистемы даны дополнительные инструкции по переходу, которые необходимо выполнить в конфигураторе после завершения сравнения/объединения.
Для совместимости с предыдущими версиями библиотеки во всех подсистемах предусмотрен программный интерфейс. К нему относятся те объекты метаданных библиотеки, которые предназначены для использования в прикладном коде:
В случае использования программного интерфейса существенно снижается необходимость в переработках кода конфигурации при обновлении на новые версии библиотеки.
По каждой подсистеме приведены дополнительные инструкции, когда такая совместимость в силу исключительных причин не поддерживается, и требуется адаптировать конфигурацию к новому программному интерфейсу библиотеки. При этом не документируются изменения в служебных процедурах и функциях библиотеки (даже если они являются экспортными), которые не относятся к программному интерфейсу. При непосредственном вызове их из конфигурации следует учитывать, что они могут быть изменены, перемещены или удалены в следующей версии библиотеки, поскольку являются ее внутренней реализацией.
После выполнения инструкций по переходу рекомендуется воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ‘ПроверкаВнедренияБСП.erf’. В этой версии состав проверок был дополнительно расширен, чтобы выявлять больше типовых проблем внедрения.
АдресныйКлассификатор:
КлассификаторЗагружен.АдресныйКлассификаторКлиент:
ОткрытьФормуПроверкиОбновления;ОткрытьФормуЗагрузкиАдресногоКлассификатора.ОбщегоНазначения:
ПолучитьКартинкуКомментария;ЗаполнитьМассивУникальнымиЗначениями;Просклонять;WSПрокси;ПолучитьТаблицуОписанияСвойствОбъекта;ПолучитьОбщийСписокИсключенийПоискаСсылок;СкопироватьXDTO;ПредставлениеТипаXDTO;ХранилищеОбщихНастроекСохранитьМассивИОбновитьПовторноИспользуемыеЗначения;ХранилищеОбщихНастроекСохранитьИОбновитьПовторноИспользуемыеЗначения;ЗаблокироватьИБ;РазблокироватьИБ;ИмяТипаРегистрыСведений;ИмяТипаРегистрыНакопления;ИмяТипаРегистрыБухгалтерии;ИмяТипаРегистрыРасчета;ИмяТипаДокументы;ИмяТипаСправочники;ИмяТипаПеречисления;ИмяТипаОтчеты;ИмяТипаОбработки;ИмяТипаПланыОбмена;ИмяТипаПланыВидовХарактеристик;ИмяТипаБизнесПроцессы;ИмяТипаЗадачи;ИмяТипаПланыСчетов;ИмяТипаПланыВидовРасчета;ИмяТипаКонстанты;ИмяТипаЖурналыДокументов;ИмяТипаПоследовательности;ИмяТипаРегламентныеЗадания;ИмяТипаПерерасчеты;УстановитьРазделениеСеанса;ЗначениеРазделителяСеанса;УстановитьПараметрыРазделенияИнформационнойБазы;ЗаписатьВспомогательныеДанные;УдалитьВспомогательныеДанные;ЭтоРазделенныйОбъектМетаданных.ОбщегоНазначенияВызовСервера:
ХранилищеОбщихНастроекСохранитьМассивИОбновитьПовторноИспользуемыеЗначения;ХранилищеОбщихНастроекСохранитьИОбновитьПовторноИспользуемыеЗначения;УстановитьРазделениеСеанса.ОбщегоНазначенияПереопределяемый:
ПараметрыРаботыКлиентаПриЗапуске;ПараметрыРаботыКлиента.ОбщегоНазначенияПовтИсп:
ЭтоРазделеннаяКонфигурация;РазделителиКонфигурации;СоставОбщегоРеквизита;ЭтоРазделенныйОбъектМетаданных;РазделительОсновныхДанных;РазделительВспомогательныхДанных;РазделениеВключено;ДоступноИспользованиеРазделенныхДанных;ПолучитьПреобразованиеXSLИзОбщегоМакета;СеансЗапущенБезРазделителей;РежимРаботыПрограммы.СтандартныеПодсистемыСервер:
ЭтоОбъектНачальногоОбразаУзлаРИБ;ПроверитьСоставПланаОбмена.СтроковыеФункцииКлиентСервер:
СтрокаИзМассиваПодстрок;НайтиСимволСКонца;ПолучитьПараметрыИзСтроки.Администрирование – Интернет-поддержка и сервисы – Классификаторы и курсы валют – Обновление классификаторов).
ПолучениеОбновленийКлассификаторов в Библиотеке интернет-поддержки пользователей. Роль ДобавлениеИзменениеБанков не предоставляет доступ к обновлению классификатора банков. Необходимо учесть это изменение в имеющихся профилях групп доступа. Рекомендуется включить роль ПолучениеОбновленийКлассификаторов в профили, имеющие роль ДобавлениеИзменениеБанков.ПолучитьДанныеКлассификатораРФ общего модуля РаботаСБанками.Библиотеки интернет-поддержки пользователей необходимо удалить ранее выполненные вставки кода подсистемы Банки из процедур ПриСохраненииДанныхАутентификацииПользователяИнтернетПоддержки и ПриУдаленииДанныхАутентификацииПользователяИнтернетПоддержки общего модуля ИнтернетПоддержкаПользователейПереопределяемый. БизнесПроцессыИЗадачиВызовСервера:
УведомитьИсполнителейОНовыхЗадачах;ПроконтролироватьЗадачи.ПересчитатьИзВалютыВВалюту общего модуля РаботаСКурсамиВалютКлиентСервер. - При наличии в конфигурации Библиотеки интернет-поддержки пользователей необходимо удалить ранее выполненные вставки кода подсистемы Валюты из процедур ПриСохраненииДанныхАутентификацииПользователяИнтернетПоддержки и ПриУдаленииДанныхАутентификацииПользователяИнтернетПоддержки общего модуля ИнтернетПоддержкаПользователейПереопределяемый.ВариантыОтчетов:
ИспользуемыеРазделы;ДобавитьОбработчикиПолногоОбновления;ПолучитьСсылку.ОткрытьФормуОтправкиПочтовогоСообщения общего модуля ВзаимодействияКлиент.ДополнительныеОтчетыИОбработки:
ПолучитьОбъектВнешнейОбработки;ПриСозданииНаСервере;ВыполнитьНазначаемуюКомандуНаСервере.ДополнительныеОтчетыИОбработкиВызовСервера:
ПолучитьОбъектВнешнейОбработки.ДополнительныеОтчетыИОбработкиКлиент:
ПоказатьРезультатВыполненияКоманды;ВыполнитьНазначаемуюКомандуНаКлиенте.ДополнительныеОтчетыИОбработкиКлиентСервер:
ТипКомандыСценарийВБезопасномРежиме.ДополнительныеОтчетыИОбработкиВБезопасномРежимеИнтерфейс;ДополнительныеОтчетыИОбработкиРегламентныеЗадания.ПолучитьИспользованиеСобытияДоступ общего модуля ЗащитаПерсональныхДанных.УправлениеКонтактнойИнформацией:
ЗначенияКонтактнойИнформацииОбъекта;ТаблицаКонтактнойИнформацииОбъекта;ЗаполнитьКонтактнуюИнформациюОбъектов;ЗаполнитьКонтактнуюИнформациюОбъекта;ПредыдущийФорматКонтактнойИнформацииXML;ПредыдущаяСтруктураКонтактнойИнформацииXML;АдресВФорматеКЛАДР;СведенияОбАдресах;СведенияОбАдресе;РегионАдресаКонтактнойИнформации;ГородАдресаКонтактнойИнформации;ПроверитьАдрес;ПараметрыКонтактнойИнформацией.1С:Предприятие версии 8.3.13 в модулях форм c внедренной контактной информацией у ранее размещенных процедур Подключаемый_ОбновитьКонтактнуюИнформацию необходимо добавить ключевое слово Экспорт:
Было:
Процедура Подключаемый_ОбновитьКонтактнуюИнформацию(Результат)Стало:
Процедура Подключаемый_ОбновитьКонтактнуюИнформацию(Результат) ЭкспортКалендарныеГрафики:
ПолучитьМассивДатПоКалендарю;ПолучитьДатуПоКалендарю;ПолучитьРазностьДатПоКалендарю;ПроизводственныйКалендарьРоссийскойФедерации;ПолучитьДатыРабочихДней.Библиотеки технологии сервиса необходимо удалить ранее выполненные вставки кода подсистемы Календарные графики из процедуры ПриОбработкеОбластиДанных общего модуля РаботаСКлассификаторамиВМоделиСервисаПереопределяемый.НапоминанияПользователяКлиентСерверПереопределяемый, содержавший устаревший программный интерфейс.КонечнаяТочкаОбменаСообщениями необходимо включить план обмена ОбменСообщениями из Библиотеки технологии сервиса, и исключить все другие типы.ПриОтключенииОбработчиковОбновления общего модуля ОбновлениеИнформационнойБазыПереопределяемый.УправлениеПечатью:
ПолучитьЛокальныйКаталогФайловПечати;ПриСозданииНаСервере.УправлениеПечатьюКлиент:
ВыполнитьПодключаемуюКомандуПечати;НачатьОбновлениеКоманд.УправлениеПечатьюКлиентСервер:
ОбновитьКоманды.В связи с изменением поведения платформы 1C:Предприятие 8.3.13, у ранее размещенных в модулях форм процедур Подключаемый_ВыполнитьКомандуНаСервере необходимо добавить ключевое слово Экспорт:
Было: 1C Процедура Подключаемый_ВыполнитьКомандуНаСервере(Контекст, Результат)
Стало: 1C Процедура Подключаемый_ВыполнитьКомандуНаСервере(Контекст, Результат) Экспорт ##### Пользователи
Удален устаревший программный интерфейс общего модуля Пользователи:
ПрочитатьПользователяИБ;ЗаписатьПользователяИБ;РольАдминистратораСистемы.ПрефиксацияОбъектовКлиентСервер:
ПолучитьПользовательскийПрефикс;ПолучитьНомерНаПечать.РаботаВБезопасномРежиме:
ВыполнитьМетодКонфигурации;ВыполнитьМетодОбъекта;ВыполнитьВБезопасномРежиме;ВычислитьВБезопасномРежиме.ПрисоединенныеФайлы;ПрисоединенныеФайлыКлиент;ПрисоединенныеФайлыКлиентСервер;ФайловыеФункции.ПриИзмененииПредставления общего модуля СклонениеПредставленийОбъектовКлиент более не поддерживается. В модулях форм объектов склонений, где она вызывается, необходимо:
ПросклонятьПредставление общего модуля СклонениеПредставленийОбъектовКлиент,Подключаемый_ПросклонятьПредставлениеПоВсемПадежам.ФизическиеЛицаКлиентСервер:
ФамилияИмяОтчество;ФамилияИнициалыФизЛица.ДляОбъекта и ДляРегистра во всех ролях. Стандартные шаблоны взять из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Для массового обновления удобно использовать вкладку Шаблоны ограничений в форме Все ограничения доступа (включить отбор по наименованию шаблона, выделить все строки и использовать команду Изменить), либо использовать отчет ПроверкаВнедренияБСП.erf в режиме исправления ошибок.Действия, указанные далее, не являются обязательными для перехода, но рекомендуются запланировать их отработку в будущем.
ЭтоOSXКлиент общих модулей ОбщегоНазначения и ОбщегоНазначенияКлиент устарели, вместо них рекомендуется использовать ЭтоMacOSКлиент этих же общих модулей. Рекомендуется пересмотреть места вызовов этой процедуры.Администрирование – Интернет-поддержка и сервисы – Классификаторы и курсы валют – Обновление классификаторов). Если она отсутствует в конфигурации, рекомендуется запланировать ее внедрение.Администрирование – Интернет-поддержка и сервисы – Классификаторы и курсы валют – Обновление классификаторов). Если она отсутствует в конфигурации, рекомендуется запланировать ее внедрение.ПриЗаписиНаСервере общего модуля СклонениеПредставленийОбъектов устарела, вместо нее рекомендуется использовать ПриЗаписиФормыОбъектаСклонения этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.ПросклонятьФИОСПомощьюКомпоненты общего модуля СклонениеПредставленийОбъектов устарела, вместо нее рекомендуется использовать ПросклонятьФИО этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.ПросклонятьПредставлениеПоВсемПадежам общего модуля СклонениеПредставленийОбъектовКлиент устарела, вместо нее рекомендуется использовать ПросклонятьПредставление этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.ОбработатьКомандуСклонения общего модуля СклонениеПредставленийОбъектовКлиент устарела, вместо нее рекомендуется использовать ПоказатьСклонение этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.ПриСозданииФормыЗначенияДоступа общего модуля УправлениеДоступом.
Реквизит, Элементы, ТипЗначения, СозданиеНового отмечены как устаревшие и оставлены для обратной совместимости. Вместо них следует использовать структуру ДополнительныеПараметры передаваемую вторым параметром. Следует проверить все места использования.ДополнительныеПараметры предусмотрена функция-конструктор ПараметрыПриСозданииФормыЗначенияДоступа в общем модуле УправлениеДоступом.ИдентификаторыОбъектовМетаданных предопределенные элементы всех регистров, чтобы при изменении ограничений доступа в модулях менеджеров не требовалось добавления предопределенных элементов при доработке конфигурации на внедрении, а также использовании расширений конфигурации.ПроверкаВнедренияБСП.epf в режиме исправления теперь добавляет в справочник ИдентификаторыОбъектовМетаданных предопределенные элементы всех регистров. Рекомендуется выполнить запуск отчета в режиме исправления.Исправительные релизы библиотеки отличаются только четвертой цифрой в полном номере версии, например: 3.1.1.1, 3.1.1.20, 3.1.1.300 и т.п. Для обновления на исправительные релизы предназначена внешняя обработка ОбновлениеНаИсправительнуюВерсиюБСП.epf из комплекта поставки, которая позволяет существенно сэкономить время при регулярных обновлениях (например, еженедельных).
Необходимо запустить обработку в информационной базе с конфигурацией, содержащей предыдущий релиз библиотеки, указать cf-файл поставки новой версии библиотек и нажать на кнопку Обновить на исправительную версию. При этом выполняется автоматическое сравнение/объединение с новой конфигурацией библиотеки согласно настройкам, которые соответствуют документации: будут перенесены все поставляемые объекты библиотеки, а переопределяемые при внедрении – объединены с приоритетом конфигурации поставщика (например, определяемые типы) или пропущены (как например, переопределяемые модули). После сравнения/объединения конфигурация базы данных не будет обновлена автоматически, что позволяет выполнить сравнение с конфигурацией базы данных и внести правки в измененные объекты: переопределяемые модули, различные локальные исправления и доработки.
Кроме того, в качестве альтернативного варианта, по кнопке Сформировать файл настроек предусмотрена возможность сформировать файл настроек сравнения/объединения, который затем можно загрузить в конфигураторе для ручного сравнения/объединения.
После завершения сравнения/объединения настоятельно рекомендуется также воспользоваться инструментом Проверка внедрения БСП, входящим в состав дистрибутива библиотеки в виде внешнего отчета ПроверкаВнедренияБСП.erf.
ДляОбъекта и ДляРегистра. Требуется взять их из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Для массового обновления удобно использовать вкладку Шаблоны ограничений в форме Все ограничения доступа (включить отбор по наименованию шаблона, выделить все строки и использовать команду Изменить). Либо использовать отчет ПроверкаВнедренияБСП.epf в режиме исправления ошибок.ПриЗаполненииСписковСОграничениемДоступа общего модуля УправлениеДоступомПереопределяемый, в обработчик события ПослеЗаписиНаСервере формы объекта (все формы с основным реквизитом объекта) сделать вставку:// СтандартныеПодсистемы.УправлениеДоступом
УправлениеДоступом.ПослеЗаписиНаСервере(ЭтотОбъект, ТекущийОбъект, ПараметрыЗаписи);
// Конец СтандартныеПодсистемы.УправлениеДоступом ПереходНаВерсию303.epf, входящую в состав дистрибутива (запускать только на файловой ИБ).ДляОбъекта и ДляРегистра во всех ролях. Стандартные шаблоны взять из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Для массового обновления удобно использовать вкладку Шаблоны ограничений в форме Все ограничения доступа (включить отбор по наименованию шаблона, выделить все строки и использовать команду Изменить), либо использовать отчет ПроверкаВнедренияБСП.erf в режиме исправления ошибок.НастройкиПользователейИПрав обработки ПанельАдминистрированияБСП, если используется.ПервоеОбновлениеДоступаЗавершилось только для создания начального узла (то есть не включать в подписки регистрации изменений).ДляОбъекта и ДляРегистра для работы на версии платформы 8.3.15. Требуется взять их из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Для массового обновления удобно использовать вкладку Шаблоны ограничений в форме Все ограничения доступа (включить отбор по наименованию шаблона, выделить все строки и использовать команду Изменить). Либо использовать отчет ПроверкаВнедренияБСП.epf в режиме исправления ошибок.НастройкиПользователейИПрав обработки ПанельАдминистрированияБСП, если используется.Обновление на версию 3.1.1 допустимо с версии 2.3.3 и больше. Если в конфигурацию встроена более старая версия библиотеки, то разработчику необходимо запретить прямой переход на новую версию конфигурации (на базе версии 3.1.1 библиотеки) и организовать его через промежуточную версию с обязательным запуском для выполнения обработчиков обновления (включая отложенные).
Например, в конфигурации версии 1.1.1 и больше используется версия БСП 2.3.3, а в новую версию 1.2.1 встраивается версия БСП 3.1.1, тогда:
1С:Обновление программ (https://releases.1c.ru), то при публикации новой версии 1.2.1 в свойстве Минимальная версия для запуска обработчиков указать тот номер версии, в которой используется БСП 2.3.3 (в данном примере – 1.1.1). Тогда при обновлении конфигурации в режиме предприятия автоматически будет выполнен требуемый обязательный запуск.ПриОпределенииВозможностиОбновления общего модуля ОбновлениеИнформационнойБазыКлиентПереопределяемый:Процедура ПриОпределенииВозможностиОбновления(Знач ВерсияДанных) Экспорт
ДопустимаяВерсия = "1.1.1";
ВерсияДанныхБезНомераСборки = ОбщегоНазначенияКлиентСервер.ВерсияКонфигурацииБезНомераСборки(ВерсияДанных);
Результат = ОбщегоНазначенияКлиентСервер.СравнитьВерсииБезНомераСборки(ВерсияДанныхБезНомераСборки, ДопустимаяВерсия);
Если ВерсияДанных <> "0.0.0.0" И Результат < 0 Тогда
Сообщение = НСтр("ru = 'Недопустимая попытка обновления с версии %2.
|Обновление допустимо только с версии %1 и выше.
|Необходимо восстановить информационную базу из резервной копии
|и повторить обновление согласно файлу 1cv8upd.htm'");
Сообщение = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(Сообщение, ДопустимаяВерсия, ВерсияДанных);
ВызватьИсключение Сообщение;
КонецЕсли;
КонецПроцедурыПри обновлении с ранних версий библиотеки (до 3.0.1) следует:
Переход с предыдущих версий для каждой пропущенной версии.Например, если выполняется обновление с версии 3.0.1.1 сразу на версию 3.1.1.123, то следует последовательно выполнить инструкции всех разделов: