BSL172 - Отсутствует проверка признака ОбменДанными.Загрузка в обработчике событий объекта¶

Кратко¶

Отсутствует проверка признака ОбменДанными.Загрузка в обработчике событий объекта

Идентификаторы¶

Поле	Значение
Код правила	`BSL172`
Совместимый псевдоним	`DataExchangeLoading`
Серьёзность	`WARNING`
Без конфигурации	Да
BSLLS JSON, режим `ON` без переопределений	Да
Флаг реестра `implemented`	Да
Теги	`correctness`, `data-exchange`

Флаг implemented отражает реестр и не подтверждает проверенное совпадение с BSLLS.

Поведение¶

Публичный идентификатор BSL172 и псевдоним DataExchangeLoading стабильны.
Правило сообщает о случаях, описанных на этой странице.
Подавления и проектная конфигурация применяются до публикации результата.
Для выполнения правила не требуется внешний анализатор или сетевой доступ.

Настройка и подавление¶

Код BSL### - основной стабильный идентификатор. Совместимый псевдоним принимается в select, ignore и совместимых блоковых комментариях.

[tool.onec-hbk-bsl]
select = ["BSL172"]
ignore = ["DataExchangeLoading"]

Все три семейства подавлений работают для текущей строки и диапазона. Если открывающий комментарий стоит после кода, он действует только на эту строку. Используйте любой один вариант:

noqa:

Значение = "пример";  // noqa: BSL172

bsl-disable (совместимый вариант):

Значение = "пример";  // bsl-disable: BSL172

совместимый BSLLS-вариант:

Значение = "пример";  // BSLLS:DataExchangeLoading-off

Если тот же открывающий комментарий стоит на отдельной строке, он начинает диапазон. Закройте его парным маркером того же семейства:

// noqa: BSL172
// код без этой диагностики
// noqa-enable: BSL172

// bsl-disable: BSL172
// код без этой диагностики
// bsl-enable: BSL172

// BSLLS:DataExchangeLoading-off
// код без этой диагностики
// BSLLS:DataExchangeLoading-on

Чтобы отключить правило до конца файла, не добавляйте закрывающий noqa-enable, bsl-enable или BSLLS:…-on.

Открывающий и закрывающий маркеры должны принадлежать одному семейству.

Описание диагностики¶

Все действия в процедурах-обработчиков событий ПередЗаписью, ПриЗаписи, ПередУдалением должны выполняться после проверки на ОбменДанными.Загрузка.

Это необходимо для того, чтобы никакая бизнес-логика объекта не выполнялась при записи объекта через механизм обмена данными, поскольку она уже была выполнена для объекта в том узле, где он был создан. В этом случае все данные загружаются в ИБ "как есть", без искажений (изменений), проверок или каких-либо других дополнительных действий, препятствующих загрузке данных.

Примеры¶

Неправильно:

Процедура ПередЗаписью(Отказ)

    Если Не Отказ Тогда
        ЗапутитьКакойТоАлгоритм();
    КонецЕсли;

    // код обработчика
    //
    // ...

КонецПроцедуры

Правильно:

Процедура ПередЗаписью(Отказ)
    Если ОбменДанными.Загрузка Тогда
         Возврат;
    КонецЕсли;

    // код обработчика
    // ...
КонецПроцедуры