Настройка поиска для SharePoint
Следующая страница относится к классическим сайтам SharePoint Online. Эти функции не поддерживаются в современных SharePoint сайтах. Чтобы реализовать аналогичные функции в современной SharePoint просмотреть современные веб-части поиска PnP по:https://microsoft-search.github.io/pnp-modern-search/
Создайте настраиваемые SharePoint и SharePoint сценарии поиска в Интернете с помощью каталога сайтов на основе поиска, персонализированных результатов поиска или переносимости конфигурации поиска.
Каталог сайтов на основе поиска
SharePoint поиск позволяет создавать каталог сайтов на основе поиска без написания настраиваемого кода.
Создание каталога сайтов:
- Создание шаблонов отображения каталога сайтов.
- Определите тип результатов каталога сайтов.
- Создание страницы результатов.
- Изменение свойств веб-части "Результаты".
В следующей процедуре используются шаблоны отображения, связанные с сайтом, без изменений. Если вы хотите изменить отображение результатов каталога сайтов, измените шаблоны отображения, которые вы создаете.
Создание шаблонов отображения каталога сайтовОткройте на карте сетевой диск в галерее Master Page. Дополнительные сведения см. в странице Map a network drive to the SharePoint Master Page Gallery.
Сделайте копии HTML-файлов шаблона отображения, которые лучше всего отображают то, что вы пытаетесь сделать. Для сценария каталога сайтов это будут пунктыSite.html _ и Item _Site_HoverPanel.html. Оба файла находятся в папке \Display Templates\Search на сетевом диске.
Переименуй копии файлов Item _SiteDirectory.html и ItemSiteDirectory_HoverPanel.html как _ показано.
Откройте файл _ ItemSiteDirectory.html и внести следующие изменения:
- Измените <title> значение тега с Элемента сайта на каталог сайта.
- Измените первый <div> тег после открытия <body> тега на <div > <div > .
- Измените имя файла javaScript шаблона отображения панели наведите var hoverUrl = "
sitecollection/_catalogs/masterpage/Display Templates/Search/Item_Site_HoverPanel.js"; на var hoverUrl = "
Откройте файл _ ItemSiteDirectory_HoverPanel.html и внести следующие изменения:
- Измените <div> тег после <body> открываемой метки <title>Site Hover Panel Test</title> на <title>Site Directory Hover Panel</title> .
- Измените <title> тег <div > на <div > .
Перейдите к Параметры типов результатов > > поиска, а затем выберите новый тип результатов.
Назови новый тип результатов Basic Site Directory.
В поле Как должны выглядеть эти результаты? выберите каталог сайтов.
Выберите Сохранить.
Создание страницы результатов- В меню Параметры сайта выберите содержимое сайта.
- Выберите элемент Страницы.
- В библиотеке "Страницы" выберите страницу "Файлы > новые > документы".
- На странице Создание страницы укажите каталог сайтов для title и sitedirectory для URL-адреса.
- Нажмите кнопку Создать.
На странице Каталог сайтов выберите Параметры > изменить страницу.
В веб-части Результаты поиска выберите меню веб-части, а затем выберите изменить веб-часть.
В области средств веб-части выберите запрос Изменить, чтобы открыть конструктор запросов.
В текстовом поле Запрос введите следующее: ContentClass:STS_Web OR ContentClass:STS_Site path:http://<YourServer>
Выберите тестовый запрос, чтобы подтвердить правильность синтаксиса. В области предварительного просмотра результатов поиска должны отображаться подвиды на сайте, указанном для пути в тексте Запроса.
Выберите ОК, чтобы закрыть конструктор запросов.
В шаблонах отображения выберите типы результатов для отображения элементов.
Выберите базовый каталог сайтов в типе Result для списка элементов.
В разделе Внешний вид измените название на сайты, к которые у меня есть доступ.
Выберите ОК, чтобы сохранить изменения в веб-части и закрыть панели инструментов веб-части.
На следующем рисунке показан пример страницы каталога сайтов на основе поиска.
Персонализированные результаты поиска
Персонализированный поиск — это когда вы показываете результаты поиска, нацеленные на пользователя, который отправил запрос на поиск. В этом разделе описаны некоторые сценарии персонализированного поиска и возможные их реализация.
Сценарий новостейВ этом сценарии создается надстройка поиска, которая отображает релевантный контент, например новости и события, целевые для пользователя.
Персонализированный сценарий поиска новостейЧтобы реализовать сценарий новостей, используйте веб-SharePoint результатов поиска и шаблоны отображения по умолчанию для отображения сведений о новостях, включая заголовки, описание и отображение. Покажите первые десять элементов новостей. Когда пользователь выбирает ссылку на обкатку, заголовок или ссылку Read More, страница статьи новостей загружается.
Кроме того, можно создать надстройку поиска с помощью API запроса (CSOM или REST). Количество элементов новостей можно настроить с помощью свойств надстройки поиска.
Другим вариантом является использование API запроса для добавления кода API запроса, который извлекает результаты поиска непосредственно в макет страницы.
Отображение сведений о новостях и событиях, определенных пользователю- Измените запрос, чтобы фильтровать результаты новостей и событий на основе свойств профилей пользователей, таких как бизнес-подразделение, регион и язык.
- Извлечение свойств Title, Description, rollup и URL-адресов для элементов новостей или событий.
- Реализуем логику сортировки комбинированных новостей и событий на основе свойства LastModifiedDate.
В этом сценарии надстройка поиска отображает соответствующие события, нацеленные на пользователя.
Персонализированный сценарий поиска предстоящих событийЧтобы реализовать этот сценарий, можно настроить веб-часть SharePoint результатов поиска, чтобы изменить запрос, чтобы получить только сведения о предстоящих событиях. Для этого укажите текст запроса ContentClass:STS_ListItem_Events веб-части. Чтобы изменить отображение результатов событий, создайте настраиваемые шаблоны отображения для отображения сведений о событии.
Вы можете изменить шаблон отображения элемента, чтобы при выборе пользователем ссылки изображения, заголовка или дополнительных сведений загружалась страница информации о событиях. Вы также можете изменить шаблон отображения управления так, чтобы при выборе пользователя см. далее, в веб-части отображаются результаты следующих десяти событий.
Можно также создать надстройка поиска, которая использует API запроса для получения результатов событий. Вы можете настроить надстройку поиска, чтобы по умолчанию показывать только десять последних предстоящих событий, но сделать этот параметр настраиваемым с помощью свойств надстройки поиска.
Сценарий рекомендуемой новостиВ этом сценарии надстройка поиска отображает результаты поиска в качестве рекомендуемого контента, целевого для пользователей в таких местах, как корпоративная интрасеть и раздельные целевые страницы. Это можно реализовать с помощью надстройки, содержащем подключаемый модуль jQuery с HTML, который использует службу REST поиска или запрос CSOM для получения результатов поиска из SharePoint и отображения результатов.
Пример кода для персонализированного поискаВ примере надстройки SharePoint персонализация результатов поиска показан базовый пример поиска и персонализированный пример результатов поиска с использованием CSOM запроса поиска. Базовый пример поиска позволяет пользователю предоставлять фильтр поиска для поиска по всем пользователям. Поиск сайтов ведется на основе этого фильтра, предоставленного пользователем.
В примере сначала SharePoint контекст с помощью класса SharePointContextProvider.
Далее он создает запрос на основе того, что вошел пользователь. Он ограничивает запрос коллекциями сайтов, а затем вызывает метод ProcessQuery, передав контекст и запрос в вызов метода. Затем возвращается таблица результатов ProcessQuery, которая затем обрабатывается методом FormatResults.
Метод ProcessQuery создает объект KeywordQuery, представляюющий поисковый запрос.
Затем поисковый запрос SharePoint по вызову метода ExecuteQuery_Client запроса. Результаты возвращаются объекту ClientResult<> T.
Метод FormatResults итерирует результаты и строит HTML-таблицу для отображения значений результатов.
Метод ResolveAdditionalFilter проверяет "Apptest". Если он найден, в результатах поиска возвращается список шаблонов сайтов любого типа. Если он не найден, в результатах поиска возвращаются только веб-шаблоны STS.
Затем в этом примере строится запрос и вызывается метод ProcessQuery и FormatResults для получения, формата и отображения результатов поиска.
Пользовательский интерфейс для этого примера см. в следующем рисунке.
Переносимость конфигурации поиска
В SharePoint и SharePoint Online можно экспортировать и импортировать настраиваемые параметры конфигурации поиска между коллекциями сайтов и сайтами. Экспортировать настраиваемые параметры конфигурации поиска можно только на уровне приложения-службы поиска (SSA), и для этого необходимо использовать API поиска. Вариант экспорта не доступен в пользовательском интерфейсе SharePoint.
Параметры поиска по импорту и экспорту для SharePoint Online показывают, как импортировать и экспортировать параметры поиска для сайта SharePoint Online с помощью CSOM поиска в приложении консоли.
Переносные параметры конфигурацииПри экспорте настраиваемых параметров конфигурации поиска SharePoint файл конфигурации поиска в формате XML. Этот файл конфигурации поиска включает все экспортируемые настраиваемые параметры конфигурации поиска на уровне SSA, уровне коллекции сайтов или на уровне сайта, откуда начинается экспорт. Файл конфигурации поиска для семейства веб-сайтов, например, не содержит параметры конфигурации настраиваемого поиска для отдельных сайтов в семействе.
При импорте файла конфигурации поиска SharePoint и включает каждый настраиваемый параметр конфигурации поиска в коллекции сайта или сайте, откуда начинается импорт.
В следующей таблице перечислены параметры, которые можно экспортировать и импортировать, а также любые зависимости от других настраиваемых параметров конфигурации поиска. Если настраиваемые параметры конфигурации поиска зависят от настраиваемого параметра конфигурации поиска на другом уровне, необходимо экспортировать и импортировать параметры на всех соответствующих уровнях.
Параметры поиска, которые можно экспортировать и импортировать Параметр конфигурации Зависимости Правила запросов, включая блоки результатов, продвигаемые результаты и сегменты пользователей Источники результатов, типы результатов, схема поиска, модель ранжирования Источники результатов Схема поиска Типы результатов Схема поиска, источники результатов, шаблоны отображения Схема поиска Нет Модель ранжирования Схема поискаВы можете экспортировать настраиваемые параметры конфигурации поиска из SSA и импортировать параметры в коллекции и сайты сайтов. Но вы не можете импортировать настраиваемые параметры конфигурации поиска в SSA. Вы также не можете экспортировать параметры конфигурации поиска по умолчанию.
На уровне веб-сайта или коллекции сайтов можно экспортировать или импортировать параметры конфигурации поиска с помощью SharePoint пользовательского интерфейса. Эти параметры находятся в разделе Поиск страницы Параметры сайта.
Эти параметры также доступны в разделе Администрирование коллекций сайтов. Кроме того, можно программным образом импортировать и экспортировать эти параметры с помощью SharePoint поиска CSOM.
Файлы конфигурации поискаВ следующей таблице перечислены файлы схемы, поддерживаюные конфигурацию поиска. Сведения о формате схемы см. в SharePoint параметров переносимости поиска.
Схемы переносимости параметров поиска Схема Описание SPS15XSDSearchSet1 Указывает XML, который представляет источники результатов. SPS15XSDSearchSet2 Указывает XML, представляющем административные типы и членов для управления экземпляром поиска SSA. Это включает типы элементов результатов и параметры правил свойств. SPS15XSDSearchSet3 Указывает XML, который представляет параметры, которые включают правила запроса, источники результатов, управляемые свойства, свойства обхода и модели ранжирования. SPS15XSDSearchSet4 Указывает XML, который представляет собой переумерия, используемые в других схемах. SPS15XSDSearchSet5 Указывает XML, который представляет такие переумены, как ResultType, которые используются в других схемах. SPS15XSDSearchSet6 Указывает XML, который представляет собой переумерия, используемые в Microsoft.Office. Схема Server.Search.Administration. Использование CSOM для параметров конфигурации портаAPI CSOM, необходимые для импорта и экспорта параметров конфигурации поиска, находятся в классе SearchConfigurationPortability в Microsoft.SharePoint. Пространство имен Client.Search.Portability.
В следующем примере кода показано, как экспортировать параметры конфигурации поиска на сайте.
В следующем коде показано, как импортировать параметры конфигурации поиска на сайте.