Обновление информационной базы БИД

ПриДобавленииПодсистемы

Описание, пример вызова

////////////////////////////////////////////////////////////////////////////////
// Сведения о библиотеке (или конфигурации).

// Заполняет основные сведения о библиотеке или основной конфигурации.
// Библиотека, имя которой имя совпадает с именем конфигурации в метаданных, определяется как основная конфигурация.
//
// Параметры:
//   Описание - Структура:
//
//     * Имя                 - Строка - имя библиотеки, например, "СтандартныеПодсистемы".
//     * Версия              - Строка - версия в формате из 4-х цифр, например, "2.1.3.1".
//
//     * ИдентификаторИнтернетПоддержки - Строка - уникальное имя программы в сервисах Интернет-поддержки.
//     * ТребуемыеПодсистемы - Массив из Строка - имена других библиотек, от которых зависит данная библиотека.
//                                      Обработчики обновления таких библиотек должны быть вызваны ранее
//                                      обработчиков обновления данной библиотеки.
//                                      При циклических зависимостях или, напротив, отсутствии каких-либо зависимостей,
//                                      порядок вызова обработчиков обновления определяется порядком добавления модулей
//                                      в процедуре ПриДобавленииПодсистем общего модуля
//                                      ПодсистемыКонфигурацииПереопределяемый.
//     * РежимВыполненияОтложенныхОбработчиков - Строка - "Последовательно" - отложенные обработчики обновления выполняются
//                                      последовательно в интервале от номера версии информационной базы до номера
//                                      версии конфигурации включительно или "Параллельно" - отложенный обработчик после
//                                      обработки первой порции данных передает управление следующему обработчику, а после
//                                      выполнения последнего обработчика цикл повторяется заново.
//     * ЗаполнятьДанныеНовыхПодсистемПриПереходеСДругойПрограммы - Булево - если установить Истина, то при переходе с
//                                      другой программы будут автоматически выполнены обработчики начального заполнения
//                                      новых подсистем. При описании обработчика обновления можно при необходимости
//                                      отключить его выполнение, указав свойство НеВыполнятьПриПереходеСДругойПрограммы.
//
Процедура ПриДобавленииПодсистемы(Описание) Экспорт

Пример вызова

ОбновлениеИнформационнойБазыБИД.ПриДобавленииПодсистемы(Описание)

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

Описание, пример вызова

////////////////////////////////////////////////////////////////////////////////
// Обработчики обновления информационной базы.

// Добавляет в список процедуры-обработчики обновления данных ИБ
// для всех поддерживаемых версий библиотеки или конфигурации.
// Вызывается перед началом обновления данных ИБ для построения плана обновления.
//
// Параметры:
//   Обработчики - ТаблицаЗначений - описание полей, см. в процедуре.
//                 ОбновлениеИнформационнойБазы.НоваяТаблицаОбработчиковОбновления.
//
// Пример:
//  Обработчик = Обработчики.Добавить();
//  Обработчик.Версия              = "1.1.0.0";
//  Обработчик.Процедура           = "ОбновлениеИБ.ПерейтиНаВерсию_1_1_0_0";
//  Обработчик.РежимВыполнения     = "Монопольно";
//
Процедура ПриДобавленииОбработчиковОбновления(Обработчики) Экспорт

Пример вызова

ОбновлениеИнформационнойБазыБИД.ПриДобавленииОбработчиковОбновления(Обработчики)

ПередОбновлениемИнформационнойБазы

Описание, пример вызова

// Вызывается перед процедурами-обработчиками обновления данных ИБ.
//
Процедура ПередОбновлениемИнформационнойБазы() Экспорт

Пример вызова

ОбновлениеИнформационнойБазыБИД.ПередОбновлениемИнформационнойБазы()

ПослеОбновленияИнформационнойБазы

Описание, пример вызова

// Вызывается после завершения обновления данных ИБ.
//
// Параметры:
//   ПредыдущаяВерсия       - Строка - версия до обновления. "0.0.0.0" для "пустой" ИБ.
//   ТекущаяВерсия          - Строка - версия после обновления.
//   ВыполненныеОбработчики - ДеревоЗначений - список выполненных процедур-обработчиков обновления,
//                                             сгруппированных по номеру версии.
//   ВыводитьОписаниеОбновлений - Булево - если установить Истина, то будет выведена форма
//                                с описанием обновлений. По умолчанию, Истина.
//                                Возвращаемое значение.
//   МонопольныйРежим           - Булево - Истина, если обновление выполнялось в монопольном режиме.
//
// Пример:
//  Для Каждого Версия Из ВыполненныеОбработчики.Строки Цикл
//
//    Если Версия.Версия = "*" Тогда
//      // Обработчик, который может выполнятся при каждой смене версии.
//    Иначе
//      // Обработчик, который выполняется для определенной версии.
//    КонецЕсли;
//
//    Для Каждого Обработчик Из Версия.Строки Цикл
//      ...
//    КонецЦикла;
//
//  КонецЦикла;
//
Процедура ПослеОбновленияИнформационнойБазы(Знач ПредыдущаяВерсия, Знач ТекущаяВерсия, Экспорт

Пример вызова

ОбновлениеИнформационнойБазыБИД.ПослеОбновленияИнформационнойБазы(ПредыдущаяВерсия, ТекущаяВерсия, );

ПриПодготовкеМакетаОписанияОбновлений

Описание, пример вызова

// Вызывается при подготовке табличного документа с описанием изменений в программе.
//
// Параметры:
//   Макет - ТабличныйДокумент - описание обновления всех библиотек и конфигурации.
//           Макет можно дополнить или заменить.
//           См. также общий макет ОписаниеИзмененийСистемы.
//
Процедура ПриПодготовкеМакетаОписанияОбновлений(Знач Макет) Экспорт

Пример вызова

ОбновлениеИнформационнойБазыБИД.ПриПодготовкеМакетаОписанияОбновлений(Макет)

ПриОпределенииРежимаОбновленияДанных

Описание, пример вызова

// Вызывается при определении режима обновления данных.
//
// Параметры:
//   РежимОбновленияДанных - Строка - режим обновления.
//   СтандартнаяОбработка - Булево - Ложь, если нужно изменить режим по умолчанию.
//
Процедура ПриОпределенииРежимаОбновленияДанных(РежимОбновленияДанных, СтандартнаяОбработка) Экспорт

Пример вызова

ОбновлениеИнформационнойБазыБИД.ПриОпределенииРежимаОбновленияДанных(РежимОбновленияДанных, СтандартнаяОбработка)

ПриДобавленииОбработчиковПереходаСДругойПрограммы

Описание, пример вызова

// Добавляет в список процедуры-обработчики перехода с другой программы (с другим именем конфигурации).
// Например, для перехода между разными, но родственными конфигурациями: базовая -> проф -> корп.
// Вызывается перед началом обновления данных ИБ.
//
// Параметры:
//  Обработчики - ТаблицаЗначений:
//    * ПредыдущееИмяКонфигурации - Строка - имя конфигурации, с которой выполняется переход;
//                                           или "*", если нужно выполнять при переходе с любой конфигурации.
//    * Процедура                 - Строка - полное имя процедуры-обработчика перехода с программы
//                                           ПредыдущееИмяКонфигурации.
//                                  Например, "ОбновлениеИнформационнойБазыУПП.ЗаполнитьУчетнуюПолитику"
//                                  Обязательно должна быть экспортной.
//
// Пример:
//  Обработчик = Обработчики.Добавить();
//  Обработчик.ПредыдущееИмяКонфигурации  = "УправлениеТорговлей";
//  Обработчик.Процедура                  = "ОбновлениеИнформационнойБазыУПП.ЗаполнитьУчетнуюПолитику";
//
Процедура ПриДобавленииОбработчиковПереходаСДругойПрограммы(Обработчики) Экспорт

Пример вызова

ОбновлениеИнформационнойБазыБИД.ПриДобавленииОбработчиковПереходаСДругойПрограммы(Обработчики)

ПриЗавершенииПереходаСДругойПрограммы

Описание, пример вызова

// Вызывается после выполнения всех процедур-обработчиков перехода с другой программы (с другим именем конфигурации),
// и до начала выполнения обновления данных ИБ.
//
// Параметры:
//  ПредыдущееИмяКонфигурации    - Строка - имя конфигурации до перехода.
//  ПредыдущаяВерсияКонфигурации - Строка - имя предыдущей конфигурации (до перехода).
//  Параметры                    - Структура:
//    * ВыполнитьОбновлениеСВерсии   - Булево - по умолчанию Истина. Если установить Ложь,
//        то будут выполнена только обязательные обработчики обновления (с версией "*").
//    * ВерсияКонфигурации           - Строка - номер версии после перехода.
//        По умолчанию, равен значению версии конфигурации в свойствах метаданных.
//        Для того чтобы выполнить, например, все обработчики обновления с версии ПредыдущаяВерсияКонфигурации,
//        следует установить значение параметра в ПредыдущаяВерсияКонфигурации.
//        Для того чтобы выполнить вообще все обработчики обновления, установить значение "0.0.0.1".
//    * ОчиститьСведенияОПредыдущейКонфигурации - Булево - по умолчанию Истина.
//        Для случаев когда предыдущая конфигурация совпадает по имени с подсистемой текущей конфигурации, следует
//        указать Ложь.
//
Процедура ПриЗавершенииПереходаСДругойПрограммы(ПредыдущееИмяКонфигурации, ПредыдущаяВерсияКонфигурации, Параметры) Экспорт

Пример вызова

ОбновлениеИнформационнойБазыБИД.ПриЗавершенииПереходаСДругойПрограммы(ПредыдущееИмяКонфигурации, ПредыдущаяВерсияКонфигурации, Параметры)