Обработчики обновления ИБ — идемпотентные и порционные

Директивный

Правило

Любое изменение структуры данных (новый реквизит, который должен быть заполнен; перенос данных между реквизитами; смена формата хранения) сопровождается обработчиком обновления ИБ. Требования к обработчику:

Идемпотентность. Повторный запуск (после падения на середине, при повторном обновлении) не портит данные: обработчик выбирает только необработанные записи (ГДЕ НовыйРеквизит = НеЗаполнено), а не «все подряд».
Порционность. Большие объёмы обрабатываются пачками; для типовых на БСП — отложенные обработчики, чтобы не держать пользователей на заставке «Обновление…» часами.
Логирование. Старт, объём, финиш и каждая ошибка — в ЖР. Ошибка по одному объекту не валит обновление целиком: объект пропускается с записью в ЖР и разбирается после.
Обработчик тестируется на копии боевой базы, а не только на пустой ИБ разработчика.

Зачем

Обработчик обновления выполняется один раз на каждой базе — и именно в момент, когда откат сложнее всего (окно обновления, пользователи ждут). Неидемпотентный обработчик после обрыва на 70% при повторном запуске задваивает данные первых 70%. Обработчик без порций держит монопольный режим часами. Ошибка без перехвата оставляет базу в полуобновлённом состоянии посреди ночи.

Процедура ЗаполнитьНовыйРеквизит() Экспорт
    Выборка = Справочники.Договоры.Выбрать(); // все, включая уже обработанные
    Пока Выборка.Следующий() Цикл
        Объект = Выборка.ПолучитьОбъект();
        Объект.НоваяСтавка = Объект.СтараяСтавка * 100; // при повторе умножит ещё раз
        Объект.Записать(); // одна ошибка — упало всё обновление
    КонецЦикла;
КонецПроцедуры

Процедура ЗаполнитьНовыйРеквизит() Экспорт
    // Только необработанные — повторный запуск безопасен.
    Запрос = Новый Запрос(
        "ВЫБРАТЬ ПЕРВЫЕ 1000 Ссылка
        |ИЗ Справочник.Договоры
        |ГДЕ НоваяСтавка = 0 И СтараяСтавка <> 0");
    Выборка = Запрос.Выполнить().Выбрать();
    Пока Выборка.Следующий() Цикл
        Попытка
            Объект = Выборка.Ссылка.ПолучитьОбъект();
            Объект.НоваяСтавка = Объект.СтараяСтавка * 100;
            Объект.Записать();
        Исключение
            ЗаписьЖурналаРегистрации(НСтр("ru='Обновление ИБ'"),
                УровеньЖурналаРегистрации.Ошибка, , Выборка.Ссылка,
                ПодробноеПредставлениеОшибки(ИнформацияОбОшибке()));
        КонецПопытки;
    КонецЦикла;
КонецПроцедуры

Когда не применять

Изменения метаданных, не требующие преобразования данных (новый необязательный реквизит, новая форма, правка кода), обработчика не требуют. Разовые правки данных на одной базе допустимо делать обработкой — но с теми же требованиями идемпотентности и логирования.

Обработчики обновления ИБ — идемпотентные и порционные

Правило

Зачем

Когда не применять

См. также