配置搜索表单 configuring-search-forms
使用 搜索Forms 可以自定义搜索面板中使用的搜索谓词选择,这些面板可在各种AEM控制台和/或创作环境的面板中使用。 自定义这些面板可根据您的特定需求使搜索功能通用。
范围的谓词现成可用。 您可以添加多个谓词,其中包括“属性”谓词,以搜索与您指定的单个属性匹配的资产。 或者,使用“选项”谓词来搜索与您为特定属性指定的一个或多个值匹配的资产。
您可以配置在各种控制台和资产浏览器(编辑页面时)中使用的搜索表单。 可通过以下方式访问用于配置这些表单🔗的对话框:
-
工具
-
常规
- 搜索Forms
-
首次访问此控制台时,您可以看到所有配置都有一个挂锁符号。 这表示相应的配置是默认(现成)配置 — 无法删除。 自定义配置后,锁定将消失,除非您删除自定义配置。 在这种情况下,将恢复缺省值(和挂锁指示器)。
配置 configurations
可用的默认配置包括:
-
页面编辑器(文档搜索):
此配置定义在资产浏览器中搜索文档时(编辑页面时)可用的选项。
-
页面编辑器(图像搜索):
此配置定义在资产浏览器中搜索图像时(编辑页面时)可用的选项。
-
页面编辑器(手稿搜索):
此配置定义在资产浏览器中搜索手稿时(编辑页面时)可用的选项。
-
页面编辑器(页面搜索):
此配置定义在资产浏览器中搜索页面时(编辑页面时)可用的选项。
-
页面编辑器(段落搜索):
此配置定义在资产浏览器中搜索段落时(编辑页面时)可用的选项。
-
页面编辑器(产品搜索):
此配置定义在资产浏览器中搜索产品时(编辑页面时)可用的选项。
-
页面编辑器(Dynamic Media Classic [以前为Scene7]搜索):
此配置定义在资源浏览器中搜索Scene7资源(编辑页面时)时可用的选项。
-
站点管理员搜索边栏:
此配置定义用户在使用站点控制台的搜索边栏时可用的搜索选项。
-
页面编辑器(视频搜索):
此配置定义在资产浏览器中搜索视频时(编辑页面时)可用的选项。
-
Assets管理员搜索边栏:
此配置定义用户在使用Assets控制台时可用的搜索选项。
-
目录管理员搜索边栏:
此配置定义用户在搜索商务目录时可用的搜索选项。
-
订单管理员搜索边栏:
此配置定义用户在搜索商务订单时可用的搜索选项。
-
产品收藏集管理员搜索边栏:
此配置定义用户在搜索商务产品收藏集时可用的搜索选项。
-
产品管理员搜索边栏:
此配置定义用户在搜索商务产品时可用的搜索选项。
-
项目管理员搜索边栏:
此配置定义用户在搜索项目时可用的搜索选项。
谓词及其设置 predicates-and-their-settings
谓词 predicates
以下谓词可用,具体取决于配置:
-
常见的搜索谓词定义于:
/libs/cq/gui/components/common/admin/customsearch/searchpredicates
-
仅与站点管理员(经典UI)相关的搜索谓词位于以下位置:
/libs/cq/gui/components/siteadmin/admin/searchpanel/searchpredicates
- 这些功能已弃用,仅可用于向后兼容。
/libs
。谓词设置 predicate-settings
根据谓词,可以选择用于配置的设置:
-
字段标签
显示为可折叠标题或谓词字段标签的标签。
-
描述
用户的描述性详细信息。
-
占位符
空文本或谓词的占位符(如果未输入过滤文本)。
-
属性名称
要搜索的属性。 它使用相对路径,通配符
*/*/*
指定相对于jcr:content
节点的属性深度(每个星号表示一个节点级别)。如果只想在
jcr:content
节点上具有x
属性的资源的第一级子节点上搜索,请使用*/jcr:content/x
-
属性深度
在资源中搜索该属性的最大深度。 因此,可以对该属性进行资源搜索并递归子项,直到子项的级别等于指定的深度。
-
属性值
作为绝对字符串或表达式语言的属性值;例如,
cq:Page
或${empty requestPathInfo.suffix ? "/content" : requestPathInfo.suffix}
。 -
范围文本
日期范围 谓词中范围字段的标签。
-
选项路径
用户可以使用谓词设置选项卡中的路径浏览器选择路径。 选择 + 后,使用图标将所选内容添加到有效选项列表中(如有必要,则使用 - 图标删除)。
这些选项是由用户创建的内容节点,具有以下结构:
(jcr:primaryType = nt:unstructured, value (String), jcr:title (String))
-
选项节点路径
与 选项路径 几乎相同,只是该路径位于公共谓词字段中,其他路径专用于资产。 -
单选
如果选中,这些选项将呈现为仅允许单个选择的复选框。 如果错误地选中此复选框,则可取消选中此复选框。 -
Publish和Live Copy属性名称
站点特定谓词的发布和Live Copy复选框的标签。 -
设置 选项卡中的字段标签上的&;ast;表示这些字段是必填字段,如果保留为空,则会显示错误消息。
配置搜索Forms configuring-your-search-forms
创建/打开自定义配置 creating-opening-a-customized-configuration
-
导航到 工具 >> 常规 >> 搜索Forms。
-
选择要自定义的配置。
-
使用 编辑 图标打开配置以进行更新。
-
如果进行了新的自定义,则可能需要添加新的谓词字段并根据需要定义设置。 如果存在自定义设置,则可以选择现有字段并更新设置。
-
选择 完成 以保存配置。
note note NOTE 自定义配置存储(根据需要)在下: /apps/cq/gui/content/facets/<option>
/apps/commerce/gui/content/facets/<option>
添加/编辑谓词字段并定义字段设置 add-edit-a-predicate-field-and-define-field-settings
您可以添加或编辑字段并定义/更新其设置:
-
打开自定义配置以进行更新。
-
如果要添加字段,请打开 选择谓词 选项卡,并将所需的谓词拖到所需位置。 例如,日期范围谓词:
-
取决于是否:
-
您正在添加一个字段:
添加谓词后,设置 选项卡打开,并显示可定义的属性。
-
要更新现有的谓词:
选择谓词字段(位于右侧),然后打开 设置 选项卡。
例如,日期范围谓词 的设置:
日期范围谓词 的属性
-
-
根据需要进行更改,并通过 完成 确认。
预览搜索配置 previewing-the-search-configuration
-
选择预览图标:
-
这将显示搜索表单,它们在相应控制台的“搜索”列中显示(完全展开)。
-
关闭 预览,以便返回并完成配置。
删除谓词字段 deleting-a-predicate-field
-
打开自定义配置以进行更新。
-
选择谓词字段(位于右侧),打开 设置 选项卡,然后选择 删除 图标(左下方)。
-
此时将显示一个对话框,要求确认删除操作。
-
使用 完成 确认此更改和任何其他更改。
删除配置(恢复默认设置) deleting-a-configuration-to-reinstate-the-default
自定义配置后,这将覆盖默认值。 您可以通过删除自定义配置来恢复默认配置。
从控制台中删除自定义配置已完成:
-
选择所需的配置(例如,页面编辑器(段落搜索)),然后在工具栏中选择 删除 图标:
-
自定义配置将被删除,默认配置将恢复(控制台中挂锁符号的重新显示即表示这一点)。
添加选项谓词 adding-options-predicates
选项谓词(选项、选项属性)允许您配置要搜索的项目。 它们用于直接在页面下搜索某些内容;例如,页面节点上的属性。
以下示例(根据用于创建页面的模板进行搜索)说明了所涉及的步骤:
-
创建定义要搜索的属性的节点。
您需要一个根节点,其中包含可供用户使用的各个选项的定义。
单个选项的节点需要以下属性:
jcr:title
— 要在搜索边栏中显示的字段标签value
— 要搜索的属性值
note note NOTE 执行 不 更改 /libs
路径中的任何内容。这是因为下次升级实例时 /libs
的内容会被覆盖(在应用修补程序或功能包时很可能会被覆盖)。建议用于配置和其他更改的方法是: - 在
/apps
下重新创建所需项,因为它存在于/libs
中。 在本例中,来自: /libs/cq/gui/content/common/options/predicates
- 在
/apps.
中进行任何更改
-
打开 搜索Forms 控制台,然后选择要更新的配置。 例如,站点管理员搜索边栏。
然后单击 编辑搜索表单 图标。
-
根据配置,将 Options 或 Options属性 添加到配置中。
-
更新这些字段,特别是:
-
属性名称
指定要在目标节点上搜索的节点属性。 例如:
jcr:content/cq:template
-
选项节点路径
选择保留选项的路径。 例如:
/apps/cq/gui/content/common/options/predicates/templatetype
-
-
选择 完成 以保存您的配置。
-
导航到相应的控制台(在此示例中为 站点)并打开 搜索 边栏。 新定义的搜索表单以及各种选项均可见。 选择所需的选项,以便查看搜索结果:
用户权限 user-permissions
下表列出了对搜索表单执行编辑、删除和预览操作所需的权限。