配置搜索表单 configuring-search-forms
使用 搜索Forms 自定义在创作环境的各种AEM控制台和/或面板中提供的搜索面板中使用的搜索谓词选择。 自定义这些面板可根据您的特定需求使搜索功能通用。
A 谓词范围s现成可用。 您可以添加多个谓词,其中包括“属性”谓词,以搜索与您指定的单个属性匹配的资产。 或者,使用“选项”谓词来搜索与您为特定属性指定的一个或多个值匹配的资产。
您可以 配置搜索表单 用于各种控制台和资产浏览器(编辑页面时)。 此 用于配置这些表单的对话框 可以通过以下方式访问:
-
工具
-
常规
- 搜索Forms
-
首次访问此控制台时,您可以看到所有配置都有一个挂锁符号。 这表示相应的配置是默认(现成)配置 — 无法删除。 自定义配置后,锁定将消失,除非您 删除自定义配置. 在这种情况下,将恢复缺省值(和挂锁指示器)。
配置 configurations
可用的默认配置包括:
-
页面编辑器(文档搜索):
此配置定义在资产浏览器中搜索文档时(编辑页面时)可用的选项。
-
页面编辑器(图像搜索):
此配置定义在资产浏览器中搜索图像时(编辑页面时)可用的选项。
-
页面编辑器(手稿搜索):
此配置定义在资产浏览器中搜索手稿时(编辑页面时)可用的选项。
-
页面编辑器(页面搜索):
此配置定义在资产浏览器中搜索页面时(编辑页面时)可用的选项。
-
页面编辑器(段落搜索):
此配置定义在资产浏览器中搜索段落时(编辑页面时)可用的选项。
-
页面编辑器(产品搜索):
此配置定义在资产浏览器中搜索产品时(编辑页面时)可用的选项。
-
页面编辑器(Dynamic Media Classic) [以前称为Scene7] search):
此配置定义在资源浏览器中搜索Scene7资源(编辑页面时)时可用的选项。
-
站点管理员搜索边栏:
此配置定义用户在使用站点控制台的搜索边栏时可用的搜索选项。
-
页面编辑器(视频搜索):
此配置定义在资产浏览器中搜索视频时(编辑页面时)可用的选项。
-
资产管理搜索边栏:
此配置定义用户在使用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
节点(每个星号代表一个节点级别)。如果只想在具有
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
选项谓词(选项、选项属性)允许您配置要搜索的项目。 它们用于直接在页面下搜索某些内容;例如,页面节点上的属性。
以下示例(根据用于创建页面的模板进行搜索)说明了所涉及的步骤:
-
创建定义要搜索的属性的节点。
您需要一个根节点,其中包含可供用户使用的各个选项的定义。
单个选项的节点需要以下属性:
jcr:title
— 要在搜索边栏中显示的字段标签value
— 要搜索的属性值
note note NOTE Do 非 更改 /libs
路径。这是因为 /libs
下次升级实例时将被覆盖(在应用修补程序或功能包时很可能会被覆盖)。建议用于配置和其他更改的方法是: - 重新创建所需的项目,因为它存在于中
/libs
,下/apps
. 在本例中,来自: /libs/cq/gui/content/common/options/predicates
- 在中进行任何更改
/apps.
-
打开 搜索Forms 控制台并选择要更新的配置。 例如, 站点管理员搜索边栏.
然后单击 编辑搜索表单 图标。
-
根据配置,添加 选项 或 Options属性 到配置。
-
更新这些字段,特别是:
-
属性名称
指定要在目标节点上搜索的节点属性。 例如:
jcr:content/cq:template
-
选项节点路径
选择保留选项的路径。 例如:
/apps/cq/gui/content/common/options/predicates/templatetype
-
-
选择 完成 以保存您的配置。
-
导航到相应的控制台(在本例中, 站点)并打开 Search 边栏。 新定义的搜索表单以及各种选项均可见。 选择所需的选项,以便查看搜索结果:
用户权限 user-permissions
下表列出了对搜索表单执行编辑、删除和预览操作所需的权限。