Поиск в диапазоне

Элемент ищет значение в первом столбце диапазона и возвращает значение из указанного столбца найденной строки — аналог функции Excel ВПР (VLOOKUP). Для корректной работы следует поместить элемент в контейнер Microsoft 365.

Свойства

Описание общих свойств элемента см. в разделе Свойства элемента . Символ * в названии свойства указывает на обязательность его заполнения.

Свойство	Тип	Описание
Параметры:
Лист*	String	Имя листа. По умолчанию `"Sheet1"`
Книга*	DriveItem	Книга Excel. См. Общие свойства элементов
Диапазон	String	Диапазон поиска, например `"A2:D500"`. Поиск выполняется по первому столбцу диапазона. Если не заполнено — вся заполненная область листа
Колонка*	Int32	Номер столбца внутри диапазона, из которого возвращается значение. Нумерация начинается с 1 — первый столбец диапазона
Значение*	String	Искомое значение
Точное совпадение	Boolean	Если включено — ищется точное совпадение. Если выключено — ближайшее меньшее значение, первый столбец диапазона должен быть отсортирован по возрастанию. По умолчанию включено
Результат:
Результат	String	Переменная для сохранения найденного значения

Важно: Искомое значение передается как текст. Если первый столбец диапазона содержит числа (например, коды или ИНН, сохраненные как числа), совпадение не будет найдено — храните такие значения на листе в текстовом формате.

Примечание: Имя листа, содержащее пробелы, укажите в свойстве Диапазон вместе с адресом в кавычках: "'Справочник клиентов'!A2:D500".

Практический пример

Поиск e-mail менеджера по коду клиента

Лист «Справочник»: столбец A — код клиента, B — наименование, C — e-mail менеджера.

Лист: "Справочник"
Книга: book
Диапазон: "A2:C1000"
Колонка: 3
Значение: clientCode
Точное совпадение: включено
Результат: managerEmail

Возможные ошибки

Ошибка	Причина и решение
`Не указано значение` / `Не указана колонка`	Не заполнены обязательные свойства
`Sequence contains no elements`	Лист с указанным именем не найден
`#N/A` в результате или ошибка Graph	Значение не найдено в первом столбце диапазона