Справочник
Метод НайтиПоНаименованию()

Ищет элемент справочника по наименованию

Синтаксис

Метод НайтиПоНаименованию() имеет следующий синтаксис:

число НайтиПоНаименованию(Наименование, [Режим = 1], [Точность = 0])

А также альтернативный англоязычный синтаксис:

number FindByDescr(Name, [Mode = 1], [Precision = 0])

Параметры

Описание параметров метода НайтиПоНаименованию():

Имя параметра	Тип	Описание
Наименование	Строка	наименование элемента справочника
Режим	Число	режим поиска: 1 — поиск внутри установленного подчинения или родителя (значение по умолчанию) 0 — поиск во всем справочнике
Точность	Число	необходимая точность поиска: 1 — найти точное соответствие по всем символам 0 — найти неточное совпадение по первым символам (значение по умолчанию)
Жирным шрифтом выделены обязательные параметры

Описание

Метод НайтиПоНаименованию() ищет элемент справочника по наименованию. Поскольку, данный метод является позиционирующим (см. описание метода Выбран()), его можно использовать только для объектов, созданных функцией СоздатьОбъект().

Пример использования

Пример кода с использованием метода НайтиПоНаименованию():

//поиск во всем справочнике
Справочник = СоздатьОбъект("Справочник.Товары");
//во всем справочнике по точному соответствию
Если Справочник.НайтиПоНаименованию(Имя, 0, 1) = 1 Тогда
	Сообщить("Найден товар: " + Справочник.Наименование);
Иначе
	Сообщить("Упс! По имени " + Имя + " товар не найден!");
КонецЕсли;

//поиск в иерархическом справочнике
//с использованием родителя
Справочник = СоздатьОбъект("Справочник.Контрагенты");
Справочник.ИспользоватьРодителя(ВыбГруппаКонтрагентов);
//внутри группы по точному соответствию
Если Справочник.НайтиПоНаименованию(Имя, 1, 1) = 1 Тогда
	Сообщить("Найден контрагент: " + Справочник.Наименование);
Иначе
	Сообщить("Упс! По имени " + Имя + " контрагент не найден!");
КонецЕсли;

//Имя = "Стул складной"
// Найден товар: Стул складной
// Упс! По имени Стул складной контрагент не найден! 
//Имя = "Азалия"
// Упс! По имени Азалия товар не найден!
// Найден контрагент: Азалия

Читайте также:

1. Метод Справочник.НайтиЭлемент()
2. Метод Справочник.НайтиПоКоду()
3. Метод Справочник.НайтиПоРеквизиту()

Поделиться страницей в соц.сетях