Получает элемент коллекции.
Синтаксис
Найти(<Значение>)Найти(<ИмяПроцедуры>, <Модуль>)Полное описание, параметры и ограничения
ПланГлобальногоПоиска.Найти (GlobalSearchPlan.Find)
ПланГлобальногоПоиска (GlobalSearchPlan)
Найти (Find)
Доступен, начиная с версии 8.3.15.
Вариант синтаксиса: По виду поиска
Синтаксис:
Найти(<Значение>)
Параметры:
<Значение> (обязательный)
Тип: СтандартныйВидГлобальногоПоиска.
Вид стандартного поиска.
Вариант синтаксиса: По обработчику
Синтаксис:
Найти(<ИмяПроцедуры>, <Модуль>)
Параметры:
<ИмяПроцедуры> (обязательный)
Тип: Строка.
Имя экспортной процедуры общего модуля.
<Модуль> (обязательный)
Тип: Строка.
Имя общего модуля.
Возвращаемое значение:
Тип: ЭлементПланаГлобальногоПоиска, Неопределено.
Указанный элемент плана глобального поиска.
Неопределено - если такой элемент не найден.
Описание:
Получает элемент коллекции.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, толстый клиент, внешнее соединение, мобильное приложение (клиент).
Использование в версии:
Доступен, начиная с версии 8.3.15.
Методическая информация
Практические примеры
Убрать маршруты из собственного плана и проверить отсутствие
Разбираем удаление стандартного вида, обработчика по паре имён и пункта по индексу, не отключая реальный поиск приложения.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную базу. В серверном общем модуле УчебныеЗадачи создайте процедуру ВыполнитьПример() Экспорт и вставьте в неё код одного урока. Вызовите её из серверного обработчика собственной учебной обработки.
Каждый урок создаёт новую коллекцию в памяти. Код не загружает и не сохраняет избранное пользователя, не заменяет план ГлобальныйПоиск, не запускает поиск, не открывает ссылку и не читает рабочие документы.
Для трёх уроков избранного создайте в собственной учебной конфигурации два пустых справочника УчебныеКниги и УчебныеАвторы. Учебные ссылки относятся к спискам этих объектов; записи справочников для упражнения не нужны. Право СохранениеДанныхПользователя требуется для использования избранного по справке платформы.
План = Новый ПланГлобальногоПоиска;
План.Добавить(СтандартныйВидГлобальногоПоиска.Справка, 10);
План.Добавить("НайтиУчебныеКниги", "УчебныйГлобальныйПоиск", Истина, Ложь, 20);
План.Добавить(СтандартныйВидГлобальногоПоиска.МенюФункций, 30);
План.Удалить(СтандартныйВидГлобальногоПоиска.Справка);
План.Удалить("НайтиУчебныеКниги", "УчебныйГлобальныйПоиск");
Сообщить(План.Количество() = 1);
Сообщить(План.Найти(СтандартныйВидГлобальногоПоиска.Справка) = Неопределено);
Сообщить(План.Найти("НайтиУчебныеКниги", "УчебныйГлобальныйПоиск") = Неопределено);
Если План.Количество() = 1 Тогда
Сообщить(План.Получить(0).ВидПоиска = СтандартныйВидГлобальногоПоиска.МенюФункций);
План.Удалить(0);
КонецЕсли;
Сообщить(План.Количество() = 0);
План.Добавить(СтандартныйВидГлобальногоПоиска.Справка);
План.Очистить();
Сообщить(План.Количество() = 0);Разбор по шагам
Метод Добавить поддерживает стандартный вид либо параметры обработчика. Не присваиваем его результат: описание возвращаемого значения в локальной справке плана не заявлено.
Удалить принимает разные варианты: стандартный вид, пару имя процедуры/модуль, индекс или сам элемент. В упражнении три способа имеют очевидно разные типы аргументов.
После удаления проверяем Найти на Неопределено. Обращение к Получить(0) происходит только при количестве 1.
Последняя очистка удаляет заново добавленный пункт собственного плана. Менеджер ГлобальныйПоиск не вызывается.
Как проверить результат
Шесть контрольных Истина. После первых удалений остаётся только МенюФункций.
Основное окно не меняет состав реального поиска: ни пустой, ни сокращённый план не устанавливался.
Ожидаемый результат
Разобраны перегрузки удаления и очистка собственного плана.
На что обратить внимание
Не очищайте установленный план рабочего приложения для проверки сигнатуры метода.
Пара имя процедуры/модуль должна совпадать целиком: одинаковые имена процедур в разных модулях — разные маршруты.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Подготовить описание собственного обработчика поиска
Настраиваем маршрут к экспортной процедуре и дополнительные параметры. Описание не регистрируется в менеджере и само процедуру не выполняет.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную базу. В серверном общем модуле УчебныеЗадачи создайте процедуру ВыполнитьПример() Экспорт и вставьте в неё код одного урока. Вызовите её из серверного обработчика собственной учебной обработки.
Каждый урок создаёт новую коллекцию в памяти. Код не загружает и не сохраняет избранное пользователя, не заменяет план ГлобальныйПоиск, не запускает поиск, не открывает ссылку и не читает рабочие документы.
Для трёх уроков избранного создайте в собственной учебной конфигурации два пустых справочника УчебныеКниги и УчебныеАвторы. Учебные ссылки относятся к спискам этих объектов; записи справочников для упражнения не нужны. Право СохранениеДанныхПользователя требуется для использования избранного по справке платформы.
План = Новый ПланГлобальногоПоиска;
Параметры = Новый Структура("Префикс", "guide-");
Обработчик = Новый ЭлементПланаГлобальногоПоиска("НайтиУчебныеКниги", "УчебныйГлобальныйПоиск", Истина, Ложь, 10, Параметры);
План.Добавить(Обработчик);
Найдено = План.Найти("НайтиУчебныеКниги", "УчебныйГлобальныйПоиск");
Если Найдено = Неопределено Тогда
ВызватьИсключение "Описание обработчика не найдено";
КонецЕсли;
Сообщить(Найдено.ВидПоиска = Неопределено);
Сообщить(Найдено.ИмяПроцедуры = "НайтиУчебныеКниги");
Сообщить(Найдено.Модуль = "УчебныйГлобальныйПоиск");
Сообщить(Найдено.НаСервере);
Сообщить(Найдено.Фоновый = Ложь);
Сообщить(Найдено.Порядок = 10);
Сообщить(Найдено.ДополнительныеПараметры.Префикс = "guide-");Разбор по шагам
Первые два аргумента — имена экспортной процедуры и общего модуля, не текст BSL для исполнения и не навигационная ссылка.
НаСервере=Истина и Фоновый=Ложь задают маршрут обычного серверного выполнения, если этот план впоследствии установить и запустить. Здесь это только описание.
ДополнительныеПараметры — собственная Структура. Неопределённые поля нельзя без проверки трактовать как структуру в обработчике.
Для реального запуска вручную создайте общий модуль УчебныйГлобальныйПоиск с серверным флагом и процедуру НайтиУчебныеКниги(СтрокаПоиска, РезультатыПоиска, ДополнительныеПараметры) Экспорт. Её самостоятельный полный пример приведён в отдельном уроке.
Конструктор и поиск описания не являются проверкой существования, прав и работоспособности экспортной процедуры.
Как проверить результат
Семь контрольных Истина, включая отсутствие стандартного вида и собственный префикс.
Фоновое задание не создано, процедура по строковому имени не вызывалась, план интерфейса не изменился.
Ожидаемый результат
Подготовлен проверяемый черновик маршрута собственного обработчика.
На что обратить внимание
Не считайте создание описания доказательством исполнения обработчика.
Не передавайте секреты в дополнительные параметры, выводимые в диагностических сообщениях.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.