Управление схемой поиска (предварительная версия)
Схема поиска определяет, как содержимое, которое будет приниматься через соединитель Microsoft Graph, используется в различных интерфейсах Microsoft Graph. Схема определяет структуру сбора содержимого из источников данных, индексирования, запроса и извлечения из индекса поиска. Изменив схему поиска, вы можете управлять тем, что пользователи могут искать, как пользователи могут искать его и как можно представить результаты в конечных точках поиска (Майкрософт).
Схема поиска содержит свойства для обхода, атрибуты поиска, семантические метки и псевдонимы. В следующих разделах будут определены различные составляющие предоставляемых возможностей схемы и управления.
Примечание.
Общие инструкции по настройке соединителей Microsoft Graph см. в статье Настройка соединителя Microsoft 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 |
Примечание.
- Для соединителей, созданных корпорацией Майкрософт, свойства обхода выбраны на шаге 4 статьи Настройка соединителя Microsoft Graph .
Атрибуты поиска
Свойство Content
Это свойство используется для полнотекстового индексирования содержимого, создания фрагмента страницы результатов поиска, участия в кластере результатов , обнаружения языка, поддержки HTML/текста, ранжирования и релевантности, а также формирования запросов.
При выборе свойства содержимого можно использовать созданное системой свойство ResultSnippet при создании типа результата. Это свойство служит заполнителем для динамических фрагментов, создаваемых из свойства содержимого во время запроса. Если вы используете это свойство в типе результата, в результатах поиска будут созданы фрагменты кода.
Возможность поиска
Если свойство доступно для поиска, его значение добавляется в полнотекстовый индекс. Когда пользователь выполняет поиск, результаты возвращаются в том случае, если поисковый запрос совпадает с одним из полей, доступных для поиска, или его контентом.
Поиск по запросу "design" с отображением результатов соответствия по свойству (title) и контенту.
Возможность запроса
Если свойство поддерживает запросы, вы можете запрашивать его с помощью языка KQL. KQL состоит из одного или нескольких ключевых слов произвольного текста (слов или фраз) или ограничений свойств. Имя свойства должно быть включено в запрос, будучи либо указанным в самом запросе, либо включаемым в запрос программно. Вы можете использовать сопоставление префиксов с помощью оператора подстановочного знака(*).
Примечание.
Сопоставление суффиксов не поддерживается.
Поиск по запросу "search ba*" с отображением результатов, соответствующих этому префиксу.
Поиск по запросу "tags:design" с определением области приводит к поимке элементов с "design" в свойстве tags .
Возможность извлечения
Если свойство можно извлечь, его значение может возвращаться в результатах поиска. Любое свойство, которое вы хотите добавить в шаблон отображения или возвращать из запроса и быть релевантным в результатах поиска, должно быть извлечено. Пометка больших или слишком большого количества свойств как извлекаемых увеличивает задержку поиска. Будьте внимательны при выборе правильных свойств.
В результате отрисовывается набор извлекаемых свойств (title и lastEditedBy).
Возможность уточнения
Примечание.
Свойства типа данных int не могут быть уточнены, даже если они помечены как уточняемые.
Если свойство можно уточнить, администратор может настроить его в качестве настраиваемого фильтра на странице результатов поиска (Майкрософт). Свойство refinable не может иметь значение searchable.
Уточнение результатов по tags, свойство с возможностью уточнения.
Примечание.
- Для соединителей, созданных корпорацией Майкрософт, атрибуты поиска выбираются на шаге 7 статьи Настройка соединителя Microsoft Graph .
Семантические метки
Семантическая метка — это известный тег, опубликованный корпорацией Майкрософт, который можно добавить для свойства в схему. Добавление семантических меток позволяет различным продуктам Майкрософт понимать свойство и обеспечивать более удобное взаимодействие.
Семантические метки предоставляют независимый от домена подход к назначению свойств из различных доменов контента набору известных классов. Они находят приложения в различных интерфейсах содержимого и обеспечивают автоматическую поддержку для таких задач, как:
- Интеграция данных в разнородных интерфейсах
- Создание графов общих знаний (например, Topics)
- Шаблоны по умолчанию для пользовательских интерфейсов
Метки обеспечивают семантическое значение и позволяют интегрировать данные соединителя в возможности Microsoft 365.
| Метка | Описание |
|---|---|
| title | Заголовок элемента, который должен отображаться в поиске и других интерфейсах. |
| url | Целевой URL-адрес элемента в источнике данных. |
| createdBy | Имя человека, создавшего элемент в источнике данных. |
| lastModifiedBy | Имя человека, который последним изменил элемент в источнике данных. |
| authors | Имена всех пользователей, которые совместно работали над элементом в источнике данных. |
| createdDateTime | Дата и время создания элемента в источнике данных. |
| lastModifiedDateTime | Дата и время последнего изменения элемента в источнике данных. |
| fileName | В случае файла — имя файла в источнике данных. |
| fileExtension | В случае файла расширение файла находится в источнике данных. |
| iconUrl | URL-адрес значка. |
Например, свойство lastEditedBy для обхода имеет то же значение, что и метка Microsoft lastModifiedBy.
Важно!
Все свойства, сопоставленные с метками, должны быть доступны для извлечения.
Метка title является самой важной меткой. Обязательно назначьте свойство этой метке, чтобы разрешить своей связи участвовать во взаимодействии с кластером результатов. Неправильное сопоставление меток ухудшает качество поиска. Для некоторых меток нормально отсутствие назначенного свойства.
Примечание.
- Для соединителей, созданных корпорацией Майкрософт, семантические метки выбираются на шаге 6 статьи Настройка соединителя Microsoft Graph .
Псевдонимы
Псевдонимы — это понятные имена свойств, которые вы назначаете. Они используются в запросах и выборках в фильтрах с уточняемыми свойствами.
Примечание.
- Для соединителей, созданных корпорацией Майкрософт, псевдонимы определяются на шаге 7 статьи Настройка соединителя Microsoft Graph .
Возможности обновления схемы
В этом разделе содержатся сведения о возможностях обновления схемы поиска соединителей, созданных корпорацией Майкрософт.
Примечание.
Рекомендуется выполнить полный обход контента после обновления, чтобы привести их к последней схеме. Без полного обхода поведение элементов будет несогласованным.
Управление схемой
- В Центр администрирования Microsoft 365 перейдите на страницу Схема в разделе Настройка.
- Щелкните Просмотреть сведения в разделе Схема соединителей Microsoft Graph.
- Выберите подключение, для которого требуется обновить схему, и нажмите кнопку Настроить схему.
- После внесения необходимых изменений в схему щелкните Опубликовать изменения схемы , чтобы опубликовать новую схему.
Добавление свойства для обхода
Вы можете добавить свойство в схему. При добавлении свойства можно включить все необходимые атрибуты поиска.
Добавьте новое исходное свойство из списка поддерживаемых свойств соединителем.
Важно!
Удалить существующее свойство для опубликованного подключения нельзя. Чтобы удалить свойство, необходимо удалить и повторно создать подключение.
Добавление и удаление возможности поиска
Вы можете добавлять или удалять определенные атрибуты поиска в свойство . Для добавления возможности поиска требуется полный обход контента.
Обновление заметок поиска для свойств для обхода
Важно!
- Из свойства нельзя удалить извлекаемый атрибут поиска.
- Нельзя добавить или удалить уточняющий атрибут поиска в свойстве.
Добавление и удаление семантической метки
Вы можете добавить или обновить сопоставление семантических меток для свойств для обхода.
Обновление семантических меток для свойств для обхода
Добавление и удаление псевдонима
Вы можете добавлять или удалять псевдонимы, а также использовать их для поисковых запросов.
Добавление или удаление псевдонима для свойств для обхода