Бөлісу құралы:


Управление схемой поиска (предварительная версия)

Схема поиска определяет, как содержимое, которое будет приниматься через соединитель Graph, используется в различных интерфейсах Microsoft Graph. Схема определяет структуру сбора содержимого из источника данных, индексации, запроса и извлечения из индекса поиска. Изменив схему поиска, вы можете управлять тем, что пользователи могут искать, как пользователи могут выполнять поиск и как можно представить результаты в конечных точках поиска (Майкрософт).

Схема поиска содержит свойства для обхода, атрибуты поиска, семантические метки и псевдонимы. В следующих разделах будут определены различные составляющие предоставляемых возможностей схемы и управления.

Примечание.

Общие инструкции по настройке соединителя Graph см. в статье Настройка соединителя Graph. Шаги 6 и 7 определяют схему при настройке нового подключения.

Примечание.

Если вы хотите изменить схему поиска SharePoint Online, см. статью Управление схемой поиска в SharePoint.

Свойства для обхода

Для создания индекса поиска необходимо сначала выполнить обход контента. Вы можете сканировать различные источники контента, как указано в коллекции соединителей. Содержимое и метаданные элементов, для которых выполняется обход контента, представлены в виде свойств для обхода (или свойств источника).

Например, в следующей таблице представлены примеры свойств для обхода для системного соединителя рабочих билетов.

Свойство Тип
ticketId String
title String
createdBy String
assignedTo String
lastEditedDate DateTime
lastEditedBy String
workItemType String
priority Int64
tags StringCollection
status String
url String
resolved Boolean

Примечание.

Атрибуты поиска

Свойство Content

Это свойство используется для полнотекстового индексирования содержимого, создания фрагмента страницы результатов поиска, участия в кластере результатов , обнаружения языка, поддержки HTML/текста, ранжирования и релевантности, а также формирования запросов.

При выборе свойства содержимого можно использовать созданное системой свойство ResultSnippet при создании типа результата. Это свойство служит заполнителем для динамических фрагментов, создаваемых из свойства содержимого во время запроса. Если вы используете это свойство в типе результата, в результатах поиска будут созданы фрагменты кода.

Возможность поиска

Если свойство доступно для поиска, его значение добавляется в полнотекстовый индекс. Когда пользователь выполняет поиск, результаты возвращаются в том случае, если поисковый запрос совпадает с одним из полей, доступных для поиска, или его контентом.

Схема, показывающая, как выполняется поиск по запросу

Поиск по запросу "design" с отображением результатов соответствия по свойству (title) и контенту.

Возможность запроса

Если свойство поддерживает запросы, вы можете запрашивать его с помощью языка KQL. KQL состоит из одного или нескольких ключевых слов произвольного текста (слов или фраз) или ограничений свойств. Имя свойства должно быть включено в запрос, будучи либо указанным в самом запросе, либо включаемым в запрос программно. Вы можете использовать сопоставление префиксов с помощью оператора подстановочного знака(*).

Примечание.

Сопоставление суффиксов не поддерживается.

Схема: поиск по запросу

Поиск по запросу "search ba*", отображающий результаты, соответствующие этому префиксу.

Схема: поиск тегов:design с уточнением результатов до элементов с

Поиск по запросу "tags:design" приводит к элементам со словом "дизайн" в свойстве tags.

Возможность извлечения

Если свойство можно извлечь, его значение может возвращаться в результатах поиска. Любое свойство, которое вы хотите добавить в шаблон отображения или вернуть из запроса и показывать в результатах поиска, должно быть извлекаемым. Пометка больших или слишком большого количества свойств как извлекаемых увеличивает задержку поиска. Будьте внимательны и выбирайте нужные свойства.

Схема, показывающая набор извлекаемых свойств, отображаемых в результате.

Набор свойств, доступных для извлечения (title и lastEditedBy), отображаемый в качестве результата.

Возможность уточнения

Если свойство поддерживает уточнение, администратор может настроить его в качестве пользовательского фильтра на странице результатов Поиска (Майкрософт). Свойство refinable не может иметь значение searchable.

Схема, на которую показано уточнение результатов по тегам, уточняемому свойству.

Уточнение результатов по tags, свойство с возможностью уточнения.

Примечание.

Семантические метки

Семантическая метка — это известный тег, опубликованный корпорацией Майкрософт, который можно добавить для свойства в схему. Добавление семантических меток позволяет различным продуктам Майкрософт понимать свойство и обеспечивать более удобное взаимодействие.

Семантические метки предоставляют независимый от домена подход к назначению свойств из различных доменов контента набору известных классов. Они находят применение во множестве различных материалов и обеспечивают автоматическую поддержку таких задач, как:

  • Интеграция данных в разнородных интерфейсах
  • Создание графов общих знаний (например, Темы)
  • Шаблоны по умолчанию для пользовательских интерфейсов

Метки обеспечивают семантическое значение и позволяют интегрировать данные соединителя в возможности Microsoft 365.

Метка Описание
title Название элемента, которое вы хотите отображать в поиске и других интерфейсах.
url Целевой URL-адрес элемента в источнике данных.
createdBy Имя человека, создавшего элемент в источнике данных.
lastModifiedBy Имя человека, который последним изменил элемент в источнике данных.
authors Имена всех пользователей, которые совместно работали над элементом в источнике данных.
createdDateTime Дата и время создания элемента в источнике данных.
lastModifiedDateTime Дата и время последнего изменения элемента в источнике данных.
fileName В случае с файлом — имя файла в источнике данных.
fileExtension В случае с файлом — расширение файла в источнике данных.
iconUrl URL-адрес значка.

Например, свойство lastEditedBy для обхода имеет то же значение, что и метка Microsoft lastModifiedBy.

Важно!

Все свойства, сопоставленные с метками, должны быть доступны для извлечения.

Метка title является самой важной меткой. Обязательно назначьте свойство этой метке, чтобы разрешить своей связи участвовать во взаимодействии с кластером результатов. Неправильное сопоставление меток ухудшает качество поиска. Для некоторых меток нормально отсутствие назначенного свойства.

Примечание.

  • Для соединителей, созданных корпорацией Майкрософт, семантические метки выбираются на шаге 6 статьи Настройка соединителя Graph .

Псевдонимы

Псевдонимы — это понятные имена свойств, которые вы назначаете. Они используются в запросах и выборках в фильтрах с уточняемыми свойствами.

Примечание.

Возможности обновления схемы

В этом разделе содержатся сведения о возможностях обновления схемы поиска соединителей Graph, созданных Корпорацией Майкрософт.

Примечание.

Рекомендуется выполнить полный обход контента после обновления, чтобы привести их к последней схеме. Без полного обхода поведение элементов будет несогласованным.

Управление схемой

  1. В Центр администрирования Microsoft 365 перейдите на страницу Схема в разделе Настройка.
  2. Щелкните Просмотреть сведения в разделе Схема соединителей графа.
  3. Выберите подключение, для которого требуется обновить схему, и нажмите кнопку Настроить схему.
  4. После внесения необходимых изменений в схему щелкните Опубликовать изменения схемы , чтобы опубликовать новую схему.

Добавление свойства для обхода

Вы можете добавить свойство в схему. При добавлении свойства можно включить все необходимые атрибуты поиска.

Снимок экрана: параметр добавления нового свойства источника

Добавление нового исходного свойства из списка поддерживаемых свойств соединителем

Важно!

Удалить существующее свойство для опубликованного подключения нельзя. Чтобы удалить свойство, необходимо удалить и повторно создать подключение.

Добавление и удаление возможности поиска

Вы можете добавлять или удалять определенные атрибуты поиска в свойство . Для добавления возможности поиска требуется полный обход контента.

Снимок экрана: параметр для обновления заметок поиска

Обновление заметок поиска для свойств для обхода

Важно!

  • Из свойства нельзя удалить извлекаемый атрибут поиска.
  • Невозможно добавить или удалить атрибут уточняемого поиска в свойстве.

Добавление и удаление семантической метки

Вы можете добавить или обновить сопоставление семантических меток для свойств для обхода.

Снимок экрана: параметр для обновления семантических меток

Обновление семантических меток для свойств для обхода

Добавление и удаление псевдонима

Вы можете добавлять или удалять псевдонимы, а также использовать их для поисковых запросов.

Снимок экрана: параметр добавления или удаления псевдонима

Добавление или удаление псевдонима для свойств для обхода