Перейти к содержанию

BSL244 - Серверные вызовы в событиях форм

← Все правила

Кратко

Серверные вызовы в событиях форм

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

Поле Значение
Код правила BSL244
Совместимый псевдоним ServerCallsInFormEvents
Серьёзность ERROR
Без конфигурации Да
BSLLS JSON, режим ON без переопределений Да
Флаг реестра implemented Да
Теги correctness, ui, performance

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

Поведение

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

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

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

[tool.onec-hbk-bsl]
select = ["BSL244"]
ignore = ["ServerCallsInFormEvents"]

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

  • noqa:
Значение = "пример";  // noqa: BSL244
  • bsl-disable (совместимый вариант):
Значение = "пример";  // bsl-disable: BSL244
  • совместимый BSLLS-вариант:
Значение = "пример";  // BSLLS:ServerCallsInFormEvents-off

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

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

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

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

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

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

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

В событиях ПриАктивизацииСтроки и НачалоВыбора не должно быть вызовов контекстных серверных процедур. Эти события должны выполняться только на клиенте.

Диагностируются только серверные вызовы методов этой формы, выполняемые в контексте сервера (&НаСервере). Вызовы общих модулей (например, МойМодульСервер.МойСерверныйМетод) или внеконтекстные вызовы процедур самой формы (&НаСервереБезКонтекста) не будут ошибкой.

Согласно статье на Infostart, вызов серверных процедур из этих событий может привести к проблемам с производительностью и корректностью работы формы.

Примеры

Неправильно

&НаКлиенте
Процедура ПриАктивизацииСтроки(Элемент, ВыбраннаяСтрока, Поле, НовоеЗначение, СтандартнаяОбработка)
    // Ошибка: вызов серверной процедуры из клиентского события
    ТаблицаФормыПриАктивизацииСтрокиНаСервере();
    СтандартнаяОбработка = Ложь;
КонецПроцедуры

&НаСервере
Процедура ТаблицаФормыПриАктивизацииСтрокиНаСервере()
    ВызватьИсключение "тест";
КонецПроцедуры

Правильно

&НаКлиенте
Процедура ПриАктивизацииСтроки(Элемент, ВыбраннаяСтрока, Поле, НовоеЗначение, СтандартнаяОбработка)
    // Правильно: внеконтекстный вызов разрешен
    ТаблицаФормыПриАктивизацииСтрокиНаСервереБезКонтекста();
    СтандартнаяОбработка = Ложь;
КонецПроцедуры

&НаСервереБезКонтекста
Процедура ТаблицаФормыПриАктивизацииСтрокиНаСервереБезКонтекста()
    // Логика, не требующая контекста формы
КонецПроцедуры

Источники