Поиск в SharePoint Online. Использование Office Graph

Описание реализации примера использования Office Graph для поиска информации на сайте SharePoint Online с учетом действий пользователей, который я показывал в своем докладе о Microsoft Graph на DevCon 2016.

Graph Query Language (GQL)

Office Graph собирает информацию о действиях пользователей (просмотр профиля, создание/редактирование/чтение документов, отправка и получение сообщений, комментарии, лайки, ответы и отслеживания) и строит связи между объектами в облаке. Эта информация хранится в поисковом индексе, продолжительность хранения определяется типом совершенного пользователем действия. Таким образом мы получаем граф, построенный на данным, хранящихся в Office 365. Визуально это выглядит примерно следующим образом (вершина - голубого цвета - пользователь, зеленого - документ):

Поскольку информация хранится в поисковом индексе, то и получить её можно с помощью API поиска SharePoint. Для доступа к данным графа существует специально созданный для это Graph Query Language (GQL). Синтаксис его следующий:

ACTOR({ActorId} [, filter])

Где ActorId - идентификатор пользователя. Он полностью соответствует свойству DocId.

В строке запроса к API поиска для поиска документов, измененных пользователем (action:1003) GQL выглядит вот так:

_api/search/?Querytext='*'&Properties='GraphQuery:ACTOR({ActorId}\, action\:1003)'

Для примера использования Office Graph в SharePoint Online я создам страницу результатов для поиска среди документов, которые текущий пользователь просматривал или редактировал.

Создание страницы поиска

В центре поиска создаем новую страницу:

Вводим название страницы, например "viewedormodified":

Чтобы эта страница появилась под строкой ввода поискового запроса необходимо добавить ссылку на неё в параметрах поиска (Параметры сайта - Параметры поиска):

Добавляем ссылку на созданную страницу:

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

Настройка веб-части результатов поиска

Для начала на созданной странице экспортируем существующую веб-часть результатов поиска и получаем XML-файл в формате .webpart:

Исходную веб-часть результатов поиска можно удалить - она нам больше не понадобится.

Открываем .webpart в любом текстовом редакторе. Нас интересует единственное свойство - DataProviderJSON:

<webParts>
    <webPart xmlns="http://schemas.microsoft.com/WebPart/v3">
    <!--metaData -->
    <data>
      <properties>
        <!-- properties -->
        <property name="DataProviderJSON" type="string">{JSON}</property>
        <!-- properties -->
      </properties>
    </data>
  </webPart>
</webParts>

Свойство DataProviderJSON содержит параметры в формате JSON. Использование Office Graph задается именно в нем. Для этого добавляем свойство GraphQuery в раздел Properties и ровно такое же в раздел PropertiesJson. Результат должен быть примерно следующим:

{
  "Properties": {
    "GraphQuery": "ACTOR(ME, OR(action:1001, action:1003))",
    "ListId": "b4592971-f45e-41ac-8330-ca34b61834a4",
    "ListItemId": 10,
    "TermId": "79334302-07c2-4c37-9bfb-7b64bdd64877",
    "TermSetId": "f4e59d91-7c8a-4d1c-b346-fd6caef3a64a",
    "TermStoreId": "fd4146d3-7c5a-4c73-9e85-657646eab417"
  },
  "PropertiesJson": "{\"GraphQuery\":\"ACTOR(ME, OR(action:1001, action:1003))\",\"ListId\":\"b4592971-f45e-41ac-8330-ca34b61834a4\",\"ListItemId\":10,\"TermId\":\"79334302-07c2-4c37-9bfb-7b64bdd64877\",\"TermSetId\":\"f4e59d91-7c8a-4d1c-b346-fd6caef3a64a\",\"TermStoreId\":\"fd4146d3-7c5a-4c73-9e85-657646eab417\"}",
  "ClientType": "AllResultsQuery",
  "UpdateAjaxNavigate": true,
  "SummaryLength": 180,
  "DesiredSnippetLength": 90,
  "PersonalizedQuery": false,
  "FallbackRefinementFilters": null,
  "IgnoreStaleServerQuery": true,
  "RenderTemplateId": "DefaultDataProvider",
  "AlternateErrorMessage": null,
  "Title": "",
  "ClientFunction": "",
  "ClientFunctionDetails": ""
}

Сохраняем изменения и добавляем на страницу веб-часть, используя импорт:

Готово

Теперь пользователи смогут искать на портале документы, связанные с ними. Аналогично можно реализовать поиск среди коллег, с которыми они работают.

Смотрите также

Query the Office Graph using GQL and SharePoint Online Search REST APIs

Презентация с доклада о Microsoft API и Office Graph