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