Ищет элемент справочника по значению реквизита
Синтаксис
Метод НайтиПоРеквизиту() имеет следующий синтаксис:
число НайтиПоРеквизиту(ИмяРеквизита, Значение, Глобально)
А также альтернативный англоязычный синтаксис:
number FindByAttribute(ИмяРеквизита, Значение)
Параметры
Описание параметров метода НайтиПоРеквизиту():
| Имя параметра | Тип | Описание | ||||
|---|---|---|---|---|---|---|
| ИмяРеквизита | Строка | имя реквизита, как оно задано в конфигураторе | ||||
| Значение | Произвольный | значение реквизита для поиска | ||||
| Глобально | Число | признак глобального поиска
|
||||
| Жирным шрифтом выделены обязательные параметры | ||||||
Возвращаемое значение
Число
| 1 | — элемент справочника найден |
| 0 | — в противном случае |
Описание
Метод НайтиПоРеквизиту() ищет элемент справочника по значению реквизита. Поскольку, данный метод является позиционирующим (см. описание метода Выбран()), его можно использовать только для объектов, созданных функцией СоздатьОбъект().
Внимание! Метод можно использовать только для реквизитов с установленным признаком
Сортировка
Пример использования
Пример кода с использованием метода НайтиПоРеквизиту():
//поиск по реквизиту с использованием родителя Справочник.ИспользоватьРодителя(ГруппаДляПоиска); Если Справочник.НайтиПоРеквизиту("ИНН", ИНН, 0) = 1 Тогда Сообщить("Найден контрагент: " + Справочник.Наименование); Иначе Сообщить("Упс! По ИНН " + ИНН + " контрагент не найден!"); КонецЕсли; //поиск по реквизиту по всему справочнику Справочник = СоздатьОбъект("Справочник.Контрагенты"); Если Справочник.НайтиПоРеквизиту("ИНН", ИНН, 1) = 1 Тогда Сообщить("Найден контрагент: " + Справочник.Наименование); Иначе Сообщить("Упс! По ИНН " + ИНН + " контрагент не найден!"); КонецЕсли; //Результат // Упс! По ИНН 110000000004 контрагент не найден! // Найден контрагент: Гвоздика
Читайте также:
- Метод Справочник.НайтиПоКоду()
- Метод Справочник.НайтиПоНаименованию()
- Метод Справочник.НайтиЭлемент()