配置搜索表单 configuring-search-forms

CAUTION
AEM 6.4已结束扩展支持,本文档将不再更新。 有关更多详细信息,请参阅 技术支助期. 查找支持的版本 此处.

使用 搜索Forms 自定义在各种AEM控制台和/或创作环境面板的搜索面板中使用的搜索谓词的选择。 自定义这些面板可根据您的特定需求来通用搜索功能。

A 谓词范围提供现成可用。 您可以添加多个谓词,包括(其中包括)属性谓词,用于搜索与您指定的单个属性匹配的资产,或者使用选项谓词,用于搜索与您为特定属性指定的一个或多个值匹配的资产。

您可以 配置搜索表单 在各种控制台和资产浏览器(编辑页面时)中使用。 的 用于配置这些表单的对话框 可通过以下方式访问:

  • 工具

    • 常规

      • 搜索表单

首次访问此控制台时,您可以看到所有配置都有一个挂锁符号。 这表示相应的配置是默认(现成)配置,无法删除。 自定义配置后,锁将消失 — 除非您 删除自定义配置,此时将恢复默认值(和挂锁指示器)。

chlimage_1-374

配置 configurations

可用的默认配置包括:

  • 页面编辑器(文档搜索):

    此配置定义在资产浏览器中搜索文档(编辑页面时)时可用的选项。

  • 页面编辑器(图像搜索):

    此配置定义在资产浏览器中搜索图像(编辑页面时)时可用的选项。

  • 页面编辑器(手稿搜索):

    此配置定义在资产浏览器中搜索手稿(编辑页面时)时可用的选项。

  • 页面编辑器(页面搜索):

    此配置定义在资产浏览器中搜索页面(编辑页面时)时可用的选项。

  • 页面编辑器(段落搜索):

    此配置定义在资产浏览器中搜索段落(编辑页面时)时可用的选项。

  • 页面编辑器(产品搜索):

    此配置定义在资产浏览器中搜索产品(编辑页面时)时可用的选项。

  • 页面编辑器(Dynamic Media Classic [前Scene7] 搜索):

    此配置定义在资产浏览器中搜索Dynamic Media Classic资源(编辑页面时)时可用的选项。

  • 站点管理员搜索边栏:

    此配置定义了在使用站点控制台的搜索边栏时用户可用的搜索选项。

  • 页面编辑器(视频搜索):

    此配置定义在资产浏览器中搜索视频(编辑页面时)时可用的选项。

  • 资产管理员搜索边栏:

    此配置定义了在使用资产控制台时用户可用的搜索选项。

  • 目录管理员搜索边栏:

    此配置定义用户在搜索商务目录时可用的搜索选项。

  • 订单管理员搜索边栏:

    此配置定义用户在搜索商务订单时可用的搜索选项。

  • 产品收藏集管理员搜索边栏:

    此配置定义用户在搜索商务产品收藏集时可用的搜索选项。

  • 产品管理员搜索边栏:

    此配置定义用户在搜索商务产品时可用的搜索选项。

  • 项目管理员搜索边栏:

    此配置定义用户在搜索项目时可用的搜索选项。

谓词及其设置 predicates-and-their-settings

谓语 predicates

以下谓词可用,具体取决于配置:

谓词
用途
设置
分析
显示分析支持的数据时,站点浏览器中的搜索/过滤功能。 加载Analytics搜索过滤器以匹配映射的自定义分析列。
  • 字段标签
  • 描述
上次修改的资源
上次修改资产的日期。
基于“日期谓词”的自定义谓词。
组件
允许作者搜索/过滤页面上具有特定组件的页面。 例如,图像库。
  • 字段标签
  • 占位符
  • 属性名称*
  • 属性深度
  • 描述
日期
基于滑块的基于日期属性的资产搜索。
  • 字段标签
  • 属性名称*
  • 描述
日期范围
搜索在日期属性的指定范围内创建的资产。 在“搜索”面板中,您可以指定开始和结束日期。
  • 字段标签
  • 占位符
  • 属性名称*
  • 范围文本(从)*
  • 范围文本(至)*
  • 描述
到期状态
根据到期状态搜索资产。
  • 字段标签
  • 属性名称*
  • 描述
文件大小
根据资产的大小搜索资产。
  • 字段标签
  • 属性名称*
  • 选项路径
  • 描述
隐藏的筛选器
属性和值的过滤器,用户不可见。
  • 属性名称
  • 属性值
  • 描述
选项

选项是用户创建的内容节点。

请参阅 添加选项谓词 以了解更多信息。

  • 字段标签
  • JSON 路径
  • 属性名称*
  • 单选
  • 选项路径
  • 描述
选项 属性
搜索选项的属性。
  • 字段标签
  • 属性名称*
  • 选项节点路径
  • 单选
  • 描述
页面状态
根据页面的状态搜索页面。
  • 字段标签
  • 发布属性名称
  • LiveCopy 属性名称
  • 描述
路径
搜索位于特定路径下的资产。
  • 字段标签
  • 添加搜索路径
  • 描述
属性
搜索指定的属性。
发布状态
根据资产的发布状态搜索资产
  • 字段标签
  • 属性名称*
  • 描述
范围
搜索位于指定范围内的资源。 在“搜索”面板中,您可以指定范围的最小值和最大值。
  • 字段标签
  • 属性名称
  • 描述
范围选项
资产的特定搜索谓词,与常用的滑块谓词相同。 由于向后兼容性问题,仍然可用。
  • 字段标签
  • 属性名称*
  • 选项路径
  • 描述
评分
根据资产的评级搜索资产。
  • 字段标签
  • 属性名称*
  • 选项路径
  • 描述
相对日期
根据资产创建的相对日期搜索资产
  • 字段标签
  • 属性名称*
  • 相对日期
  • 描述
滑块范围
使用滑块功能扩展范围谓词的常用搜索谓词。 搜索的属性值必须介于滑块限制之间。
  • 字段标签
  • 属性名称*
  • 描述
标记
根据标记搜索资产。 您可以配置路径属性,以在“标记”列表中填充各种标记。
  • 字段标签
  • 属性名称*
  • 选项路径
  • 描述
标记
根据标记进行搜索。
  • 占位符
  • 属性名称*
  • 描述
NOTE
  • 常见的搜索谓词在中定义:
    /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

  1. 导航到 工具, 操作, 搜索Forms.

  2. 选择要自定义的配置。

  3. 使用 编辑 图标以打开要更新的配置。

  4. 如果是新的自定义设置,您可能希望 添加新谓词字段并定义设置 。 如果是现有的自定义,则可以选择现有字段和 更新设置.

  5. 选择 完成 以保存配置。

    note note
    NOTE
    自定义配置存储在(视情况而定)下:
    • /apps/cq/gui/content/facets/<option>
    • /apps/commerce/gui/content/facets/<option>

添加/编辑谓词字段和定义字段设置 add-edit-a-predicate-field-and-define-field-settings

您可以添加或编辑字段,并定义/更新其设置:

  1. 打开自定义配置 进行更新。

  2. 如果要添加新字段,请打开 选择谓词 选项卡,然后将所需的谓词拖到所需的位置。 例如, 日期范围谓词:

    chlimage_1-375

  3. 取决于:

    • 您正在添加新字段:

      添加谓词后, 设置 选项卡,并显示可定义的属性。

    • 要更新现有谓词:

      选择谓词字段(位于右侧),然后打开 设置 选项卡。
      例如, 日期范围谓词:

    chlimage_1-376

  4. 根据需要进行更改,然后使用进行确认 完成.

预览搜索配置 previewing-the-search-configuration

  1. 选择预览图标:

  2. 这将显示搜索表单,因为它们将在相应控制台的“搜索”列中显示(完全展开)。

    chlimage_1-377

  3. 关闭 用于返回并完成配置的预览。

删除谓词字段 deleting-a-predicate-field

  1. 打开自定义配置 进行更新。

  2. 选择谓词字段(位于右侧),打开 设置 ,然后选择 删除 图标(左下方)。

  3. 对话框将请求确认删除操作。

  4. 确认此更改以及通过 完成.

删除配置(恢复默认设置) deleting-a-configuration-to-reinstate-the-default

自定义配置后,这将覆盖默认值。 您可以通过删除自定义配置来重新声明默认配置。

NOTE
您无法删除任一默认配置。

从控制台中删除自定义配置:

  1. 选择所需的配置(例如, 页面编辑器(段落搜索))和 删除 图标:

    chlimage_1-378

  2. 将删除自定义配置并恢复默认配置(这由控制台中重新出现挂锁符号来指示)。

添加选项谓词 adding-options-predicates

选项谓词(选项、选项属性)允许您配置要搜索的项目。 通常用于直接在页面下搜索内容;例如,page节点上的属性。

以下示例(根据用于创建页面的模板进行搜索)说明了涉及的步骤:

  1. 创建定义要搜索的属性的节点。

    您需要一个根节点,其中包含各个选项的定义,才可供用户使用。

    单个选项的节点需要属性:

    • jcr:title — 要在搜索边栏中显示的字段标签
    • value — 要搜索的属性值

    chlimage_1-379

    note note
    NOTE
    必须 不会更改 /libs 路径。
    这是因为 /libs 在下次升级实例时被覆盖(当您应用修补程序或功能包时,可能会被覆盖)。
    配置和其他更改的推荐方法是:
    1. 重新创建所需项目,因为它存在于 /libs,在 /apps. 在本例中,来源为:
    2. /libs/cq/gui/content/common/options/predicates
    3. /apps.
  2. 打开 搜索Forms 控制台,然后选择要更新的配置。 例如, 站点管理搜索边栏.

    然后,单击/点按 编辑搜索表单 图标。

  3. 根据配置,添加 选项选项属性 到配置。

  4. 更新字段,特别是:

    • 属性名称

      在目标节点上指定要搜索的节点属性。 例如:

      jcr:content/cq:template

    • 选项节点路径

      选择保留选项的路径。 例如:

      /apps/cq/gui/content/common/options/predicates/templatetype
      chlimage_1-380

  5. 选择 完成 以保存配置。

  6. 导航到相应的控制台(在本例中, 站点)并打开 搜索 边栏。 新定义的搜索表单以及各种选项将可见。 选择所需选项可查看搜索结果:

    chlimage_1-381

用户权限 user-permissions

下表列出了对搜索表单执行编辑、删除和预览操作所需的权限。

操作
权限
编辑
/apps 节点。
删除
/apps 节点
预览
/var/dam/content 节点。
/apps 节点。
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8