Обновление информационной базы ЕГАИС

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

РезультатАдаптацииЗапроса

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

// Результат адаптации запроса для функции ОбновлениеИнформационнойБазыЕГАИС.РегистраторыДляПерепроведения
//
// Возвращаемое значение:
//  Структура - поля:
//  * ТекстЗапроса - Строка - должен быть объявлен обязательно, адаптированный текст запроса
//  * ЗначенияПараметров - Структура - значения параметров запроса, которые вычисляются из констант
//                    (не зависят от конкретного документа)
//
Функция РезультатАдаптацииЗапроса() Экспорт

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

Результат = ОбновлениеИнформационнойБазыЕГАИС.РезультатАдаптацииЗапроса()

АдаптироватьЗапросМеханизмаПроведения

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

// Адаптирует запрос механизма проведения для использования в функции ОбновлениеИнформационнойБазыЕГАИС.РегистраторыДляПерепроведения,
// делая его запросом для всех проведенных документов.
// Параметры:
//  ИзначальныйТекстЗапроса - Строка - текст запроса механизма проведения, который или формирует таблицу движений, или создает временные таблицы,
//                        используемые в запросах формирующих таблицы движений
//                        Требования к тексту запроса:
//                        - все объединяемые таблицы запроса, формирующего таблицу движений имеют один синоним;
//                        - если есть соединения с другими таблицами, то оно реализовано таким образом, что будет
//                          корректно работать, если не установлен отбор по ссылке;
//                        - не используются временные таблицы;
//                        - не используются вложенные запросы и группировки;
//                        - нет упорядочивания;
//                        - параметры запроса рассчитываются или по данным шапки, или являются значениями констант;
//                         - для всех полей непримитивных типов заполнены значения по умолчанию, как они хранятся в регистре.
//                          Это или пустая ссылка типа, или НЕОПРЕДЕЛЕНО (для полей составного типа), то НЕ должно быть NULL
//                        - параметр, устанавливающий отбор по ссылке называется &Ссылка
//                        - в конце запроса не должно быть знака ";"
//                         - в тексте запроса, формирующим таблицу движения, должны выбираться только ЗНАЧИМЫЕ
//                          для формирования движений поля (нет полей НомерСтроки, Порядок и т.д.);
//  ПолноеИмяРегистра         - Строка - полное имя регистра, как оно задается в языке запросов (например, РегистрНакопления.ТоварыНаСкладах)
//  ПолноеИмяДокумента         - Строка - полное имя документа, как оно задается в языке запросов (например, Документ.ВводОстатков)
//  СинонимТаблицыДокумента       - Строка - синоним таблицы документа, используемый в запросе
//  ПереопределениеРасчетаПараметров - Структура - по умолчанию все параметры, которые есть в запросе заменяются на <СинонимТаблицыДокумента>.Ссылка.<ИмяПараметра>
//                          Для параметра &Период по умолчанию подставляется <СинонимТаблицыДокумента>.Ссылка.Дата
//                          Если параметры рассчитываются иначе, то в этой структуре в ключе передается имя параметра, в значении
//                          - выражение для его расчета
//  ТекстыЗапросаВременныхТаблиц     - Массив - тексты запросов временных таблиц, используемых в тексте запроса механизма проведения. Массив структур с ключами:
//                            * Ключ - имя временной таблицы,
//                            * Значение - текст запроса временной таблицы.
//                            Параметр необходимо использовать когда механизм формирования движений опирается не на
//                            физическую таблицу документа, а на предварительно созданную временную таблицу.
//                            Поля выборки временной таблицы должны содержать поле "Ссылка" - ссылку на физическую таблицу проводимого документа.
//
// Возвращаемое значение:
//   - строка - адаптированный текст запроса
//
Функция АдаптироватьЗапросМеханизмаПроведения(Знач ИзначальныйТекстЗапроса, Экспорт

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

Результат = ОбновлениеИнформационнойБазыЕГАИС.АдаптироватьЗапросМеханизмаПроведения(ИзначальныйТекстЗапроса, );

РегистраторыДляПерепроведения

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

// Выбирает регистраторы, по которым движения записанные в регистр отличаются от тех, которые формируются запросом механизма проведения
// Параметры:
//  РезультатАдаптацииЗапроса - Структура - см. ОбновлениеИнформационнойБазыЕГАИС.РезультатАдаптацииЗапроса
//                         Требования к запросам:
//                         - текст не должен содержать обращения к временным таблицам
//                        - все запросы должны быть адаптированы для выборки без отбора по ссылке.
//                          это можно сделать  с помощью функции ОбновлениеИнформационнойБазыЕГАИС.АдаптироватьЗапросМеханизмаПроведения,
//                           если текст запроса удовлетворяет ее условиям. Если нет - можно попробовать адаптировать текст самостоятельно
//                         - в тексте запроса, формирующим таблицу движения, должны выбираться только ЗНАЧИМЫЕ
//                          для формирования движений поля (нет полей НомерСтроки, Порядок и т.д.);
//                         - нет упорядочивания;
//                         - есть поле "Регистратор";
//  ПолноеИмяРегистра         - Строка - полное имя регистра, как оно задается в языке запросов (например, РегистрНакопления.ТоварыНаСкладах)
//  ПолноеИмяДокумента         - Строка - полное имя документа, как оно задается в языке запросов (например, Документ.ВводОстатков)
//  ЗначенияПараметров - Структура - если параметры не рассчитываются в запросе, а устанавливаются из кода, то в этом параметре нужно передать их значения
//                  Например, это значения учитываемых ФО
//  Очередь - Число, Неопределено - если параметр <> Неопределено, то при составлении массива регистраторов учитывается информация о выполнении обработчиков обновления
//                    - исключаются регистраторы, которые не обновлены обработчиками предыдущих очередей
//                    - оптимизируется выборка данных, т.к. берутся только те регистраторы, которые еще не обрабатывались в текущей очереди
//                  Важно, чтобы тексты запросов адаптировались тоже с учетом очереди (либо тоже без учета очереди)
// Возвращаемое значение:
//   - Массив - массив ссылок на документы, по которым нужно переформировать движения по регистру
//
Функция РегистраторыДляПерепроведения(РезультатАдаптацииЗапроса, Экспорт

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

Результат = ОбновлениеИнформационнойБазыЕГАИС.РегистраторыДляПерепроведения(РезультатАдаптацииЗапроса, );

ПерезаписатьДвиженияИзОчереди

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

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

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

Результат = ОбновлениеИнформационнойБазыЕГАИС.ПерезаписатьДвиженияИзОчереди(ПолныеИменаДокументов, ПолныеИменаРегистров, Очередь)

СоздатьСправкиВТТН

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

// Создает справки 1 и 2 в табличной части Товары ТТН.
//
Процедура СоздатьСправкиВТТН() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.СоздатьСправкиВТТН()

ОбновитьСтатусыОбработкиЕГАИС

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

// Заполняет статусы обработки запросов ЕГАИС.
//
Процедура ОбновитьСтатусыОбработкиЕГАИС() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ОбновитьСтатусыОбработкиЕГАИС()

ЗаполнитьВидыОперацийТТНВходящей

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

// Заполняет виды операций входящей ТТН.
//
Процедура ЗаполнитьВидыОперацийТТНВходящей() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьВидыОперацийТТНВходящей()

ЗаполнитьДокументОснованиеВПротоколеОбмена

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

// Заполнение регистра сведений Протокол обмена ЕГАИС.
//
Процедура ЗаполнитьДокументОснованиеВПротоколеОбмена() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьДокументОснованиеВПротоколеОбмена()

ЗаполнитьИдентификаторЗапроса

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

// Заполняет идентификатор запроса в списке запросов.
//
Процедура ЗаполнитьИдентификаторЗапроса() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьИдентификаторЗапроса()

ЗаполнитьТипЗапроса

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

// Заполняет тип запроса в списке запросов.
//
Процедура ЗаполнитьТипЗапроса() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьТипЗапроса()

УстановитьПризнакИспользованияОбработкиОтветов

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

// Устанавливает признак Использование для регламентного задания ОбработкаОтветовЕГАИС.
//
Процедура УстановитьПризнакИспользованияОбработкиОтветов() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.УстановитьПризнакИспользованияОбработкиОтветов()

УстановитьПризнакПроведенияТТН

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

// Устанавливает признак проведения для входящих ТТН.
//
Процедура УстановитьПризнакПроведенияТТН() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.УстановитьПризнакПроведенияТТН()

ЗаполнитьВидДокумента

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

// Заполняет реквизит ВидДокумента в существующих документах.
//
Процедура ЗаполнитьВидДокумента() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьВидДокумента()

ЗаполнитьТипОрганизацииЕГАИС

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

// Заполняет тип организации.
//
Процедура ЗаполнитьТипОрганизацииЕГАИС() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьТипОрганизацииЕГАИС()

ЗаполнитьПричинуПостановкиНаБаланс

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

// Заполняет причину постановки на баланс в актах постановки на баланс.
//
Процедура ЗаполнитьПричинуПостановкиНаБаланс() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьПричинуПостановкиНаБаланс()

ЗаполнитьФорматОбмена

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

// Заполняет информацию об используемом формате обмена с УТМ.
//
Процедура ЗаполнитьФорматОбмена() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьФорматОбмена()

УдалитьДвиженияПоТорговомуЗалу

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

// Удаляет движения по торговому залу.
//
Процедура УдалитьДвиженияПоТорговомуЗалу() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.УдалитьДвиженияПоТорговомуЗалу()

ЗаполнитьИдентификаторАктаПостановкиНаБаланс

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

// Заполняет реквизит Идентификатор в актах постановки на баланс.
//
Процедура ЗаполнитьИдентификаторАктаПостановкиНаБаланс() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьИдентификаторАктаПостановкиНаБаланс()

УдалитьОбработчикОбновленияАктаСписания

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

// Удаляет обработчик обновления, перенесенный в другой модуль.
//
Процедура УдалитьОбработчикОбновленияАктаСписания() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.УдалитьОбработчикОбновленияАктаСписания()

ОбъектМетаданныхВходитВСоставРИБ

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

// Возвращает Истина, если объект метаданных входит в состав РИБ.
//
Функция ОбъектМетаданныхВходитВСоставРИБ(ОбъектМетаданных) Экспорт

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

Результат = ОбновлениеИнформационнойБазыЕГАИС.ОбъектМетаданныхВходитВСоставРИБ(ОбъектМетаданных));

ЗаполнитьЕдиницуИзмеренияЛитр

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

Процедура ЗаполнитьЕдиницуИзмеренияЛитр() Экспорт

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

ОбновлениеИнформационнойБазыЕГАИС.ЗаполнитьЕдиницуИзмеренияЛитр()