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

BSL242 — Обработчик регламентного задания

← Все правила

Кратко

Обработчик регламентного задания

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

Поле Значение
Код правила BSL242
Совместимый псевдоним ScheduledJobHandler
Серьёзность ERROR
Включено по умолчанию Да
Реализовано Да
Теги correctness, scheduled-jobs

Поведение

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

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

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

[tool.onec-hbk-bsl]
select = ["BSL242"]
ignore = ["ScheduledJobHandler"]

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

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

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

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

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

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

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

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

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

К обработчикам регламентных заданий предъявляются определенные требования. В качестве метода регламентного задания может выступать любая экспортная процедура или функция неглобального общего серверного модуля. Если методом регламентного задания является функция, то ее возвращаемое значение игнорируется.

Если регламентное задание является предопределенным, то у его обработчика не должно быть параметров. Если нет, тогда параметрами подобного регламентного задания могут быть любые значения, которые разрешено передавать на сервер. Параметры регламентного задания должны в точности соответствовать параметрам той процедуры или функции, которую оно вызывает.

Правило проверяет следующие признаки валидности метода-обработчика регламентного задания: - существует и общий модуль и метод общего модуля, указанные как обработчик - общий модуль является серверным - метод является экспортным - у метода нет параметров, если регламентное задание является предопределенным. - задано тело метода - нет двух и более регламентных заданий, которые ссылаются на один и тот же метод-обработчик

Примеры

Источники