ЗадачаОбъект.<Имя задачи>.ОбработкаФормированияПоВерсииИсторииДанных

Пометить сформированную по истории копию: УчебныеСогласования

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

Подготовка

1. Только собственная отдельная учебная база. Создайте Задачи → УчебныеСогласования. Используйте собственную задачу из подготовки маршрута. Добавьте КомментарийИстории Строка 100; изменяйте только собственную записанную невыполненную задачу.

2. Работайте в отдельной пустой учебной конфигурации. Создайте справочник УчебныеИсполнители и предопределённый элемент Демонстрационный с наименованием Учебный исполнитель.

3. Создайте задачу УчебныеСогласования: строковый номер длиной 12, автонумерация, наименование длиной 100. Добавьте реквизит адресации Исполнитель типа СправочникСсылка.УчебныеИсполнители и выберите его основным реквизитом адресации. Здесь используется прямая адресация; регистр ролевой адресации не нужен.

4. Создайте параметр сеанса УчебныйИсполнитель того же ссылочного типа. В свойстве задачи Текущий исполнитель выберите этот параметр. Запросы урока передают исполнителя явно и не зависят от начального значения параметра сеанса.

5. Создайте бизнес-процесс УчебноеСогласование со строковым номером длиной 12 и автонумерацией. В свойстве Задача выберите УчебныеСогласования. Карта маршрута: Старт (начало) → Согласовать (действие) → Завершение. В точке Согласовать задайте адресацию Исполнитель = Демонстрационный, Групповая = Ложь.

6. И у задачи, и у бизнес-процесса создайте обычные реквизиты КомментарийУчебный (Строка 100), Сумма (Число 12.2), Подтверждено (Булево), ЗапретУдаления (Булево). Добавьте табличную часть Детали с колонками Наименование (Строка 100) и Количество (Число 10.0).

7. У этого своего объекта включите ИсторияДанных; у дополнительного поля КомментарийИстории, если оно используется, также включите участие в истории. Подготовьте две версии только собственных данных; включение флага само не создаёт задним числом версии.

8. Дождитесь штатного обновления своей истории. Для ручного обновления выбирайте конкретные свои данные / свои метаданные и не вызывайте бесконтрольное ОбновитьИсторию() без отбора в рабочей базе.

9. Обработчик разместите в указанном модуле объекта / менеджера; директивы управляемой формы и первый параметр Элемент здесь не нужны. BSL, запись собственных данных и обновление истории при сборке HTML не выполнялись.

10. Модуль объекта своего объекта, а для регистра — модуль набора записей, для константы — модуль менеджера значения. Процедуру назначьте соответствующему событию.

11. Дополнительный блок выполняйте в собственной обработке отдельно: он читает первую реально существующую версию только своих метаданных. Не добавляйте Копия.Записать(): предварительный просмотр и восстановление с записью — разные действия.

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

Отбор = Новый Структура("Метаданные", Метаданные.Задачи.УчебныеСогласования);
Версии = ИсторияДанных.ВыбратьВерсии(Отбор, "Данные,НомерВерсии", "НомерВерсии Возр", 1);
Если Версии.Количество() = 0 Тогда
    Сообщить("В своей истории пока нет сформированных версий");
    Возврат;
КонецЕсли;
Версия = Версии[0];
Копия = ИсторияДанных.СформироватьПоВерсии(Версия.Данные, Версия.НомерВерсии);
Если Копия.ДополнительныеСвойства.Свойство("СозданИзИстории", Маркер) Тогда
    Сообщить("Свой обработчик пометил копию: " + Строка(Маркер));
Иначе
    Сообщить("Проверьте назначение своего обработчика");
КонецЕсли;

Разбор по шагам

1. Подготовьте собственный объект и настоящие версии его истории.

2. Назначьте обработчик в точном модуле.

3. Выполните показанное штатное действие / дополнительный код и проверьте фактический журнал или маркер копии.

Как проверить результат

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

2. У события константы, плана обмена и плана видов расчёта сигнатура без параметров. У задачи СтандартнаяОбработка находится перед ИсключитьДанные; у регистра есть КлючЗаписи.

3. КомментарийИстории намеренно исключён из стандартного заполнения. В новой копии он не обещается равным текущему комментарию базы: это пропуск исторического поля, не автоматическое сохранение текущего значения.

Ожидаемый результат

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

На что обратить внимание

1. Не вызывайте обновление истории рекурсивно из её обработчиков.

2. Свойства безопасности разделения и права истории не обходятся.

3. BSL, обработка истории и запись журнала при сборке HTML не выполнялись.

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