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

BSL268 - Использование методов "НайтиПоНаименованию", "НайтиПоКоду" и "НайтиПоНомеру"

Кратко

Использование методов "НайтиПоНаименованию", "НайтиПоКоду" и "НайтиПоНомеру"

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

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

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

Поведение

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

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

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

[tool.onec-hbk-bsl]
select = ["BSL268"]
ignore = ["UsingFindElementByString"]

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

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

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

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

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

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

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

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

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

Правило находит использование методов НайтиПоНаименованию, НайтиПоКоду или НайтиПоНомеру с указанием конкретных и уникальных номеров, кодов и названий элементов или документов. Скорее всего, подобный код не будет работать в других ИБ, что приведет к ошибкам выполнения. Возможно, в финальный код попал тестовый код, что также не рекомендовано.

Константные значения данных из ИБ рекомендуется указывать в константах ИБ, предопределенных элементах метаданных.

Примеры

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

Должность = Справочники.Должности.НайтиПоНаименованию("Ведущий бухгалтер");
или
Должность = Справочники.Должности.НайтиПоКоду("00-0000001");

или

ОбъектНазначения = Документы.ПередачаТоваровМеждуОрганизациями.НайтиПоНомеру("0000-000001", ТекущаяДата());

Допустимо использование:

Справочники.Валюты.НайтиПоКоду(ТекущиеДанные.КодВалютыЦифровой);
Справочники.КлассификаторБанков.НайтиПоКоду(СведенияОБанке.БИК);

Документы.Реализация.НайтиПоНомеру(НомерДокумента);