МенеджерИсторииДанных.ПолучитьРазличияВерсий (DataHistoryManager.GetVersionDiff)

МенеджерИсторииДанных (DataHistoryManager)

ПолучитьРазличияВерсий (GetVersionDiff)

Синтаксис:

ПолучитьРазличияВерсий(<Данные>, <НомерВерсииПослеИзменения>, <НомерВерсииДоИзменения>)

Параметры:

<Данные> (обязательный)

Тип: СправочникСсылка.<Имя справочника>; ДокументСсылка.<Имя документа>; РегистрСведенийКлючЗаписи.<Имя регистра сведений>; БизнесПроцессСсылка.<Имя бизнес-процесса>; ЗадачаСсылка.<Имя задачи>; ПланВидовХарактеристикСсылка.<Имя плана видов характеристик>; ПланСчетовСсылка.<Имя плана счетов>; ПланОбменаСсылка.<Имя плана обмена>; ПланВидовРасчетаСсылка.<Имя плана видов расчета>; КонстантаКлючЗначения.<Имя константы>.
Ссылка на объект или ключ записи регистра сведений, по которым создана версия.

<НомерВерсииПослеИзменения> (обязательный)

Тип: Число.
Номер версии после изменения.

<НомерВерсииДоИзменения> (необязательный)

Тип: Число; Неопределено.
Номер версии до изменения. Если указано значение Неопределено, сравнение выполняется с предыдущей версией.
Значение по умолчанию: Неопределено.

Возвращаемое значение:

Тип: Структура; Неопределено.
Неопределено - если версия создана по удалению данных.
Структура - если версия создана по изменению или добавлению данных. Содержит измененные поля версии после изменения. Ключ структуры - имя реквизита. Значение содержит структуру со значениями полей до и после изменения. Данная структура не содержит независимые разделители и их значения. Если объект содержит табличные части, то ключом является имя табличной части, а значением - массив, каждый элемент которого представляет собой фиксированную структуру информации об измененной записи табличной части.
Структура изменения поля:

ЗначениеПослеИзменения (AfterChangeValue) - тип Число, Строка, Дата, Булево, УникальныйИдентификатор, Ссылка на объект информационной базы. Значение в версии после изменения. Ссылки предоставляются в виде структуры.
ЗначениеДоИзменения (BeforeChangeValue) - тип Число, Строка, Дата, Булево, УникальныйИдентификатор, Ссылка на объект информационной базы. Значение в версии до изменения. Значение не заполняется если не существует версии до изменения (версия после изменения с номером 1), или поле в версии до изменения не учитывается в истории. Ссылки предоставляются в виде структуры.

Структура изменения для табличной части:

НомерСтрокиВВерсииПослеИзменения (RowNumberInAfterChangeVersion) – тип Число. Номер строки в версии после изменения. Изменение строк с меньшим номером приводит к тому, что номер строки меняется между версиями. Может потребоваться отобразить отчет по изменению относительно новой версии. Установка номера строки в новой версии для удаленной строки облегчает определение позиции строки относительно других строк в новой версии.
НомерСтрокиВВерсииДоИзменения (RowNumberInBeforeChangeVersion) – тип Число. Номер строки в версии до изменения. Изменение строк с меньшим номером приводит к тому, что номер строки меняется между версиями. Может потребоваться отобразить отчет по изменению относительно старой версии. Установка номера строки в старой версии для добавленной строки облегчает определение позиции строки относительно других строк в старой версии.
КоличествоИзмененныхСтрок (ChangedRowCount) – тип Число. Количество измененных строк, для создания записи с номером "1".
ВидИзмененияСтрокиДанных (DataRowChangeType) – тип ВидИзмененияСтрокиДанных. Тип изменения записи табличной части.
В зависимости от типа изменения строки структура полей содержит:
Создание – Для каждого реквизита табличной части добавляется элемент. Ключ - имя реквизита табличной части. Значение содержит значение реквизита табличной части, установленное в строке после изменения.
Изменение – Для каждого реквизита табличной части добавляется элемент. Ключ - имя реквизита табличной части. Значение содержит структуру "Изменение реквизита". Структура аналогична для изменения реквизита объекта.
Удаление – Для каждого реквизита табличной части, добавляется элемент. Ключ - имя реквизита табличной части. Значение содержит значение реквизита табличной части, установленное в строке, после изменения.
Перемещение – Свойство не устанавливается.

Структура для ссылок:

Ссылка (Ref) - тип Ссылка на объект информационной базы. Ссылка на объект.
Представление (Presentation) - тип Строка. Представление ссылки.

Описание:

Получает набор изменений между версиями.

Доступность:

Сервер, толстый клиент, внешнее соединение.

Пример:

// Вывод в консоль названий добавленных,

// удаленных позиций, изменений цены позиции

РазличиеЗаказов = ИсторияДанных.ПолучитьРазличияВерсий(
    Документы.Заказ.НайтиПоНомеру("0000001"), 2, 1);
Для Каждого Позиция Из РазличиеЗаказов.ПозицииЗаказа Цикл
     Если Позиция.ВидИзмененияСтрокиДанных
         = ВидИзмененияСтрокиДанных.Добавление Тогда
        Сообщить("Добавлена позиция " + Позиция.Продукция);
     Иначе Если Позиция.ВидИзмененияСтрокиДанных
        = ВидИзмененияСтрокиДанных.Удаление Тогда
        Сообщить("Удалена позиция " + Позиция.Продукция);
     Иначе Если Позиция.ВидИзмененияСтрокиДанных
        = ВидИзмененияСтрокиДанных.Изменение Тогда
        Сообщить("Изменена позиция."
            +  " Старая цена = " + Позиция.Цена.СтароеЗначение
            +  " Новая цена = " + Позиция.Цена.НовоеЗначение);
     КонецЕсли;
КонецЦикла;

Оглавление | Родительский раздел Платформа 8.3.13.1809