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