Версия 3.1.7 предназначена для разработки на платформе 1С:Предприятие 8.3.17 и выше. Доступны режимы совместимости с Версия 8.3.14 по Версия 8.3.21 включительно.
Полный перечень нововведений см. ниже в разделе Новые возможности и изменения в версии 3.1.7.
ПриДобавленииСерверныхОповещений общего модуля ОбщегоНазначенияПереопределяемый и реализовать обработчики его отправки и получения. См. примеры в демонстрационной конфигурации.ПередПериодическойОтправкойДанныхКлиентаНаСервер общего модуля ОбщегоНазначенияКлиентПереопределяемый и их обработку в процедурах ПриПериодическомПолученииДанныхКлиентаНаСервере или ПослеПериодическогоПолученияДанныхКлиентаНаСервере общего модуля ОбщегоНазначенияПереопределяемый. При этом для отсчета времени следует применять функцию ЗакончилосьВремяОжидания общего модуля СерверныеОповещенияКлиент. Вызовы своих обработчиков нужно оборачивать в попытку и добавлять замер производительности с использованием процедур ОбработатьОшибку и ДобавитьПоказатель общих модулей СерверныеОповещенияКлиент и СерверныеОповещения. См. примеры в демонстрационной конфигурации.ОжидатьЗавершение общего модуля ДлительныеОперацииКлиент, а также заменить объект платформы СообщениеПользователю в процедурах длительных операций на процедуру СообщитьПользователю общего модуля ОбщегоНазначения. В случае если в информационной базе подключены обсуждения (система взаимодействий), то с их помощью можно более оперативно доставлять на клиент информацию о прогрессе и сообщения, которые отправляются из фонового задания.СообщенияПользователю общего модуля ДлительныеОперации. Процедура СообщитьПрогресс общего модуля ДлительныеОперации больше не отправляет прогресс через сообщения пользователю, а переведена на механизм серверных оповещений.УдаленныйДоступ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, то следует последовательно выполнить инструкции всех разделов: