Тип: Строка, ФорматированнаяСтрока. Описание результата поиска.
Полное описание, параметры и ограничения
ЭлементРезультатаГлобальногоПоиска.Описание (GlobalSearchResultItem.Description)
ЭлементРезультатаГлобальногоПоиска (GlobalSearchResultItem)
Описание (Description)
Доступен, начиная с версии 8.3.15.
Использование:
Чтение и запись.
Описание:
Тип: Строка, ФорматированнаяСтрока.
Описание результата поиска.
Доступность:
Тонкий клиент, веб-клиент, мобильный клиент, сервер, толстый клиент, внешнее соединение, мобильное приложение (клиент).
Примечание:
Используется при программной обработке элемента результата поиска и недоступно для пользователя.
Использование в версии:
Доступен, начиная с версии 8.3.15.
Методическая информация
Практические примеры
Собрать карточку результата поиска для учебной книги
Разделяем внутренний идентификатор, представление, описание, вид поиска и картинку. Карточка создаётся вручную, а не выдаётся за результат запроса базы.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную базу. В серверном общем модуле УчебныеЗадачи создайте процедуру ВыполнитьПример() Экспорт и вставьте в неё код одного урока. Вызовите её из серверного обработчика собственной учебной обработки.
Каждый урок создаёт новую коллекцию в памяти. Код не загружает и не сохраняет избранное пользователя, не заменяет план ГлобальныйПоиск, не запускает поиск, не открывает ссылку и не читает рабочие документы.
Для трёх уроков избранного создайте в собственной учебной конфигурации два пустых справочника УчебныеКниги и УчебныеАвторы. Учебные ссылки относятся к спискам этих объектов; записи справочников для упражнения не нужны. Право СохранениеДанныхПользователя требуется для использования избранного по справке платформы.
Карточка = Новый ЭлементРезультатаГлобальногоПоиска("guide-book", "Книга", Новый Картинка, "УчебныеКниги", "Учебный экземпляр, количество 3");
Сообщить(Карточка.Значение = "guide-book");
Сообщить(Карточка.Представление = "Книга");
Сообщить(Карточка.Описание = "Учебный экземпляр, количество 3");
Сообщить(Карточка.ВидПоиска = "УчебныеКниги");
Сообщить(ТипЗнч(Карточка.Картинка) = Тип("Картинка"));
Сообщить(Карточка.Действия.Количество() = 0);
Результаты = Новый РезультатГлобальногоПоиска;
Результаты.Добавить(Карточка);
Сообщить(Результаты.Количество() = 1);Разбор по шагам
Значение guide-book — собственный ключ. Представление Книга служит для показа, но не становится уникальным идентификатором.
ВидПоиска допускает строку для собственного поиска. Она не является автоматически зарегистрированным стандартным видом.
Пустая Картинка — настоящий платформенный объект без графического ресурса. Проверяем его тип, не обещая видимый значок.
Действия — доступная только для чтения ссылка на коллекцию: свойство не переназначаем. Сама коллекция позволяет добавлять действия в отдельном уроке.
Как проверить результат
Все семь логических проверок дают Истина; создан один результат без действий.
Не открываются карточки настоящих товаров и не запускается ГлобальныйПоиск: массив результатов заполнен собственными константами.
Ожидаемый результат
Подготовлена полноценная типизированная карточка результата с разделёнными полями.
На что обратить внимание
Конструирование карточки не доказывает поиск в базе и не проверяет права на настоящий товар.
Не храните ключи доступа в Значение, Описание или пользовательском представлении результата.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.
Вставить и найти результат по ключу, не по подписи
Два результата имеют разные ключи. Вставляем один перед другим, проверяем позиции и меняем описание только найденного элемента.
Где и как запускать
Учебная база: создайте серверный общий модуль УчебныеЗадачи (флаг Сервер). Код без директив вставьте в тело процедуры ВыполнитьПример() Экспорт. Вызовите её из серверного обработчика команды учебной обработки. Не запускайте в рабочей базе.
Подготовка
Используйте отдельную учебную базу. В серверном общем модуле УчебныеЗадачи создайте процедуру ВыполнитьПример() Экспорт и вставьте в неё код одного урока. Вызовите её из серверного обработчика собственной учебной обработки.
Каждый урок создаёт новую коллекцию в памяти. Код не загружает и не сохраняет избранное пользователя, не заменяет план ГлобальныйПоиск, не запускает поиск, не открывает ссылку и не читает рабочие документы.
Для трёх уроков избранного создайте в собственной учебной конфигурации два пустых справочника УчебныеКниги и УчебныеАвторы. Учебные ссылки относятся к спискам этих объектов; записи справочников для упражнения не нужны. Право СохранениеДанныхПользователя требуется для использования избранного по справке платформы.
Результаты = Новый РезультатГлобальногоПоиска;
Результаты.Добавить("guide-pen", "Ручка", Новый Картинка, "УчебныеКниги", "Количество 1");
Результаты.Вставить(0, "guide-book", "Книга", Новый Картинка, "УчебныеКниги", "Количество 3");
Найдено = Результаты.Найти("guide-book");
Если Найдено = Неопределено Тогда
ВызватьИсключение "Учебная книга не найдена";
КонецЕсли;
Сообщить(Результаты.Индекс(Найдено) = 0);
Сообщить(Результаты.Количество() = 2);
Сообщить(Результаты.Получить(1).Значение = "guide-pen");
Найдено.Описание = "Учебная книга: остаток 3, цена не задана";
Сообщить(Результаты.Получить(0).Описание = "Учебная книга: остаток 3, цена не задана");
Сообщить(Результаты.Найти("Книга") = Неопределено);
Сообщить(Результаты.Найти("guide-missing") = Неопределено);Разбор по шагам
Используем вариант Добавить/Вставить по параметрам, не конструктор отдельной карточки. Вставка в 0 сохраняет Ручку и сдвигает её в 1.
Найти ищет Значение, поэтому guide-book находится, а представление Книга — нет. После Неопределено нельзя читать свойства найденного объекта.
Индекс и Получить применяются к уже проверенной собственной коллекции. Сохранённый ключ устойчивее числовой позиции при перестановках.
Изменяем описание найденной карточки; повторное получение показывает новое описание этой карточки в коллекции. Не изменяем справочник или цену реального товара.
Как проверить результат
Шесть контрольных Истина, включая два отрицательных поиска.
После вставки порядок Книга, Ручка; изменение описания отражается у Книги, а не у Ручки.
Ожидаемый результат
Разобран поиск по собственному ключу, вставка и изменение объекта результата в памяти.
На что обратить внимание
Не используйте читаемую подпись как гарантированно уникальный ключ.
Отсутствие результата — нормальное Неопределено, а не повод подставить первый попавшийся элемент.
Пример не запускался в вашей базе. Перед применением проверьте его в указанном учебном контексте.