1С:Библиотека стандартных подсистем

Версия 3.1.2

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

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

Переход на версию 3.1.2 с версии 3.1.1

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

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

Версия 3.1.1

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

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

Переход на версию 3.1.1 с версии 3.0.3

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

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

 


Версия 3.1.2

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

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

·         Для удобства управления большим количеством расширений конфигурации в форме Расширения (раздел АдминистрированиеПечатные формы, отчеты и обработки - Расширения) можно обновлять, а также выгружать в папку сразу несколько выбранных расширений за одно действие.

·         Для упрощения анализа ошибок в журнале регистрации информация о блокировке запуска регламентных заданий записывается с уровнем критичности Предупреждение вместо Ошибка (раздел АдминистрированиеОбслуживание – Журнал регистрации).

Контактная информация

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

Контроль ведения учета

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

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

·        В отчете Контроль ведения учета предусмотрены быстрые отборы по периоду, проверкам и ответственному. Улучшено сообщение о наличии проблем ведения учета в карточке проблемного документа (объекта): выводится дата и время последней проверки. Если в документе выявлена только одна проблема, то сразу выводится ее описание. После записи документа оперативно выполняется перепроверка для подтверждения устранения проблемы.

·        Для повышения удобства в списках и карточке объекта картинка индикатора проблем теперь соответствует самой критичной из найденных проблем.

·        Для администраторов: информация о критичных проблемах записывается в журнал регистрации со статусом Ошибка.

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

·        Для повышения удобства обновления больших информационных баз приоритет выполнения дополнительных процедур обработки данных сохраняется и применяется при переходе на следующие версии программы.

o   По умолчанию установлен приоритет обработки данных, а изменить это значение можно в разделе АдминистрированиеОбслуживание, группа Обновление программы.

o   Для пакетного запуска сеанса для обновления на новую версию программы с приоритетом обработки данных можно использовать параметр запуска /C ФорсироватьОтложенноеОбновление.

·        При работе через Интернет для уменьшения времени недоступности сервиса после обновления на новую версию приложения, вход любого пользователя форсирует завершение обновления приложения (области данных).

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

·        Некоторые редко используемые команды в формах, такие как просмотр отчета Движения документа, теперь отображаются только в меню Еще.

Работа с файлами

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

·        Теперь можно раздельно хранить наиболее важные файлы в информационной базе, а менее важные – в томах на диске. Настроить расширения файлов, которые должны храниться в информационной базе, а также установить ограничение на их максимальный размер можно в разделе АдминистрированиеНастройка работы с файлами.

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

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

·        Для повышения безопасности и организации хранения файлов при работе приложения в Интернете (технология 1cFresh http://v8.1c.ru/fresh/whatis.htm)  возможно настроить раздельное хранение файлов каждого абонента (области данных) в подкаталогах. Для этого в полном пути тома необходимо указать %z (раздел АдминистрированиеНастройка работы с файламиТома хранения файлов). Например, \\server\files\user%z.

Свойства

·        Упрощена настройка дополнительных реквизитов и сведений в разделе АдминистрированиеОбслуживание. Удалены избыточные опции:

o   Реквизиты и сведения с общим списком значений - добавление реквизитов данного типа теперь доступно всегда;

o   Общие реквизиты и сведения – все реквизиты теперь считаются общими, и работа с ними в программе ведется единообразно.

·        В списке дополнительных реквизитов (Администрирование – Общие настройки, ссылка Дополнительные реквизиты) теперь можно установить флаг Показать неиспользуемые реквизиты, посмотреть список реквизитов и сведений, которые больше не используются в программе и принять решении об их удалении или использовании.

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

·        Повышено удобство настройки прав доступа для подразделений, складов и других иерархических справочников. При настройке разрешенных значений в группах доступа (раздел Администрирование – Настройки пользователей и прав – Группы доступа) можно указать признак Включая нижестоящие (с иерархией) вместо подбора всех подчиненных элементов справочника. Данная возможность недоступна в случае когда уже предусмотрен выбор группы значений, например, групп доступа партнеров.

Шаблоны сообщений

·        При подготовке нового письма по предмету (заказу покупателя и т. п.) без использования шаблона можно приложить к письму печатные формы этого предмета.

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

·        В настройках электронной подписи и шифрования (раздел АдминистрированиеОбщие настройкиЭлектронная подпись и шифрование) существенно упрощена отправка заявления на выпуск нового квалифицированного сертификата электронной подписи:

o   Заявление формируется и отправляется в одном окне;

o   Если требуется получить новый сертификат взамен сертификата с истекающим сроком действия, сформировать новое заявление можно путем копирования информации из сертификата, полученного ранее;

o   Часто возникающие вопросы о назначении электронной подписи, цене сертификата и др. размещены на странице портала ИТС 1С:Подпись https://portal.1c.ru/applications/31

Варианты отчетов

·        При сохранении нового варианта отчета можно указать конкретного пользователя, список пользователей или группы пользователей, для которых он предназначен: например, сохранить вариант отчета по продажам только для менеджеров Иванова и Сидорова, либо для всего отдела продаж.

o   Ранее предоставлялась возможность сохранять варианты отчетов сразу для всех пользователей, которые имеют права доступа на отчет. В некоторых случаях это могло быть избыточным.

o   Теперь автор может управлять тем, чтобы его вариант отчета появлялся в панелях отчетов только у тех пользователей, кому он действительно необходим (например, по должностным обязанностям) и при этом не «замусоривать» панели отчетов остальных пользователей, которые также имеют права доступа на отчет. Однако при необходимости они смогут разместить вариант отчета в своих панелях отчетов самостоятельно, воспользовавшись режимом настройки (кнопка Настроить в панели отчета).

o   Автор варианта отчета также может пересмотреть список пользователей в любой другой момент времени, перезаписав варианта отчета, либо открыв его карточку из списка Отчеты.

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

o   В тех случаях, когда действительно необходимо сохранить вариант отчета сразу для всех пользователей, которые имеют права доступа на отчет, следует указать предопределенную группу Все пользователи (Все внешние пользователи).

·        Добавлена возможность обмена настройками вариантов отчетов между информационными базами (ИБ) с идентичной структурой.

o   Обмен осуществляется через сохранение в файл.

o   Вместе с настройками варианта отчета также можно передать пользовательские настройки.

·        Реализована функциональность адресного обмена пользовательскими настройками в рамках ИБ.

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

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

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

·        Упрощена разработка мультиязычных конфигураций, в которых отдельные реквизиты должны вводиться и храниться сразу на нескольких языках (помимо основного языка возможны максимум два дополнительных). Например, для хранения значений реквизита Наименования справочника РолиИсполнителей на двух дополнительных языках необходимо:

o   В свойстве Состав общих реквизитов НаименованиеЯзык1 и  НаименованиеЯзык2 у справочника РолиИсполнителей в поле Использование установить значение Использовать.

o   Затем выполнить вставки в форму списка, элемента, модуль объекта и модуль менеджера согласно документации к подсистеме Базовая функциональность (см. раздел Мультиязычные данные).

o   Администратору при первом запуске информационной базы будет предложено выбрать основной и дополнительные языки ввода данных. Кроме того, эти языки можно перевыбрать позднее из раздела Администрирование.

o   Подробнее см. документацию к библиотеке и программный интерфейс общих модулей МультиязычностьСервер, МультиязычностьКлиент и МультиязычностьПереопределяемый.

·        Для интерактивного выбора формата вложений при подготовке нового письма в программный интерфейс модуля ОбщегоНазначенияКлиент добавлена процедура ПоказатьВыборФорматаВложений.

·        Для выборки значений одинаковых реквизитов объектов разных типов снято ограничение в функциях ЗначенияРеквизитовОбъектов и ЗначенияРеквизитаОбъектов в общем модуле ОбщегоНазначения. Например, это удобно для выборки значений реквизитов из журнала документов.

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

·        Упрощен программный интерфейс для запуска длительных операций – в качестве фонового задания можно вызывать функции без необходимости переделки состава параметров. Таким же образом можно выполнять в фоне процедуры, не использующие параметры с возвращаемыми значениями. Для этого в общем модуле ДлительныеОперации предусмотрены функции ВыполнитьФункцию и ВыполнитьПроцедуру, а также вспомогательные функции ПараметрыВыполненияФункции и ПараметрыВыполненияПроцедуры. Описание параметров см. в комментарии к этим функциям.

·        Для получения представления объекта или его списка из метаданных предусмотрены функции ПредставлениеОбъекта и ПредставлениеСписка в общем модуле ОбщегоНазначения. В зависимости от того, какие свойства объекта метаданных заполнены, функции возвращают одно из них в указанном порядке: Расширенное представление объекта/списка, Представление объекта/списка, Синоним или Имя.

Варианты отчетов

·        Настройка колонтитулов отчетов теперь включена по умолчанию (общие настройки см. в разделе Администрирование – Печатные формы, отчеты и обработки – Настройка колонтитулов, а индивидуальные настройки колонтитулов для выбранного отчета устанавливаются в расширенном режиме настройки на закладке Оформление). Если же требуется выключить, то в процедуре ПриОпределенииНастроек общего модуля ВариантыОтчетовПереопределяемый необходимо:

o   Для выключения общей настройки вставить строку:

Настройки.ВыводитьОбщиеНастройкиКолонтитулов = Ложь;

o   Для выключения индивидуальной настройки вставить строку:

Настройки.ВыводитьИндивидуальныеНастройкиКолонтитулов = Ложь;

·        С помощью события модуля отчета ПриОпределенииСвойствЭлементовФормыНастроек общего модуля ОтчетыСервер можно переопределить внешний вид элементов шапки отчета, связанных с пользовательскими настройками:

§  Группа элементов (обычная группа);

§  Группировка группы элементов;

§  Отображение группы элементов;

§  Положение заголовка элемента;

§  Признак РастягиватьПоГоризонтали элемента;

§  Ширина элемента.

Значения по умолчанию см. в функции СвойстваГруппыЭлементовФормы общего модуля ОтчетыСервер.

Например, чтобы разместить горизонтально поля параметров Период, Имя таблицы и скрыть их заголовки:

Процедура ПриОпределенииСвойствЭлементовФормыНастроек(ТипФормы, СвойстваЭлементов, ПользовательскиеНастройки) Экспорт

  СвойстваГруппы = ОтчетыСервер.СвойстваГруппыЭлементовФормы();
  СвойстваГруппы.Группировка = ГруппировкаПодчиненныхЭлементовФормы.ГоризонтальнаяВсегда;
  СвойстваЭлементов.Группы.Вставить("ОбщиеПараметры", СвойстваГруппы);

  ОбщиеПараметры = Новый Структура("Период, ИмяТаблицы");

  Для Каждого Элемент Из ПользовательскиеНастройки Цикл
      СвойстваПоля = СвойстваЭлементов.Поля.Найти(
      Элемент.ИдентификаторПользовательскойНастройки, "ИдентификаторНастройки");
      СвойстваПоля.ИдентификаторГруппы = "ОбщиеПараметры";      СвойстваПоля.ПоложениеЗаголовка = ПоложениеЗаголовкаЭлементаФормы.Нет;
  КонецЦикла;

КонецПроцедуры

·        В некоторых случаях возникает необходимость в переформировании (замена запроса и других свойств набора данных) схемы компоновки данных (СКД)  при редактировании значения параметра пользователем. Например, при изменении типа объекта, имени объекта универсального отчета. Для того чтобы определить, что изменение параметра требует переформирования СКД (при вызове обработчика ПередЗагрузкойВариантаНаСервере), добавлено свойство настроек отчета ЗагрузитьНастройкиПриИзмененииПараметров – массив элементов типа ЗначениеПараметраНастроекКомпоновкиДанных.

Например, в модуле объекта отчета в процедуре ОпределитьНастройкиФормы описывается следующий код:

Процедура ОпределитьНастройкиФормы(Форма, КлючВарианта, Настройки) Экспорт

     Параметры = Новый Массив;
     Параметры.Добавить(Новый ПараметрКомпоновкиДанных("ИмяТаблицыНабораДанных"));

     Настройки.ЗагрузитьНастройкиПриИзмененииПараметров = Параметры;

КонецПроцедуры

·        Для улучшения диагностики предусмотрена процедура ИнициализироватьКомпоновщикНастроек общего модуля ОтчетыСервер. С ее помощью возникающие ошибки СКД при инициализации компоновщика настроек записываются в журнал регистрации с уровнем Ошибка.

Например, вместо:

КомпоновщикНастроек.Инициализировать(Новый ИсточникДоступныхНастроекКомпоновкиДанных(Схема));

рекомендуется вызывать:

ИнициализироватьКомпоновщикНастроек(Отчет.КомпоновщикНастроек, АдресСхемы, Отчет, ВариантОтчета);

 

Версионирование объектов

·        Изменено размещение и внешний вид общей команды ИсторияИзменений. Теперь команда по умолчанию размещается не в панели навигации, а в командной панели формы.

Даты запрета изменения

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

Запрет редактирования реквизитов объектов

·        Для определения реквизитов объекта, по которым установлен запрет редактирования, в программный интерфейс общего модуля ЗапретРедактированияРеквизитовОбъектов добавлена функция БлокируемыеРеквизитыОбъекта.

Контроль ведения учета

·        Для актуализации состава проверок при изменении значений функциональных опций, различных настроек и режимов работы информационной базы программный интерфейс общего модуля КонтрольВеденияУчета расширен процедурой ОбновитьПараметрыПроверокУчета. Подробнее см. в описании к ней.

·        Состав свойств проверок ведения учета расширен свойством ПоддерживаетВыборочнуюПроверку. Оно определяет, допускается ли выполнять проверку конкретных указанных объектов. Подробнее см. в комментарии к процедуре ПриОпределенииПроверок общего модуля КонтрольВеденияУчетаПереопределяемый.

o   В процедуре ВыполнитьПроверку общего модуля КонтрольВеденияУчета добавлен необязательный параметр ПроверяемыеОбъекты для вызова «точечной» проверки только определенных объектов.

·        Для получения информации о наличии и количестве ошибок по всем проверкам в процедуре СводнаяИнформацияПоВидамПроверок общего модуля КонтрольВеденияУчета первый параметр ВидПроверок сделан необязательным.

Настройка порядка элементов

·        Для установки значения реквизита упорядочивания добавлена процедура УстановитьЗначениеРеквизитаУпорядочивания в общем модуле НастройкаПорядкаЭлементов. Вызов этой процедуры может понадобиться в сценариях, в которых объект с упорядочиванием записывается в режиме ОбменДанными.Загрузка = Истина и штатная подписка на событие ПередЗаписью не срабатывает.

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

·        Для принудительного обновления времени напоминаний, привязанных ко времени в предметах предусмотрена процедура ОбновитьНапоминанияПоПредметам в общем модуле НапоминанияПользователя. Принудительное обновление может понадобиться в сценариях, в которых предметы записываются в режиме ОбменДанными.Загрузка = Истина и штатная подписка на событие ПриЗаписи не срабатывает.

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

·        Упрощена и унифицирована разработка начального заполнения данных при первом запуске информационной базы. Как правило, такая необходимость возникает для предопределенных элементов,  формирования классификаторов, предварительного создания элементов различных справочников, содержащих типовые операции.  Теперь для этого необходимо:

o   В процедуре ПриОпределенииНастроек  общего модуля ОбновлениеИнформационнойБазыПереопределяемый определить список объектов метаданных, для которых требуется начальным заполнением данных. Например:

 

Параметры.ОбъектыСНачальнымЗаполнением.Добавить(Метаданные.Справочники.РассылкиОтчетов);

 

o   В модуле менеджере объекта добавить процедуры-обработчики ПриНастройкеНачальногоЗаполненияЭлементов, ПриНачальномЗаполненииЭлементов, ПриНачальномЗаполненииЭлемента и реализовать в них код заполнения. Например,

 

Процедура ПриНастройкеНачальногоЗаполненияЭлементов(Настройки) Экспорт

Настройки.ПриНачальномЗаполненииЭлемента = Ложь;

КонецПроцедуры

 

Процедура ПриНачальномЗаполненииЭлементов(КодыЯзыков, Элементы) Экспорт

Элемент = Элементы.Добавить();

Элемент.ИмяПредопределенныхДанных = "ЛичныеРассылки";

Элемент.Наименование              = НСтр("ru='Личные рассылки'", ОбщегоНазначения.КодЯзыкаИнформационнойБазы());

КонецПроцедуры

 

Процедура ПриНачальномЗаполненииЭлемента(Объект, Данные, ДополнительныеПараметры) Экспорт

КонецПроцедуры                  

 

o   Пример реализации см. в справочнике РолиИсполнителей демонстрационной конфигурации.

o   Для автоматической генерации кода заполнения данных предусмотрен инструмент Начальное заполнение данных, входящий в состав дистрибутива библиотеки в виде внешней обработки.

·        Программный интерфейс общего модуля ОбновлениеИнформационнойБазы расширен процедурами и функциями:

o   КоличествоПотоковОбновления;

o   ОтложенноеОбновлениеЗавершено;

o   ПриоритетОтложеннойОбработки;

o   РазрешеноМногопоточноеОбновление;

o   УстановитьКоличествоПотоковОбновления;

o   УстановитьПриоритетОтложеннойОбработки.

Подробности см. в описании к ним.

Обновление конфигурации

·        Для проверки возможности установки обновлений добавлена функция ПоддерживаетсяУстановкаОбновлений в общий модуль ОбновлениеКонфигурацииКлиент.

Печать

·        Для переопределения заголовка формы ПечатьДокументов расширен программный интерфейс:

o   процедуры ПриПечати общего модуля УправлениеПечатьюПереопределяемый и процедуры Печать модуля менеджера объектов;

o   процедуры ПечатьДокументов общего модуля УправлениеПечатьюКлиент.

·        Для использования в процедуре ПечатьДокументов предусмотрен конструктор параметра ДополнительныеПараметры в виде функции ПараметрыПечати в модуле УправлениеПечатьюКлиент.

Подробности см. в описании этих процедур.

·        Для пакетного формирования нескольких печатных форм объекта расширен программный интерфейс функции НапечатальВФайл общего модуля УправлениеПечатью – добавлена возможность указания сразу нескольких команд печати.

·        Для переопределения режима работы механизма размещения подписей и печатей в печатных формах расширен программный интерфейс модуля УправлениеПечатьюПереопределяемый процедурой ПриОпределенииНастроекПечати. Новые возможности:

o   отключать автоматическую вставку печатей и подписей в печатных формах,

o   при отключении флажка Подпись и печать на форме Печать документов удалять картинки подписей и печатей для того, чтобы эти картинки не мешали редактировать печатную форму.

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

·        Для выполнения подключаемой команды для указанных ссылок на объекты расширен программный интерфейс процедуры ВыполнитьКоманду общего модуля ПодключаемыеКомандыКлиент.

·        Список видов поставляемых команд расширен командами создания на основании. Инструкцию по подключению см. в документации. В дополнение к имеющимся возможностям стандартных команд ввода на основании подключаемые команды предоставляют следующие возможности:

o   подменю "Создать на основании" отображается в виде картинки, занимает меньше места, оставляя его для других важных команд;

o   в конфигураторе не требуется настройка флажков видимости и настройка порядка команд в форме;

o   есть возможность управления составом, порядком и представлением команд со стороны объекта-основания;

o   есть возможность динамического изменения состава команд в подменю в зависимости от выделенных элементов в списке и в зависимости от значений реквизитов объекта;

o   есть возможность группировки команд внутри подменю;

o   есть возможность использовать горячие клавиши и устанавливать картинки команд ввода на основании.

·        Подробнее см. в документации к библиотеке и в описании программного интерфейса модулей СозданиеНаОсновании и СозданиеНаОснованииПереопределяемый.

·        Для расстановки фрагментов кода команд ввода на основании можно воспользоваться обработкой ПереходНаВерсию312, входящей в состав дистрибутива.

·        В состав подсистемы перенесены объекты подсистемы Заполнение объектов.

·        Редко используемые команды в формах, такие как просмотр отчета Движения документа, можно скрыть из командной панели, отображать только в меню Еще. Для управления этой возможностью добавлено свойство команды ТолькоВоВсехДействиях. См. ПодключаемыеКомандыПереопределяемый. ПриОпределенииКомандПодключенныхКОбъекту.

Поиск и удаление дублей

·        Для программного определения прикладных правил поиска дублей для произвольных объектов конфигурации в переопределяемом модуле ПоискИУдалениеДублейПереопределяемый  предусмотрены процедуры:

o   ПриОпределенииВозможностиЗаменыЭлементов,

o   ПриОпределенииПараметровПоискаДублей,

o   ПриПоискеДублей,

o   которые полностью соответствуют аналогичным обработчикам модуля менеджера объекта ВозможностьЗаменыЭлементов, ПараметрыПоискаДублей, ПриПоискеДублей. Подробнее см. в комментариях к ним.

·        Состав параметра ПараметрыПоиска процедуры-обработчика  ПараметрыПоискаДублей модуля менеджера расширен новым свойством СравнениеСтрокНаПодобие для управления нечетким поиском строк при поиске подобных строк. Для разных объектов конфигурации возможно задавать разные значения параметров ПроцентСовпаденияСтрок, ПроцентСовпаденияНебольшихСтрок, ДлинаНебольшихСтрок, а также СловаИсключения. В последнем параметре указывается список слов, которые следует пропускать при сравнении на подобие. Например, для организаций и контрагентов это могут быть: ИП, ГУП, ООО, ОАО и т.д. В таком случае, наименования "Ромашка" и "ООО Ромашка" будут считаться дублями.

Пользователи

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

Работа с почтовыми сообщениями

·        Для оптимизации пакетной отправки нескольких писем добавлена функция ОтправитьПисьма в модуле РаботаСПочтовымиСообщениями.

·        Для упрощения программного интерфейса на замену функции ОтправитьПочтовоеСообщение предусмотрена функция ОтправитьПисьмо.

·        Новая роль ЧтениеУчетныхЗаписейЭлектроннойПочты может использоваться вместо имеющейся роли ДобавлениеИзменениеУчетныхЗаписейЭлектроннойПочты в случае, когда требуется ограничить пользователям добавление персональных учетных записей электронной почты.

Работа с файлами

·        В процедуре СохранитьФайлКак общего модуля РаботаСФайламиКлиент предусмотрен необязательный параметр ОбработчикЗавершения, с помощью которого можно получить имя файла после сохранения его на диск.

·        Для программного копирования присоединенных файлов между однотипными владельцами в общем модуле РаботаСФайлами размещена процедура СкопироватьПрисоединенныеФайлы.

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

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

·        Для программного добавления сертификата электронной подписи в справочник СертификатыКлючейЭлектроннойПодписиИШифрования в общий модуль ЭлектроннаяПодписьКлиент добавлена процедура ЗаписатьСертификатВСправочник. Для инициализации параметра ДополнительныеПараметры этой процедуры предусмотрена функция ПараметрыЗаписиСертификата, расположенная в этом же общем модуле.

·        Для программной обработки и диагностики ошибок, возникающих в процессе работы с электронной подписью, расширен программный интерфейс общего модуля ЭлектроннаяПодписьКлиент:

o   в параметр ДополнительныеПараметры (тип Структура) процедуры ПроверитьСертификатСправочника включены новые свойства КонтекстОперации и НеПоказыватьРезультаты. Подробнее см. комментарий к процедуре;

o   возвращаемое значение Результат (тип Структура) процедуры ПроверитьСертификатСправочника расширено свойствами, содержащими сообщения об ошибках для каждой выполненной проверки. Подробнее см. комментарий к процедуре;

o   в процедуру ПроверитьПодпись добавлен необязательный параметр ПоказатьОшибку;

o   состав свойств параметра ОписаниеДанных (тип Структура) процедур Подписать, Зашифровать и Расшифровать расширен новым свойством ПрекратитьВыполнение. Подробнее см. комментарий к процедурам;

o   в возвращаемое значение (тип Структура) процедур Подписать, Зашифровать и Расшифровать добавлено новое свойство Отказ. Подробнее см. комментарий к процедурам.

Переход на версию 3.1.2 с версии 3.1.1

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

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

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

·         имена и состав параметров экспортных процедур и функций общих модулей, модулей объектов, менеджеров, наборов записей и т.п., которые размещены в области ПрограммныйИнтерфейс;

·         имена и состав параметров всех экспортных процедур и функций переопределяемых общих модулей;

·         имена объектов метаданных (включая их реквизиты, табличные части и пр.), к которым допускается непосредственное обращение из прикладного кода или из запросов.

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

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

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

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

·        Константы ДополнительныйЯзык1, ДополнительныйЯзык2, ИспользоватьДополнительныйЯзык1, ИспользоватьДополнительныйЯзык2 и ОсновнойЯзык рекомендуется включать в планы обмена распределенной информационной базы (РИБ).

Версионирование объектов

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

&НаСервере

Процедура ПриСозданииНаСервере(Отказ, СтандартнаяОбработка)

     // СтандартныеПодсистемы.ВерсионированиеОбъектов

     ВерсионированиеОбъектов.ПриСозданииНаСервере(ЭтотОбъект);

     // Конец СтандартныеПодсистемы.ВерсионированиеОбъектов

КонецПроцедуры

Графики работы

·        Тип реквизита ВладелецГрафика в справочнике Календари был изменен на определяемый тип ВладелецГрафикаРаботы. Типы справочников, используемых в качестве владельца графика, необходимо перечислить в определяемом типе ВладелецГрафикаРаботы.

Календарные графики

·        В общем модуле КалендарныеГрафикиПереопределяемый добавлен метод ПриЗаполненииИзменяемыхОбъектовЗависимыхОтПроизводственныхКалендарей. В том случае, если в обработчике ПриОбновленииДанныхЗависимыхОтПроизводственныхКалендарей обрабатываются какие-то объекты, зависимые от производственных календарей, следует перечислить имена метаданных этих объектов.

Контроль ведения учета

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

Работа с файлами

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

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

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

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

·        Процедура УстановитьОтображениеЗаголовковГрупп общего модуля СтандартныеПодсистемыСервер отмечена как устаревшая и оставлена для обратной совместимости. Рекомендуется удалить ее вызовы.

·        Для повышения надежности клиентского и серверного кода

o   вместо функции СтрокаЛатиницей общего модуля СтроковыеФункцииКлиентСервер следует использовать одноименные функции модулей СтроковыеФункции или СтроковыеФункцииКлиент;

o   вместо функции ФорматированнаяСтрока общего модуля СтроковыеФункцииКлиентСервер следует использовать одноименные функции модулей СтроковыеФункции или СтроковыеФункцииКлиент;

o   Рекомендуется произвести соответствующие замены в местах использования.

·        Для упрощения вызова функции ЗаменитьСсылки общего модуля ОбщегоНазначения для параметра ПараметрыЗамены (тип Структура) предусмотрена функция-конструктор ПараметрыЗаменыСсылок в этом же модуле. Для усиления контроля типизации, в частности, при появлении новых обязательных свойств данной структуры, рекомендуется провести замену всех мест «ручной» инициализации структуры на вызов функции-конструктора.

·        Для упрощения разработки прикладных решений с несколькими языками интерфейса изменено поведение функции КодОсновногоЯзыка общего модуля ОбщегоНазначения. Теперь функция возвращает код основного языка конфигурации или языка, явно заданного администратором при первом запуске программы.

Бизнес-процессы и задачи

·        В целях унификации начального заполнения ролей исполнителей и объектов адресации задач программный интерфейс  общего модуля БизнесПроцессыИЗадачиПереопределяемый расширен процедурами: ПриНачальномЗаполненииРолейИсполнителей, ПриНачальномЗаполненииРолиИсполнителя для заполнения ролей исполнителей, ПриНачальномЗаполненииОбъектовАдресацииЗадач, ПриНачальномЗаполненииЭлементаОбъектаАдресацииЗадачи  для заполнения объектов адресации задач, следует перенести код заполнения элементов из обработчиков начального заполнения в эти процедуры.

Версионирование объектов

·        Процедура ОбновитьНастройкиВерсионированияОбъектов общего модуля ВерсионированиеОбъектов удалена как невостребованная.

Контактная информация

·        Для исключения избыточных серверных экспортных процедур в модулях форм изменен порядок встраивания подсистемы (подробнее см. документацию). Его следует применять для новых форм, а перевстраивание в  существующие формы не обязательно. Новые вставки кода задействуют процедуры НачатьИзменение, НачатьВыбор, НачатьОчистку, НачатьОбработкуНавигационнойСсылки и НачатьВыполнениеКоманды общего модуля ПодключаемыеКомандыКлиент вместо аналогичных ПриИзменении, НачалоВыбора, Очистка, ОбработкаНавигационнойСсылки, ВыполнитьКоманду и выглядят следующим образом.

·         Было:

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияПриИзменении(Элемент)

     УправлениеКонтактнойИнформациейКлиент.ПриИзменении(ЭтотОбъект, Элемент);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)

     УправлениеКонтактнойИнформациейКлиент.НачалоВыбора(ЭтотОбъект, Элемент, , СтандартнаяОбработка);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияПриНажатии(Элемент, СтандартнаяОбработка)

     УправлениеКонтактнойИнформациейКлиент.НачалоВыбора(ЭтотОбъект, Элемент, , СтандартнаяОбработка);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияОчистка(Элемент, СтандартнаяОбработка)

     УправлениеКонтактнойИнформациейКлиент.Очистка(ЭтотОбъект, Элемент.Имя);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияВыполнитьКоманду(Команда)

     УправлениеКонтактнойИнформациейКлиент.ВыполнитьКоманду(ЭтотОбъект, Команда.Имя);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияАвтоПодбор(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка)

    

     УправлениеКонтактнойИнформациейКлиент.АвтоПодборАдреса(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка);

    

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияОбработкаВыбора(Элемент, ВыбранноеЗначение, СтандартнаяОбработка)

    

     УправлениеКонтактнойИнформациейКлиент.ОбработкаВыбора(ЭтотОбъект, ВыбранноеЗначение, Элемент.Имя, СтандартнаяОбработка);

    

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияОбработкаНавигационнойСсылки(Элемент, НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)

УправлениеКонтактнойИнформациейКлиент.ОбработкаНавигационнойСсылки(ЭтотОбъект, Элемент, НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка);

КонецПроцедуры

 

&НаСервере

Процедура Подключаемый_ОбновитьКонтактнуюИнформацию(Результат) Экспорт

   УправлениеКонтактнойИнформацией.ОбновитьКонтактнуюИнформацию(ЭтотОбъект, Объект, Результат);

КонецПроцедуры

·         Стало:

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияПриИзменении(Элемент)

     УправлениеКонтактнойИнформациейКлиент.НачатьИзменение(ЭтотОбъект, Элемент);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияНачалоВыбора(Элемент, ДанныеВыбора, СтандартнаяОбработка)

     УправлениеКонтактнойИнформациейКлиент.НачатьВыбор(ЭтотОбъект, Элемент, , СтандартнаяОбработка);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияПриНажатии(Элемент, СтандартнаяОбработка)

     УправлениеКонтактнойИнформациейКлиент.НачатьВыбор(ЭтотОбъект, Элемент, , СтандартнаяОбработка);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияОчистка(Элемент, СтандартнаяОбработка)

     УправлениеКонтактнойИнформациейКлиент.НачатьОчистку(ЭтотОбъект, Элемент.Имя);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияВыполнитьКоманду(Команда)

     УправлениеКонтактнойИнформациейКлиент.ВыполнитьКоманду(ЭтотОбъект, Команда.Имя);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияАвтоПодбор(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка)

    

     УправлениеКонтактнойИнформациейКлиент.АвтоПодборАдреса(Элемент, Текст, ДанныеВыбора, ПараметрыПолученияДанных, Ожидание, СтандартнаяОбработка);

    

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияОбработкаВыбора(Элемент, ВыбранноеЗначение, СтандартнаяОбработка)

    

     УправлениеКонтактнойИнформациейКлиент.ОбработкаВыбора(ЭтотОбъект, ВыбранноеЗначение, Элемент.Имя, СтандартнаяОбработка);

    

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_КонтактнаяИнформацияОбработкаНавигационнойСсылки(Элемент, НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка)

УправлениеКонтактнойИнформациейКлиент.ОбработкаНавигационнойСсылки(ЭтотОбъект, Элемент, НавигационнаяСсылкаФорматированнойСтроки, СтандартнаяОбработка);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_ПродолжитьОбновлениеКонтактнойИнформации(Результат, ДополнительныеПараметры) Экспорт

     ОбновитьКонтактнуюИнформацию(Результат);

КонецПроцедуры

 

&НаСервере

Процедура ОбновитьКонтактнуюИнформацию(Результат)

   УправлениеКонтактнойИнформацией.ОбновитьКонтактнуюИнформацию(ЭтотОбъект, Объект, Результат);

КонецПроцедуры

·         В справочнике ВидыКонактнойИнформации реквизит РедактированиеТолькоВДиалоге (Булево) отмечен как устаревший, вместо него используется реквизит ВидРедактирования (Строка). Поэтому для планов обмена по правилам конвертации с версиями БСП 3.1.1 и ниже следует предусмотреть преобразование значений из одного реквизита в другой. Пример см. в демонстрационной конфигурации в макетах плана обмена _ДемоОбменСБиблиотекойСтандартныхПодсистем225.

Контроль ведения учета

·        Во всех модулях форм объектов, к которым подключена подсистема, рекомендуется реализовать обработчик события ПослеЗаписиОбъекта для оперативной перепроверки объекта после записи формы. Для этого в обработчике события ПослеЗаписиНаСервере вставить вызов процедуры:

КонтрольВеденияУчета.ПослеЗаписиНаСервере(ТекущийОбъект);

Настройка порядка элементов

·        Процедура ЗаполнитьЗначениеРеквизитаУпорядочивания общего модуля НастройкаПорядкаЭлементов исключена из программного интерфейса, вместо нее следует использовать процедуру УстановитьЗначениеРеквизитаУпорядочивания в этом же модуле. Рекомендуется произвести соответствующие замены в местах использования.

Настройки программы

·        Рекомендуется перенести в конфигурацию код модулей форм всех панелей администрирования, объединив его с собственными изменениями этих форм.

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

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

·         Было:

&НаКлиенте

Процедура Подключаемый_ВыполнитьКоманду(Команда)

     ПодключаемыеКомандыКлиент.ВыполнитьКоманду(ЭтотОбъект, Команда, Объект);

КонецПроцедуры

 

&НаСервере

Процедура Подключаемый_ВыполнитьКомандуНаСервере(Контекст, Результат) Экспорт

     ПодключаемыеКоманды.ВыполнитьКоманду(ЭтотОбъект, Контекст, Объект, Результат);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_ОбновитьКоманды()

     ПодключаемыеКомандыКлиентСервер.ОбновитьКоманды(ЭтотОбъект, Объект);

КонецПроцедуры

·         Стало:

&НаКлиенте

Процедура Подключаемый_ВыполнитьКоманду(Команда)

     ПодключаемыеКомандыКлиент.НачатьВыполнениеКоманды(ЭтотОбъект, Команда, Объект);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_ПродолжитьВыполнениеКомандыНаСервере(ПараметрыВыполнения, ДополнительныеПараметры) Экспорт

     ВыполнитьКомандуНаСервере(ПараметрыВыполнения);

КонецПроцедуры

 

&НаСервере

Процедура ВыполнитьКомандуНаСервере(ПараметрыВыполнения)

     ПодключаемыеКоманды.ВыполнитьКоманду(ЭтотОбъект, ПараметрыВыполнения, Объект);

КонецПроцедуры

 

&НаКлиенте

Процедура Подключаемый_ОбновитьКоманды()

     ПодключаемыеКомандыКлиентСервер.ОбновитьКоманды(ЭтотОбъект, Объект);

КонецПроцедуры

Работа с почтовыми сообщениями

·        Функция ОтправитьПочтовоеСообщение отмечена как устаревшая, вместо нее следует использовать функции ОтправитьПисьмо, если выполняется отправка одного письма, и ОтправитьПисьма, если функция ОтправитьПочтовоеСообщение вызывалась в цикле. Для упрощения перехода на новые функции предусмотрена вспомогательная функция ПодготовитьПисьмо, параметры которой повторяют параметры функции ОтправитьПочтовоеСообщение в части подготовки письма. Рекомендуется произвести соответствующие замены.

Работа с файлами

·        Для поддержки работы толстого клиента управляемого приложения в режиме клиент-сервер процедура ОпределитьФормуПрисоединенногоФайла общего модуля РаботаСФайлами отмечена как устаревшая, вместо нее рекомендуется использовать одноименную процедуру общего модуля РаботаСФайламиКлиентСервер. Рекомендуется пересмотреть места использования этой процедуры.

·        Для упрощения вызова функции ДобавитьФайл общего модуля РаботаСФайлами для параметра ПараметрыФайла (тип Структура) предусмотрена функция-конструктор ПараметрыДобавленияФайла в этом же модуле. Для усиления контроля типизации, в частности, при появлении новых обязательных свойств данной структуры, рекомендуется провести замену всех мест «ручной» инициализации структуры на вызов функции-конструктора.

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

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

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

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

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

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

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

·         выполнить в конфигураторе сравнение/объединение с файлов поставки последней версии библиотеки (на которую выполняется переход);

·         и затем последовательно выполнить инструкции из всех разделов Переход с предыдущих версий для каждой пропущенной версии.


Версия 3.1.1

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

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

В состав библиотеки включена новая подсистема ИнтерфейсOData. Она позволяет настроить автоматический REST-сервис, с помощью которого сторонние приложения могут читать и изменять данные в информационной базе. Подробнее см. документацию. Для настройки сервиса можно воспользоваться командой в разделе Администрирование – Настройка синхронизации – Настройки стандартного интерфейса OData.

Банки

·        Загрузка классификатора банков выполняется через единый механизм загрузки классификаторов – через Интернет-поддержку (раздел АдминистрированиеИнтернет-поддержка и сервисыКлассификаторы и курсы валют Обновление классификаторов).

·        Предоставляется возможность скачивания файла обновления классификаторов с портала 1C:Обновление программ (https://releases.1c.ru/) и загрузки на другом компьютере, не имеющего доступа в Интернет.

·        Для администраторов:

o   вместо регламентного задания Загрузка классификатора банков предусмотрено регламентное задание Обновление классификаторов

o   для загрузки классификатора вручную предусмотрена отдельная роль – Получение обновлений классификаторов.

Валюты

·        Предусмотрено оперативное обновление классификатора валют через Интернет. Возможность предоставляется при наличии подключения к Интернет-поддержке (раздел АдминистрированиеИнтернет-поддержка и сервисыКлассификаторы и курсы валют Обновление классификаторов).

·        Предоставляется возможность скачивания файла обновления классификаторов с портала 1C:Обновление программ (https://releases.1c.ru/) и загрузки на другом компьютере, не имеющего доступа в Интернет.

Контактная информация

·        Предусмотрено оперативное обновление классификатора стран мира через Интернет. Возможность предоставляется при наличии подключения к Интернет-поддержке (раздел АдминистрированиеИнтернет-поддержка и сервисыКлассификаторы и курсы валют Обновление классификаторов).

·        Предоставляется возможность скачивания файла обновления классификаторов с портала 1C:Обновление программ (https://releases.1c.ru/) и загрузки на другом компьютере, не имеющего доступа в Интернет.

·        Если у международного адреса включен флажок Включать страну в представление (раздел АдминистрированиеОбщие настройкиВиды контактной информации), то в международный адрес автоматически включается наименование страны на английском языке. Для этого в карточке страны (раздел СправочникиСтраны мира) предусмотрено поле для ввода международного наименования. Например, для России следует ввести Russia.

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

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

·        В платформе 1С:Предприятие версии 8.3.13  появилась возможность проверять на клиенте некоторые свойства загружаемых файлов до их помещения на сервер. С целью поддержки новых возможностей для процедур ЗагрузитьФайл и ЗагрузитьФайлы общего модуля ФайловаяСистемаКлиент в состав свойств параметра ПараметрыЗагрузки добавлено свойство ДействиеПередНачаломПомещенияФайлов.

·        В связи с появлением объекта ОписаниеПереданногоФайла в платформе 1С:Предприятие версии 8.3.13 в состав значения, возвращаемого асинхронной процедурой ФайловаяСистемаКлиент.ЗагрузитьФайлы, добавлены свойства ПолноеИмя и ИмяФайла.

·        Для упрощения обработки ошибок при получении идентификаторов объектов метаданных по полному имени (когда полное имя может быть некорректным, например, получено из внешних источников), в функции ИдентификаторОбъектаМетаданных и ИдентификаторыОбъектовМетаданных общего модуля ОбщегоНазначения добавлен необязательный параметр ВызыватьИсключение (значение по умолчанию Истина).

·        Функция СтрокаВДату программного интерфейса общего модуля СтроковыеФункцииКлиентСервер для преобразования дат со временем теперь поддерживает распознавание времени. Для этого добавлен второй необязательный параметр ЧастьДаты, который определяет возвращаемый вариант даты: дата, время, дата и время. По умолчанию, если этот параметр не задан, будет возвращена только дата.

·        Для упрощения локализации и наглядного создания форматированных строк в программный интерфейс общих модулей СтроковыеФункции и СтроковыеФункцииКлиент добавлена функция ФорматированнаяСтрока. Оформление текста выполняется HTML  подобным языком разметки и позволяет менять цвет, шрифт, выводить картинки и создавать гиперссылки. Например, "Цена <span style='color: ПоясняющийТекст '>некорректная</span>". Подробнее см. комментарий к функции.

Взаимодействия

·        Для передачи параметров в процедуру ОткрытьФормуОтправкиSMS общего модуля ВзаимодействияКлиент предусмотрена функция-конструктор ПараметрыФормыОтправкиSMS в этом же модуле.

Работа с почтовыми сообщениями

·        Для фильтрации небезопасного содержимого письма, в частности, скриптов и картинок, загружаемых из Интернета, предусмотрена процедура ОтключитьНебезопасноеСодержимое в общем модуле РаботаСПочтовымиСообщениями.

o   Для обнаружения картинок письма, загружаемых из Интернета, предусмотрена функция ЕстьВнешниеРесурсы в общем модуле РаботаСПочтовымиСообщениями.

Шаблоны сообщений

·        Для отправки письма, сформированного по шаблону, от произвольной учетной записи электронной почты в функции СформироватьСообщениеИОтправить программного интерфейса общего модуля ШаблоныСообщений в четвертом параметре ДополнительныеПараметры предусмотрено свойство УчетнаяЗапись.

Переход на версию 3.1.1 с версии 3.0.3

Версия 3.1.1 предназначена для разработки на платформе 1С:Предприятие версии 8.3.14 и выше с отключенным режимом совместимости с версией 8.3.14. Поэтому предварительно необходимо адаптировать конфигурацию согласно списку изменений и порядку обновления технологической платформы версий 8.3.13 и 8.3.14. Минимальные требования к адаптации описаны в методике перевода конфигураций на платформу 1С:Предприятие 8.3.

В данной версии удалены объекты метаданных, которые были отмечены устаревшими более двух лет назад (в версии 2.3.3 и раньше), а также программный интерфейс, отмеченный устаревшим до версии 2.4.2.

Если ранее в конфигурации нерегулярно выполнялся переход с устаревшего программного интерфейса на актуальный, то перед обновлением следует найти и заменить все вызовы, указанные ниже в разделе Обязательные действия по переходу. Замены следует выполнять согласно инструкциям в документирующих комментариях к устаревшим процедурам и функциям. Для быстрого выявления нерекомендуемых вызовов устаревшего программного интерфейса также рекомендуется воспользоваться инструментом 1С:Автоматизированная проверка конфигурации (https://v8.1c.ru/acc/).

Порядок обновления конфигураций, включающих 1C:Библиотека технологии сервиса

Если в конфигурации используется 1С:Библиотека стандартных подсистем (БСП) совместно с 1C:Библиотека технологии сервиса (БТС), то порядок перехода следующий: для перехода на версию 3.1.1 необходимо также взять БТС версии 1.2 и в конфигураторе выполнить 5 шагов.

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

В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, снять флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК.

В окне сравнения и объединения конфигураций снять все флажки и отметить переносимые объекты с помощью команды Действия – Отметить по подсистемам новой конфигурации поставщика. Из группы «Стандартные подсистемы» выбрать:

·         обязательные подсистемы согласно таблице 2.1 документации;

·         дополнительные подсистемы, обязательные к переносу в конфигурацию для работы в модели сервиса, согласно таблице 2.2 документации;

·         все ранее внедренные подсистемы, а также подсистемы, которые дополнительно требуется внедрить в вашу конфигурацию;

·         подсистемы, от которых зависят отмеченные выше подсистемы, согласно таблицам 2.1–2.3 документации (https://its.1c.ru/db/bspdoc).

Далее нажать кнопку Установить.

Важно!

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

Если подсистема Администрирование была внедрена ранее или планируется ее внедрение, то отметить ее флажком в окне сравнения и объединения конфигураций (объект метаданных «подсистема»).

Выбрать режим объединения Взять из новой конфигурации поставщика (Действия – Установить режим для всех…).

Дополнительно нужно установить или снять флажки для отдельных объектов библиотеки и их свойств согласно инструкциям в таблице 2.6 документации. В зависимости от числа обновляемых и дополнительно устанавливаемых подсистем этот шаг может занять от 15 минут до одного часа.

2. Выполнить команду Конфигурация – Поддержка – Обновить конфигурацию, указав в варианте Выбор файла обновления путь к файлу поставки БТС.

В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, снять флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК.

В окне сравнения и объединения конфигураций снять все флажки и с помощью команды Действия – Отметить по подсистемам новой конфигурации поставщика отметить все объекты подсистемы ТехнологияСервиса.

Далее нажать кнопку Установить.

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

В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, установить флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК.

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

Далее нажать кнопку Выполнить.

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

В открывшемся окне сравнения и объединения конфигураций перейти к параметрам с помощью команды Действия – Параметры, установить флажок Разрешить удаление основной конфигурации и нажать на кнопку ОК.

В окне сравнения и объединения конфигураций снять все флажки и отметить подсистему ТехнологияСервиса.

Далее нажать кнопку Выполнить.

5. В дереве конфигурации выполнить команду По подсистемам. В открывшемся окне Отбор по подсистемам снять все флажки в дереве подсистем, установить флажок напротив значения <Не входящие в подсистемы> и нажать кнопку Установить.

Удалить из конфигурации все объекты метаданных, которые не входят ни в одну подсистему и не стоят на поддержке ни одной из библиотек.

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

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

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

·         имена и состав параметров экспортных процедур и функций общих модулей, модулей объектов, менеджеров, наборов записей и т.п., которые размещены в области ПрограммныйИнтерфейс;

·         имена и состав параметров всех экспортных процедур и функций переопределяемых общих модулей;

·         имена объектов метаданных (включая их реквизиты, табличные части и пр.), к которым допускается непосредственное обращение из прикладного кода или из запросов.

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

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

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

Адресный классификатор

·        Удален устаревший программный интерфейс общих модулей:

o   АдресныйКлассификатор:

§  КлассификаторЗагружен.

o   АдресныйКлассификаторКлиент:

§  ОткрытьФормуПроверкиОбновления;

§  ОткрытьФормуЗагрузкиАдресногоКлассификатора.

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

·        Удален устаревший программный интерфейс общих модулей:

o   ОбщегоНазначения:

§  ПолучитьКартинкуКомментария;

§  ЗаполнитьМассивУникальнымиЗначениями;

§  Просклонять;

§  WSПрокси;

§  ПолучитьТаблицуОписанияСвойствОбъекта;

§  ПолучитьОбщийСписокИсключенийПоискаСсылок;

§  СкопироватьXDTO;

§  ПредставлениеТипаXDTO;

§  ХранилищеОбщихНастроекСохранитьМассивИОбновитьПовторноИспользуемыеЗначения;

§  ХранилищеОбщихНастроекСохранитьИОбновитьПовторноИспользуемыеЗначения;

§  ЗаблокироватьИБ;

§  РазблокироватьИБ;

§  ИмяТипаРегистрыСведений;

§  ИмяТипаРегистрыНакопления;

§  ИмяТипаРегистрыБухгалтерии;

§  ИмяТипаРегистрыРасчета;

§  ИмяТипаДокументы;

§  ИмяТипаСправочники;

§  ИмяТипаПеречисления;

§  ИмяТипаОтчеты;

§  ИмяТипаОбработки;

§  ИмяТипаПланыОбмена;

§  ИмяТипаПланыВидовХарактеристик;

§  ИмяТипаБизнесПроцессы;

§  ИмяТипаЗадачи;

§  ИмяТипаПланыСчетов;

§  ИмяТипаПланыВидовРасчета;

§  ИмяТипаКонстанты;

§  ИмяТипаЖурналыДокументов;

§  ИмяТипаПоследовательности;

§  ИмяТипаРегламентныеЗадания;

§  ИмяТипаПерерасчеты;

§  УстановитьРазделениеСеанса;

§  ЗначениеРазделителяСеанса;

§  УстановитьПараметрыРазделенияИнформационнойБазы;

§  ЗаписатьВспомогательныеДанные;

§  УдалитьВспомогательныеДанные;

§  ЭтоРазделенныйОбъектМетаданных.

o   ОбщегоНазначенияВызовСервера:

§  ХранилищеОбщихНастроекСохранитьМассивИОбновитьПовторноИспользуемыеЗначения;

§  ХранилищеОбщихНастроекСохранитьИОбновитьПовторноИспользуемыеЗначения;

§  УстановитьРазделениеСеанса.

o   ОбщегоНазначенияПереопределяемый:

§  ПараметрыРаботыКлиентаПриЗапуске;

§  ПараметрыРаботыКлиента.

o   ОбщегоНазначенияПовтИсп:

§  ЭтоРазделеннаяКонфигурация;

§  РазделителиКонфигурации;

§  СоставОбщегоРеквизита;

§  ЭтоРазделенныйОбъектМетаданных;

§  РазделительОсновныхДанных;

§  РазделительВспомогательныхДанных;

§  РазделениеВключено;

§  ДоступноИспользованиеРазделенныхДанных;

§  ПолучитьПреобразованиеXSLИзОбщегоМакета;

§  СеансЗапущенБезРазделителей;

§  РежимРаботыПрограммы.

o   СтандартныеПодсистемыСервер:

§  ЭтоОбъектНачальногоОбразаУзлаРИБ;

§  ПроверитьСоставПланаОбмена.

o   СтроковыеФункцииКлиентСервер:

§  СтрокаИзМассиваПодстрок;

§  НайтиСимволСКонца;

§  ПолучитьПараметрыИзСтроки.

Банки

·        Загрузка классификатора банков выполняется средствами библиотеки Интернет-поддержки пользователей (раздел АдминистрированиеИнтернет-поддержка и сервисыКлассификаторы и курсы валют Обновление классификаторов).

o   Если она отсутствует в конфигурации, рекомендуется запланировать ее внедрение.

o   Для возможности получения обновлений классификаторов предусмотрена отдельная роль – ПолучениеОбновленийКлассификаторов – в Библиотеке интернет-поддержки пользователей. Роль ДобавлениеИзменениеБанков не предоставляет доступ к обновлению классификатора банков. Необходимо учесть это изменение в имеющихся профилях групп доступа. Рекомендуется включить роль ПолучениеОбновленийКлассификаторов в профили, имеющие роль ДобавлениеИзменениеБанков.

·        Удалена устаревшая функция ПолучитьДанныеКлассификатораРФ общего модуля РаботаСБанками.

·        При наличии в конфигурации Библиотеки интернет-поддержки пользователей необходимо удалить ранее выполненные вставки кода подсистемы Банки из процедур ПриСохраненииДанныхАутентификацииПользователяИнтернетПоддержки и ПриУдаленииДанныхАутентификацииПользователяИнтернетПоддержки общего модуля ИнтернетПоддержкаПользователейПереопределяемый.

Бизнес-процессы и задачи

·        Удален устаревший программный интерфейс общего модуля БизнесПроцессыИЗадачиВызовСервера:

o   УведомитьИсполнителейОНовыхЗадачах

o   ПроконтролироватьЗадачи

Валюты

·        Удалена устаревшая функция ПересчитатьИзВалютыВВалюту общего модуля РаботаСКурсамиВалютКлиентСервер.

·        При наличии в конфигурации Библиотеки интернет-поддержки пользователей необходимо удалить ранее выполненные вставки кода подсистемы Валюты из процедур ПриСохраненииДанныхАутентификацииПользователяИнтернетПоддержки и ПриУдаленииДанныхАутентификацииПользователяИнтернетПоддержки общего модуля ИнтернетПоддержкаПользователейПереопределяемый.

Варианты отчетов

·        Удален устаревший программный интерфейс общего модуля ВариантыОтчетов:

o   ИспользуемыеРазделы

o   ДобавитьОбработчикиПолногоОбновления

o   ПолучитьСсылку

Взаимодействия

·        Удалена устаревшая процедура ОткрытьФормуОтправкиПочтовогоСообщения общего модуля ВзаимодействияКлиент.

Дополнительные отчеты и обработки

·        Удален устаревший программный интерфейс общих модулей:

o   ДополнительныеОтчетыИОбработки:

§  ПолучитьОбъектВнешнейОбработки;

§  ПриСозданииНаСервере;

§  ВыполнитьНазначаемуюКомандуНаСервере.

o   ДополнительныеОтчетыИОбработкиВызовСервера:

§  ПолучитьОбъектВнешнейОбработки.

o   ДополнительныеОтчетыИОбработкиКлиент

§  ПоказатьРезультатВыполненияКоманды;

§  ВыполнитьНазначаемуюКомандуНаКлиенте.

o   ДополнительныеОтчетыИОбработкиКлиентСервер:

§  ТипКомандыСценарийВБезопасномРежиме.

·        Удалены общие модули, содержавшие устаревший программный интерфейс:

o   ДополнительныеОтчетыИОбработкиВБезопасномРежимеИнтерфейс;

o   ДополнительныеОтчетыИОбработкиРегламентныеЗадания

Защита персональных данных

·        Удалена устаревшая функция ПолучитьИспользованиеСобытияДоступ общего модуля ЗащитаПерсональныхДанных.

Контактная информация

·        Удален устаревший программный интерфейс общего модуля УправлениеКонтактнойИнформацией:

o   ЗначенияКонтактнойИнформацииОбъекта;

o   ТаблицаКонтактнойИнформацииОбъекта;

o   ЗаполнитьКонтактнуюИнформациюОбъектов;

o   ЗаполнитьКонтактнуюИнформациюОбъекта;

o   ПредыдущийФорматКонтактнойИнформацииXML;

o   ПредыдущаяСтруктураКонтактнойИнформацииXML;

o   АдресВФорматеКЛАДР;

o   СведенияОбАдресах;

o   СведенияОбАдресе;

o   РегионАдресаКонтактнойИнформации;

o   ГородАдресаКонтактнойИнформации;

o   ПроверитьАдрес;

o   ПараметрыКонтактнойИнформацией.

·        В связи с изменением поведения платформы 1С: Предприятие версии 8.3.13 в модулях форм c внедренной контактной информацией у ранее размещенных процедур Подключаемый_ОбновитьКонтактнуюИнформацию необходимо добавить ключевое слово Экспорт

o   Было:

Процедура Подключаемый_ОбновитьКонтактнуюИнформацию(Результат)

o   Стало:

Процедура Подключаемый_ОбновитьКонтактнуюИнформацию(Результат) Экспорт

Календарные графики

·        Удален устаревший программный интерфейс общего модуля КалендарныеГрафики:

o   ПолучитьМассивДатПоКалендарю;

o   ПолучитьДатуПоКалендарю;

o   ПолучитьРазностьДатПоКалендарю;

o   ПроизводственныйКалендарьРоссийскойФедерации;

o   ПолучитьДатыРабочихДней.

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

·        Удален общий модуль НапоминанияПользователяКлиентСерверПереопределяемый, содержавший устаревший программный интерфейс.

Обмен данными в модели сервиса

·        В состав определяемого типа КонечнаяТочкаОбменаСообщениями необходимо включить план обмена ОбменСообщениями из Библиотеки технологии сервиса.

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

·        Удалена устаревшая процедура ПриОтключенииОбработчиковОбновления общего модуля ОбновлениеИнформационнойБазыПереопределяемый.

Печать

·        Удален устаревший программный интерфейс общих модулей:

o   УправлениеПечатью:

§  ПолучитьЛокальныйКаталогФайловПечати;

§  ПриСозданииНаСервере.

o   УправлениеПечатьюКлиент:

§  ВыполнитьПодключаемуюКомандуПечати;

§  НачатьОбновлениеКоманд.

o   УправлениеПечатьюКлиентСервер:

§  ОбновитьКоманды.

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

В связи с изменением поведения платформы 1C:Предприятие 8.3.13, у ранее размещенных в модулях форм процедур Подключаемый_ВыполнитьКомандуНаСервере необходимо добавить ключевое слово Экспорт

·         Было:

Процедура Подключаемый_ВыполнитьКомандуНаСервере(Контекст, Результат)

·         Стало:

Процедура Подключаемый_ВыполнитьКомандуНаСервере(Контекст, Результат) Экспорт

Пользователи

·        Удален устаревший программный интерфейс общего модуля Пользователи:

o   ПрочитатьПользователяИБ;

o   ЗаписатьПользователяИБ;

o   РольАдминистратораСистемы.

Префиксация объектов

·        Удален устаревший программный интерфейс общего модуля ПрефиксацияОбъектовКлиентСервер:

o   ПолучитьПользовательскийПрефикс;

o   ПолучитьНомерНаПечать.

Профили безопасности

·        Удален устаревший программный интерфейс общего модуля РаботаВБезопасномРежиме:

o   ВыполнитьМетодКонфигурации;

o   ВыполнитьМетодОбъекта;

o   ВыполнитьВБезопасномРежиме;

o   ВычислитьВБезопасномРежиме.

Работа с файлами

·        Удалены общие модули, содержавшие устаревший программный интерфейс:

o   ПрисоединенныеФайлы;

o   ПрисоединенныеФайлыКлиент;

o   ПрисоединенныеФайлыКлиентСервер;

o   ФайловыеФункции.

Склонение представлений объектов

·        Процедура ПриИзмененииПредставления общего модуля СклонениеПредставленийОбъектовКлиент более не поддерживается. В модулях форм объектов склонений, где она вызывается, необходимо:

o   заменить ее вызов вызовом процедуры ПросклонятьПредставление общего модуля СклонениеПредставленийОбъектовКлиент,

o   удалить процедуру Подключаемый_ПросклонятьПредставлениеПоВсемПадежам.

Физические лица

·        Удален программный интерфейс общего модуля ФизическиеЛицаКлиентСервер:

o   ФамилияИмяОтчество;

o   ФамилияИнициалыФизЛица.

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

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

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

·        Процедуры ЭтоOSXКлиент общих модулей ОбщегоНазначения и ОбщегоНазначенияКлиент устарели, вместо них рекомендуется использовать ЭтоMacOSКлиент этих же общих модулей. Рекомендуется пересмотреть места вызовов этой процедуры.

Валюты

·        Предусмотрено оперативное обновление классификатора валют через Интернет. Возможность предоставляется при наличии в конфигурации библиотеки Интернет-поддержки пользователей (раздел АдминистрированиеИнтернет-поддержка и сервисыКлассификаторы и курсы валют Обновление классификаторов). Если она отсутствует в конфигурации, рекомендуется запланировать ее внедрение.

Контактная информация

·        Предусмотрено оперативное обновление классификатора стран мира через Интернет. Возможность предоставляется при наличии в конфигурации библиотеки Интернет-поддержки пользователей (раздел АдминистрированиеИнтернет-поддержка и сервисыКлассификаторы и курсы валют Обновление классификаторов). Если она отсутствует в конфигурации, рекомендуется запланировать ее внедрение.

Настройки программы

·        Рекомендуется перенести в конфигурацию код модулей форм всех панелей администрирования, объединив его с собственными изменениями этих форм.

Склонение представлений объектов

·        Процедура ПриЗаписиНаСервере общего модуля СклонениеПредставленийОбъектов устарела, вместо нее рекомендуется использовать ПриЗаписиФормыОбъектаСклонения этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.

·        Процедура ПросклонятьФИОСПомощьюКомпоненты общего модуля СклонениеПредставленийОбъектов устарела, вместо нее рекомендуется использовать ПросклонятьФИО этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.

·        Процедура ПросклонятьПредставлениеПоВсемПадежам общего модуля СклонениеПредставленийОбъектовКлиент устарела, вместо нее рекомендуется использовать ПросклонятьПредставление этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.

·        Процедура ОбработатьКомандуСклонения общего модуля СклонениеПредставленийОбъектовКлиент устарела, вместо нее рекомендуется использовать ПоказатьСклонение этого же общего модуля. Рекомендуется пересмотреть места вызовов этой процедуры.

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

·        Упрощен программный интерфейс процедуры ПриСозданииФормыЗначенияДоступа общего модуля УправлениеДоступом.

o   Теперь вместо 5 параметров используется только 2, где второй параметр это структура, содержащая редко используемые параметры.

o   Параметры Реквизит, Элементы, ТипЗначения, СозданиеНового отмечены как устаревшие и оставлены для обратной совместимости. Вместо них следует использовать структуру ДополнительныеПараметры передаваемую вторым параметром. Следует проверить все места использования.

o   Для параметра ДополнительныеПараметры предусмотрена функция-конструктор ПараметрыПриСозданииФормыЗначенияДоступа в общем модуле УправлениеДоступом.

·        Рекомендуется добавлять в справочник ИдентификаторыОбъектовМетаданных предопределенные элементы всех регистров, чтобы при изменении ограничений доступа в модулях менеджеров не требовалось добавления предопределенных элементов при доработке конфигурации на внедрении, а также использовании расширений конфигурации.
Отчет ПроверкаВнедренияБСП.epf в режиме исправления теперь добавляет в справочник ИдентификаторыОбъектовМетаданных предопределенные элементы всех регистров. Рекомендуется выполнить запуск отчета в режиме исправления.

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

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

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

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

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

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

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

·         Улучшены стандартные шаблоны ограничения доступа к данным ДляОбъекта и ДляРегистра. Требуется взять их из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Для массового обновления удобно использовать вкладку Шаблоны ограничений в форме Все ограничения доступа (включить отбор по наименованию шаблона, выделить все строки и использовать команду Изменить). Либо использовать отчет ПроверкаВнедренияБСП.epf  в режиме исправления ошибок.

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

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

·         Для объектов метаданных, указанных в процедуре ПриЗаполненииСписковСОграничениемДоступа общего модуля УправлениеДоступомПереопределяемый, в обработчик события ПослеЗаписиНаСервере формы объекта (все формы с основным реквизитом объекта) сделать вставку:
// СтандартныеПодсистемы.УправлениеДоступом
УправлениеДоступом.ПослеЗаписиНаСервере(ЭтотОбъект, ТекущийОбъект, ПараметрыЗаписи);
// Конец СтандартныеПодсистемы.УправлениеДоступом

·         Для автоматизированного выполнения указанного выше действия следует запустить обработку ПереходНаВерсию303.epf, входящую в состав дистрибутива (запускать только на файловой ИБ).

·         Обновить стандартные шаблоны ограничения доступа к данным ДляОбъекта и ДляРегистра во всех ролях. Стандартные шаблоны взять из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Для массового обновления удобно использовать вкладку Шаблоны ограничений в форме Все ограничения доступа (включить отбор по наименованию шаблона, выделить все строки и использовать команду Изменить), либо использовать отчет ПроверкаВнедренияБСП.erf в режиме исправления ошибок.

·         Перенести изменения в коде формы НастройкиПользователейИПрав обработки ПанельАдминистрированияБСП, если используется.

·         В планы обмена РИБ включить константу ПервоеОбновлениеДоступаЗавершилось для создания начального узла.

·         В планы обмена РИБ включить константу ПервоеОбновлениеДоступаЗавершилось для создания начального узла.

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

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

·         Исправлены стандартные шаблоны ограничения доступа к данным ДляОбъекта и ДляРегистра для работы на версии платформы 8.3.15. Требуется взять их из роли ИзменениеУчастниковГруппДоступа и скопировать во все роли. Для массового обновления удобно использовать вкладку Шаблоны ограничений в форме Все ограничения доступа (включить отбор по наименованию шаблона, выделить все строки и использовать команду Изменить). Либо использовать отчет ПроверкаВнедренияБСП.epf  в режиме исправления ошибок.

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

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

·         Перенести изменения формы НастройкиПользователейИПрав обработки ПанельАдминистрированияБСП, если используется.

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

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

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

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

1)  Если релизы конфигурации публикуются на портале 1С:Обновление программ (https://releases.1c.ru), то при публикации новой версии 1.2.1 в свойстве Минимальная версия для запуска обработчиков указать тот номер версии, в которой используется БСП 2.3.3 (в данном примере – 1.1.1). Тогда при обновлении конфигурации в режиме предприятия автоматически будет выполнен требуемый обязательный запуск.

2)  Дополнительно для случаев, когда обновление выполняется через конфигуратор, в целях предотвращения некорректной ситуации также следует предусмотреть вывод предупреждения в процедуре ПриОпределенииВозможностиОбновления общего модуля ОбновлениеИнформационнойБазыКлиентПереопределяемый:

Процедура ПриОпределенииВозможностиОбновления(Знач ВерсияДанных) Экспорт

ДопустимаяВерсия = "1.1.1";

ВерсияДанныхБезНомераСборки = ОбщегоНазначенияКлиентСервер.ВерсияКонфигурацииБезНомераСборки(ВерсияДанных);

Результат = ОбщегоНазначенияКлиентСервер.СравнитьВерсииБезНомераСборки(ВерсияДанныхБезНомераСборки, ДопустимаяВерсия);

Если ВерсияДанных <> "0.0.0.0" И Результат < 0 Тогда

   Сообщение = НСтр("ru = 'Недопустимая попытка обновления с версии %2.

    |Обновление допустимо только с версии %1 и выше.

    |Необходимо восстановить информационную базу из резервной копии

    |и повторить обновление согласно файлу 1cv8upd.htm'");

   Сообщение = СтроковыеФункцииКлиентСервер.ПодставитьПараметрыВСтроку(Сообщение, ДопустимаяВерсия, ВерсияДанных);

   ВызватьИсключение Сообщение;

КонецЕсли;

КонецПроцедуры

Порядок обновления с версий 2.3.3 – 3.0.1

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

·         выполнить в конфигураторе сравнение/объединение с файлов поставки последней версии библиотеки (на которую выполняется переход);

·         и затем последовательно выполнить инструкции из всех разделов Переход с предыдущих версий для каждой пропущенной версии.

Например, если выполняется обновление с версии 3.0.1.1 сразу на версию 3.1.1.123, то следует последовательно выполнить инструкции всех разделов:

·        Переход на версию 3.0.1 с предыдущих версий 3.0.1;

·        Переход на версию 3.0.2 с версии 3.0.2;

·        Переход на версию 3.1.1 с версии 3.0.2.