161 lines
14 KiB
Plaintext
161 lines
14 KiB
Plaintext
///////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
// Copyright (c) 2019, ООО 1С-Софт
|
||
// Все права защищены. Эта программа и сопроводительные материалы предоставляются
|
||
// в соответствии с условиями лицензии Attribution 4.0 International (CC BY 4.0)
|
||
// Текст лицензии доступен по ссылке:
|
||
// https://creativecommons.org/licenses/by/4.0/legalcode
|
||
///////////////////////////////////////////////////////////////////////////////////////////////////////
|
||
|
||
#Область ПрограммныйИнтерфейс
|
||
|
||
#Область ДляВызоваИзДругихПодсистем
|
||
|
||
// СтандартныеПодсистемы.ОбновлениеВерсииИБ
|
||
|
||
////////////////////////////////////////////////////////////////////////////////
|
||
// Сведения о библиотеке (или конфигурации).
|
||
|
||
// Заполняет основные сведения о библиотеке или основной конфигурации.
|
||
// Библиотека, имя которой имя совпадает с именем конфигурации в метаданных, определяется как основная конфигурация.
|
||
//
|
||
// Параметры:
|
||
// Описание - Структура - сведения о библиотеке:
|
||
//
|
||
// * Имя - Строка - имя библиотеки, например, "СтандартныеПодсистемы".
|
||
// * Версия - Строка - версия в формате из 4-х цифр, например, "2.1.3.1".
|
||
//
|
||
// * ИдентификаторИнтернетПоддержки - Строка - уникальное имя программы в сервисах Интернет-поддержки.
|
||
// * ТребуемыеПодсистемы - Массив - имена других библиотек (Строка), от которых зависит данная библиотека.
|
||
// Обработчики обновления таких библиотек должны быть вызваны ранее
|
||
// обработчиков обновления данной библиотеки.
|
||
// При циклических зависимостях или, напротив, отсутствии каких-либо зависимостей,
|
||
// порядок вызова обработчиков обновления определяется порядком добавления модулей
|
||
// в процедуре ПриДобавленииПодсистем общего модуля
|
||
// ПодсистемыКонфигурацииПереопределяемый.
|
||
// * РежимВыполненияОтложенныхОбработчиков - Строка - "Последовательно" - отложенные обработчики обновления выполняются
|
||
// последовательно в интервале от номера версии информационной базы до номера
|
||
// версии конфигурации включительно или "Параллельно" - отложенный обработчик после
|
||
// обработки первой порции данных передает управление следующему обработчику, а после
|
||
// выполнения последнего обработчика цикл повторяется заново.
|
||
//
|
||
Процедура ПриДобавленииПодсистемы(Описание) Экспорт
|
||
|
||
Описание.Имя = "СтандартныеПодсистемы";
|
||
Описание.Версия = "3.0.3.87";
|
||
Описание.ИдентификаторИнтернетПоддержки = "SSL";
|
||
Описание.РежимВыполненияОтложенныхОбработчиков = "Параллельно";
|
||
Описание.ПараллельноеОтложенноеОбновлениеСВерсии = "2.3.3.0";
|
||
|
||
КонецПроцедуры
|
||
|
||
////////////////////////////////////////////////////////////////////////////////
|
||
// Обработчики обновления информационной базы.
|
||
|
||
// Добавляет в список процедуры-обработчики обновления данных ИБ
|
||
// для всех поддерживаемых версий библиотеки или конфигурации.
|
||
// Вызывается перед началом обновления данных ИБ для построения плана обновления.
|
||
//
|
||
// Параметры:
|
||
// Обработчики - ТаблицаЗначений - см. ОбновлениеИнформационнойБазы.НоваяТаблицаОбработчиковОбновления.
|
||
//
|
||
// Пример:
|
||
// Для добавления своей процедуры-обработчика в список:
|
||
// Обработчик = Обработчики.Добавить();
|
||
// Обработчик.Версия = "1.1.0.0";
|
||
// Обработчик.Процедура = "ОбновлениеИБ.ПерейтиНаВерсию_1_1_0_0";
|
||
// Обработчик.РежимВыполнения = "Оперативно";
|
||
//
|
||
Процедура ПриДобавленииОбработчиковОбновления(Обработчики) Экспорт
|
||
|
||
ИнтеграцияПодсистемБСП.ПриДобавленииОбработчиковОбновления(Обработчики);
|
||
|
||
КонецПроцедуры
|
||
|
||
// См. ОбновлениеИнформационнойБазыПереопределяемый.ПередОбновлениемИнформационнойБазы.
|
||
Процедура ПередОбновлениемИнформационнойБазы() Экспорт
|
||
|
||
КонецПроцедуры
|
||
|
||
// См. ОбновлениеИнформационнойБазыПереопределяемый.ПослеОбновленияИнформационнойБазы.
|
||
Процедура ПослеОбновленияИнформационнойБазы(Знач ПредыдущаяВерсия, Знач ТекущаяВерсия,
|
||
Знач ВыполненныеОбработчики, ВыводитьОписаниеОбновлений, МонопольныйРежим) Экспорт
|
||
|
||
ИнтеграцияПодсистемБСП.ПослеОбновленияИнформационнойБазы(ПредыдущаяВерсия, ТекущаяВерсия,
|
||
ВыполненныеОбработчики, ВыводитьОписаниеОбновлений, МонопольныйРежим);
|
||
|
||
КонецПроцедуры
|
||
|
||
// См. ОбновлениеИнформационнойБазыПереопределяемый.ПриПодготовкеМакетаОписанияОбновлений.
|
||
Процедура ПриПодготовкеМакетаОписанияОбновлений(Знач Макет) Экспорт
|
||
|
||
КонецПроцедуры
|
||
|
||
// Позволяет переопределить режим обновления данных информационной базы.
|
||
// Для использования в редких (нештатных) случаях перехода, не предусмотренных в
|
||
// стандартной процедуре определения режима обновления.
|
||
//
|
||
// Параметры:
|
||
// РежимОбновленияДанных - Строка - в обработчике можно присвоить одно из значений:
|
||
// "НачальноеЗаполнение" - если это первый запуск пустой базы (области данных);
|
||
// "ОбновлениеВерсии" - если выполняется первый запуск после обновление конфигурации базы данных;
|
||
// "ПереходСДругойПрограммы" - если выполняется первый запуск после обновление конфигурации базы данных,
|
||
// в которой изменилось имя основной конфигурации.
|
||
//
|
||
// СтандартнаяОбработка - Булево - если присвоить Ложь, то стандартная процедура
|
||
// определения режима обновления не выполняется,
|
||
// а используется значение РежимОбновленияДанных.
|
||
//
|
||
Процедура ПриОпределенииРежимаОбновленияДанных(РежимОбновленияДанных, СтандартнаяОбработка) Экспорт
|
||
|
||
КонецПроцедуры
|
||
|
||
// Добавляет в список процедуры-обработчики перехода с другой программы (с другим именем конфигурации).
|
||
// Например, для перехода между разными, но родственными конфигурациями: базовая -> проф -> корп.
|
||
// Вызывается перед началом обновления данных ИБ.
|
||
//
|
||
// Параметры:
|
||
// Обработчики - ТаблицаЗначений - с колонками:
|
||
// * ПредыдущееИмяКонфигурации - Строка - имя конфигурации, с которой выполняется переход;
|
||
// или "*", если нужно выполнять при переходе с любой конфигурации.
|
||
// * Процедура - Строка - полное имя процедуры-обработчика перехода с программы
|
||
// ПредыдущееИмяКонфигурации.
|
||
// Например, "ОбновлениеИнформационнойБазыУПП.ЗаполнитьУчетнуюПолитику"
|
||
// Обязательно должна быть экспортной.
|
||
//
|
||
// Пример:
|
||
// Обработчик = Обработчики.Добавить();
|
||
// Обработчик.ПредыдущееИмяКонфигурации = "УправлениеТорговлей";
|
||
// Обработчик.Процедура = "ОбновлениеИнформационнойБазыУПП.ЗаполнитьУчетнуюПолитику";
|
||
//
|
||
Процедура ПриДобавленииОбработчиковПереходаСДругойПрограммы(Обработчики) Экспорт
|
||
|
||
КонецПроцедуры
|
||
|
||
// Вызывается после выполнения всех процедур-обработчиков перехода с другой программы (с другим именем конфигурации),
|
||
// и до начала выполнения обновления данных ИБ.
|
||
//
|
||
// Параметры:
|
||
// ПредыдущееИмяКонфигурации - Строка - имя конфигурации до перехода.
|
||
// ПредыдущаяВерсияКонфигурации - Строка - имя предыдущей конфигурации (до перехода).
|
||
// Параметры - Структура -
|
||
// * ВыполнитьОбновлениеСВерсии - Булево - по умолчанию Истина. Если установить Ложь,
|
||
// то будут выполнена только обязательные обработчики обновления (с версией "*").
|
||
// * ВерсияКонфигурации - Строка - номер версии после перехода.
|
||
// По умолчанию, равен значению версии конфигурации в свойствах метаданных.
|
||
// Для того чтобы выполнить, например, все обработчики обновления с версии ПредыдущаяВерсияКонфигурации,
|
||
// следует установить значение параметра в ПредыдущаяВерсияКонфигурации.
|
||
// Для того чтобы выполнить вообще все обработчики обновления, установить значение "0.0.0.1".
|
||
// * ОчиститьСведенияОПредыдущейКонфигурации - Булево - по умолчанию Истина.
|
||
// Для случаев когда предыдущая конфигурация совпадает по имени с подсистемой текущей конфигурации, следует
|
||
// указать Ложь.
|
||
//
|
||
Процедура ПриЗавершенииПереходаСДругойПрограммы(ПредыдущееИмяКонфигурации, ПредыдущаяВерсияКонфигурации, Параметры) Экспорт
|
||
|
||
КонецПроцедуры
|
||
|
||
// Конец СтандартныеПодсистемы.ОбновлениеВерсииИБ
|
||
|
||
#КонецОбласти
|
||
|
||
#КонецОбласти
|