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

Пометить сформированную по истории копию: УчебнаяЗаявкаИстории

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

Подготовка

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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