第 10 阶段：配置目录项页在 SharePoint 服务器上内容的搜索 Web 部件中的查询

2023-04-28

适用于： yes-img-13 2013 yes-img-16 2016 yes-img-19 2019 yes-img-se Subscription Edition no-img-sop SharePoint in Microsoft 365

注意

本系列中所述的许多功能也适用于 Microsoft 365 中的 SharePoint 中的大多数网站。

快速概述

阶段 9：在 SharePoint Server 类别页上的内容搜索 Web 部件中配置查询说明：

如何将内容搜索 Web 部件添加到页面
如何配置目录页的查询

下一步是对目录项页面执行相同的操作。

在本文中，您将了解：

开始第 10 阶段

定义目录项在 Contoso 网站的显示方式

Contoso 目录中各种产品的功能可用不同颜色表示。例如，通过查看目录列表，你将看到 Northwind Traders 50W 汽车无线电 有五种颜色可供选择。产品的颜色版本按照常见的组号进行分组。

目录汽车音频

在 Contoso 网站上显示产品时，访问者应该很容易看到该产品有其他颜色可供选择。例如，当访问者浏览到 Northwind Traders 50W 汽车无线电的银色版本时，他们应该很容易看到哪些其他颜色选项可用于该项目。他们还应该能够以其他颜色快速查看有关产品的详细信息，而无需返回到类别页面。

因此，在目录项页上，我们希望显示具有相同组号的项目。若要执行此配置，必须使用内容搜索 Web 部件 (CSWP) 。

注意

将发布网站连接到目录时自动创建的项详细信息页面，如第 5 阶段：将发布网站连接到 SharePoint Server 中的目录中所述，其中包含多个目录项重用 Web 部件 (CIRWP) 。使用 CIRWP 显示项目详细信息内容的方案是合适的。但是，由于 CIRWP 只能一次显示一个项目，我们无法在 Contoso 方案中使用此 Web 部件。

有关如何使用 CIRWPs 自定义自动创建的目录项页面的信息，请参阅如何：在 SharePoint 2013 中自定义基于目录的网站的页面布局。

如何将内容搜索 Web 部件添加到目录项页面

浏览到目录项页面。在我们的方案中，在"音频"类别中单击"Northwind Traders 50W 汽车收音机"。

单击类别页面

由于在阶段 7：在 SharePoint Server 的发布网站中上传页面布局和创建新页面时，我们没有向页面添加任何 Web 部件，因此此页面不显示任何内容。

目录项页面只有一个 Web 部件区域。要将 CSWP 添加到目录项页面，请重复如何将内容搜索 Web 部件添加到页面中的步骤，将 Web 部件添加到区域 1。

添加的 CSWP

与向类别页添加 CSWP 时的情况一样，Web 部件仅显示音频、相机和计算机等内容，而不显示我们想要的内容。要是 Web 部件显示 Contoso 目录内容，我们必须在 Web 部件中配置查询。要配置查询，我们要使用所谓的查询变量。但是首先，让我们了解什么是查询变量以及如何使用它们来配置查询。

关于查询变量

查询变量是一个占位符，运行查询时将其替换为一个值。让我们在 Contoso 方案的上下文中了解这个定义。

你可能没有意识到这一点，但在阶段 9：在 SharePoint Server 类别页上的内容搜索 Web 部件中配置查询时，我们在目录页上的 CSWP 中配置查询时使用了查询变量。当我们选择了 按当前导航和子导航术语限制 ，则将一个查询变量添加到了查询中。该查询变量是 URL 中导航值的占位符，例如音频、相机或 mp3。每当访问者单击类别时，Web 部件中的查询变量会替换为 URL 中的导航值。因此，Web 部件对标记有“audio”、“camera”、“mp3”等标记的目录项发出查询。

回到目录项页面，我们想要显示具有相同组号的项目。请记住，在阶段 3：如何在 SharePoint Server 中启用列表作为目录，如何将 组编号 添加为要用作 目录项 URL 字段的列表列之一。我们进行了此配置，以便在 URL 中使用 “组编号 ”的值。

以下屏幕截图显示了最终的 Contoso 站点。请注意，组号 5637145950 被用作 URL 中的倒数第二个值。

项目汽车音频

如果我们浏览到另一个产品，我们将看到此产品的组号 (5637145875，例如，) 也用作 URL 中的第二个值。

项目摄像机

因此，当在目录项页面上配置 CSWP 的查询时，您应该使用在 URL 中代表倒数第二个值的查询变量。

查询变量包含在如下所示的花括号内：{QueryVariable}。不必担心这些大括号，此语法并不像看起来那么可怕或复杂。

如上所述，当在目录页面的 CSWP 中配置查询时，我们使用了查询变量。但是，我们不必处理任何可怕的大括号，因为漂亮的单选按钮， 限制当前和子导航术语，为我们照顾它。要配置项目目录页面的查询，我们必须添加带有花括号的查询变量。幸运的是，还有一些友好的下拉菜单可帮助我们。因此，让我们深入探讨配置查询的任务。

如何在目录项页面的内容搜索 Web 部件中配置查询

在 Web 部件中，选择“ Web 部件 ”菜单 >“编辑 Web 部件”。
在 Web 部件工具窗格中，选择“更改查询”。此选项将打开一个对话框。
在对话框中，从“选择查询”列表，选择目录结果源。在我们的方案中，这是“目录 - 产品结果”。
选择“ 切换到高级模式”。

In Advanced Mode, in the Query text field, you'll see some text. 此文本是表示结果源 目录 - 产品结果的查询文本。 (我们在阶段 9 中查看了如何查看查询配置的详细信息时看到相同的查询文本。)

来自特定网站的搜索结果

在"属性筛选器"列表中，选择"显示所有托管属性"。
在"属性筛选器"列表中，选择"ProductCatalogGroupNumberOWSTEXT"、"包含" 和"URL 标记值"。

ProductCatalogGroupNumberOWSTEXT 是网站栏“ 组编号”的托管属性名称。 (在本系列的前面部分，我们在“产品”列表中的默认网站栏命名约定中查看了此列的命名约定。) 从 URL 选择令牌的“包含”和“值”将创建要使用的查询变量。

选择 “添加属性筛选器”。

Notice that ProductCatalogGroupNumberOWSTEXT:{URLToken.1} is added to the Query text field. So without having to know about query syntax or type a curly bracket, we have added a query variable.

现在你可能在想“好吧，这很简单，但 ProductCatalogGroupNumberOWSTEXT：{URLToken.1} 实际上是什么意思？”让我们来分解一下：

ProductCatalogGroupNumberOWSTEXT 是托管属性，代表着目录中的组号列。
冒号：表示“包含”
{URLToken.1} 代表当前页面 URL 的值。在 1 的情况下，整数表示 URL 中的值（从右到左计数）。因此，例如，在 URL https://www.contoso.com/cameras/camcorders/563714875/6637146586中，查询变量 {URLToken.1} 表示 值6637146586。

如果将完整查询放在一起，则意味着：

从结果源“目录 - 产品结果”，搜索项目，其中托管属性 ProductCatalogGroupNumberOWSTEXT 的值包含当前作为 URL 第一个值（从右到左计数）使用的值。

在阶段 3：如何在 SharePoint Server 中启用列表作为目录的过程的最后一个步骤中，我们定义了项目 URL 应同时包含“组编号”和“项编号”作为目录项和 URL 字段。这意味着 URL 中的第一个值（从右到左）是 “项编号”。我们希望搜索具有相同组号的项目。因此，我们必须对查询变量进行小更改。