文档AEM 6.5用户指南

查询生成器谓词参考 query-builder-predicate-reference

Last update: Mon Jul 15 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 主题：

创建对象：

  • 开发人员
CAUTION
本页上的信息并非详尽无遗。
有关完整信息，请参阅Query Builder Debugger控制台上​ 可用谓词 ​下的列表；例如，位于：
例如，请参阅：

常规 general

谓词 predicates

布尔属性 boolproperty

匹配JCR BOOLEAN属性。 仅接受值“true”和“false”。 如果为“false”，则当该属性的值为“false”或根本不存在时，它匹配。 这对于检查仅在启用时设置的布尔标志很有用。

继承的“operation”参数没有意义。

支持Facet提取。 为每个true或false值提供存储段，但仅适用于现有属性。

属性 properties

  • 布尔属性
    属性的相对路径，例如myFeatureEnabled或jcr:content/myFeatureEnabled。

  • 值
    要检查属性“true”或“false”的值。

contentfragment contentfragment

将结果限制为内容片段。

不支持筛选。

不支持Facet提取。

属性 properties-1

  • contentfragment
    它可以与任何值一起使用来检查内容片段。

dateComparison datecomparison

将两个JCR DATE属性相互进行比较。 您可以测试它们是否相等、不相等、大于或大于或等于。

这是仅用于过滤的谓词，不能使用搜索索引。

属性 properties-2

  • 属性1

    第一个日期属性的路径。

  • 属性2

    指向第二个日期属性的路径。

  • 操作

    “equals”表示完全匹配，“!=”表示不相等比较，“greater”表示属性1大于属性2，“>=”表示属性1大于或等于属性2。 默认值为“equals”。

日期范围 daterange

将JCR DATE属性与日期/时间间隔匹配。 它使用ISO8601
日期和时间格式(YYYY-MM-DDTHH:mm:ss.SSSZ)，并允许部分呈现，如YYYY-MM-DD。 或者，时间戳可以按UTC时区(UNIX®时间格式)提供自1970年以来的毫秒数。

您可以查找介于两个时间戳之间的任何内容，比给定日期更新或更早的任何内容，也可以选择介于包含时间间隔和打开时间间隔之间的内容。

支持Facet提取。 提供存储桶“今天”、“本周”、“本月”、“最近3个月”、“今年”、“去年”和“比去年早”。

不支持筛选。

属性 properties-3

  • 属性

    DATE属性的相对路径，例如jcr:lastModified。

  • 下限

    用于检查属性（例如，2014-10-01）的日期下限。

  • lowerOperation

    “>”（较新）或“>=”（在或较新）适用于lowerBound。 默认值为“>”。

  • 上限

    检查属性的上限，例如2014-10-01T12:15:00。

  • upperOperation

    “<”（较旧）或“<=”（等于或较旧）适用于upperBound。 默认值为“<”。

  • 时区

    未作为ISO-8601日期字符串提供时要使用的时区ID。 默认值是系统的默认时区。

排除路径 excludepaths

从结果中排除路径与正则表达式匹配的节点。

这是仅用于过滤的谓词，不能使用搜索索引。

不支持Facet提取。

属性 properties-4

  • 排除路径

    正则表达式与结果路径匹配，不包括结果中的匹配路径。

全文 fulltext

搜索全文索引中的术语。

不支持筛选。

不支持Facet提取。

属性 properties-5

  • 全文

    全文搜索词。

  • relPath

    在属性或子节点中搜索的相对路径。 此属性是可选的。

组 group

允许生成嵌套条件。 组可以包含嵌套的组。 查询生成器查询中的所有内容都隐式位于根组中，该组也可以有p.or和p.not参数。

将两个属性中的一个与值匹配的示例：

group.p.or=true
group.1_property=jcr:title
group.1_property.value=My Page
group.2_property=navTitle
group.2_property.value=My Page

这是概念上的(1_property或2_property)。

嵌套组示例：

fulltext=Management
group.p.or=true
group.1_group.path=/content/geometrixx/en
group.1_group.type=cq:Page
group.2_group.path=/content/dam/geometrixx
group.2_group.type=dam:Asset

此操作在/content/geometrixx/en中的页面或/content/dam/geometrixx中的资产中搜索术语“管理”。

这是概念上的fulltext AND ( (path AND type) OR (path AND type) )。 此类OR连接需要良好的索引来提高性能。

属性 properties-6

  • p.或

    如果设置为“true”，则组中只能有一个谓词匹配。 此值默认为“false”，表示所有值必须匹配

  • p.not

    如果设置为“true”，则它会使组无效（默认为“false”）。

  • <谓词>

    添加嵌套谓词。

  • N_<谓词>

    同时添加多个嵌套谓词，如1_property, 2_property, ...。

hasPermission haspermission

将结果限制为当前会话具有指定JCR权限的项目。

这是仅用于过滤的谓词，不能使用搜索索引。 它不支持彩块化提取。

属性 properties-7

  • hasPermission

    当前用户会话必须全部具有相关节点的逗号分隔JCR权限。 例如，jcr:write，jcr:modifyAccessControl。

语言 language

查找采用特定语言的CQ页面。 这会查看页面语言属性和页面路径，后者通常包括顶级网站结构中的语言或区域设置。

这是仅用于过滤的谓词，不能使用搜索索引。

支持Facet提取。 为每个唯一的语言代码提供存储段。

属性 properties-8

  • 语言

    ISO语言代码，例如"de"

mainasset mainasset

检查节点是否是DAM主资产而不是子资产。 这基本上是每个不在“子资产”节点中的节点。 这不会检查dam:Asset节点类型。 要使用此谓词，请设置“mainasset=true”或“mainasset=false”，没有其他属性。

这是仅用于过滤的谓词，不能使用搜索索引。

支持彩块化提取，并为主资源和子资源提供两个分段。

属性 properties-9

  • mainasset

    布尔值，主资产为“true”，子资产为“false”。

memberOf memberof

查找属于特定sling资源集合成员的项。

这是仅用于过滤的谓词，不能使用搜索索引。 不支持Facet提取。

属性 properties-10

  • memberOf

    Sling资源集合的路径。

节点名称 nodename

匹配JCR节点名称。

支持Facet提取。 为每个唯一的节点名称（文件名）提供存储段。

属性 properties-11

  • 节点名称

    允许使用通配符的节点名称模式： * =任何或不包含字符，? =任何字符，[abc] =仅包含括号中的字符。

notexpired notexpired

通过检查JCR DATE属性是否大于或等于当前服务器时间匹配项。 这可用于检查“expiresAt”之类的日期属性，并限制为仅包含尚未过期(notexpired=true)或已过期(notexpired=false)的属性。

不支持筛选。

支持彩块化提取的方式与日期范围谓词相同。

属性 properties-12

  • notexpired

    布尔值，“true”表示尚未过期（日期在将来或相等），“false”表示已过期（日期在过去）（必需）。

  • 属性

    要检查的DATE属性的相对路径（必需）。

orderby orderby

允许对结果进行排序。 如果需要按多个属性排序，则必须使用数字前缀（如1_orderby=first、2_oderby=second）多次添加此谓词。

属性 properties-13

  • orderby

    JCR属性名称由前导@指示，例如，@jcr:lastModified或@jcr:content/jcr:title，或者查询中的另一个谓词，例如，要排序的2_property。

  • 排序

    排序方向，按降序排列“desc”或按升序排列“asc”（默认）。

  • 案例

    如果设置为ignore，排序将不区分大小写，这意味着“a”在“B”之前；如果为空或省略，排序将区分大小写，这意味着“B”在“a”之前

路径 path

在给定路径内搜索。

不支持Facet提取。

属性 properties-14

  • path

    路径模式。 根据精确而定，整个子树匹配（如在xpath中附加//*，但请注意，这不包括基路径）（精确等于false，默认值），或仅包括通配符(*)的精确路径匹配；如果设置了self，则会搜索包括基节点的整个子树。

  • 精确

    如果exact为true/on，则确切的路径必须匹配，但它可以包含简单通配符(*)，这些通配符与名称匹配，但不匹配“/”；如果为false（默认），则包含所有后代（可选）。

  • 平面

    仅搜索直接子级（如在xpath中附加“/*”）（仅在“exact”不是true或可选时使用）。

  • self

    搜索子树，但包含作为路径指定的基础节点（无通配符）。

属性 property

匹配JCR属性及其值。

支持Facet提取。 为结果中的每个唯一属性值提供存储段。

属性 properties-15

  • 属性

    属性的相对路径，例如jcr:title。

  • 值

    要检查属性的值；遵循JCR属性类型到字符串的转换。

  • N_value

    使用1_value、2_value、…检查多个值（默认情况下与OR以及AND if and=true组合）（从5.3开始）。

  • 和

    设置为true可将多个值(N_value)与AND（从5.3开始）组合。

  • 操作

    “equals”表示完全匹配（默认值），“unequals”表示不相等比较，“like”表示使用jcr:like xpath函数（可选），“not”表示不匹配（例如，xpath中的“not(@prop)”，忽略值参数）或“exists”表示存在性检查（值可以为true — 属性必须存在，默认值 — 或false — 与“not”相同）。

  • 深度

    属性/相对路径可以存在的通配符级别数（例如，property=size depth=2检查节点/大小、节点/&amp；ast；/size和节点/&amp；ast；/&amp；ast；/size）。

rangeproperty rangeproperty

将JCR属性与时间间隔匹配。 这适用于线性类型的属性，如LONG、DOUBLE和DECIMAL。 对于DATE，请参阅已优化日期格式输入的日期范围谓词。

您可以定义下限和上限，也可以只定义其中一个。 也可以分别为下限和上限指定操作（例如，“小于”或“小于或等于”）。

不支持Facet提取。

属性 properties-16

  • 属性

    属性的相对路径。

  • 下限

    检查属性的下限。

  • lowerOperation

    “>”（默认）或“>=”适用于lowerValue

  • 上限

    检查属性的上限。

  • upperOperation

    “<”（默认）或“<=”适用于lowerValue

  • decimal

    如果检查的属性为Decimal类型，则为“true”

相对日期范围 relativedaterange

使用相对于当前服务器时间的时间偏移量将JCR DATE属性与日期/时间间隔匹配。 您可以使用毫秒值或bugzilla语法1s 2m 3h 4d 5w 6M 7y（1秒、2分钟、3小时、4天、5周、6个月、7年）指定lowerBound和upperBound。 带有“-”的前缀，表示当前时间之前的负偏移。 如果仅指定lowerBound或upperBound，则另一个将默认为0，即当前时间。

例如：

  • upperBound=1h （没有任何lowerBound）将在下一小时选择任何内容
  • lowerBound=-1d （没有任何upperBound）将选择过去24小时内的任何内容
  • lowerBound=-6M和upperBound=-3M将选择6个月到3个月之前的任何内容
  • lowerBound=-1500和upperBound=5500将选择过去1500毫秒到未来5500毫秒之间的任何时间
  • lowerBound=1d和upperBound=2d将选择后天的任何内容

它不考虑闰年，所有月份都是30天。

不支持筛选。

支持彩块化提取的方式与日期范围谓词相同。

属性 properties-17

  • 上限

    以毫秒为单位的上限日期或相对于当前服务器时间的1s 2m 3h 4d 5w 6M 7y（1秒、2分钟、3小时、4天、5周、6个月、7年），使用“ — ”表示负偏移。

  • 下限

    以毫秒为单位或相对于当前服务器时间的1s 2m 3h 4d 5w 6M 7y（1秒、2分钟、3小时、4天、5周、6个月、7年）为下限，使用“ — ”表示负偏移。

根 root

根谓词组。 支持组的所有功能，并允许您设置全局查询参数。

名称“root”从未在查询中使用，它是隐式的。

属性 properties-18

  • p.offset

    指示结果页面开始的数字，即要跳过的项目数。

  • p.limit

    表示页面大小的数字。

  • p.guessTotal

    建议：避免计算完整的结果总数，因为这样会耗费大量成本；要么是指示要计算的最大总数（例如，1000，一个数字，该数字为用户提供对粗略大小的足够反馈，而为较小的结果提供精确的数字）要么是" true"，仅计算所需的最小值p.offset + p.limit。

  • p.excerpt

    如果设置为“true”，请在结果中包含全文摘录。

  • p.hits

    （仅适用于JSON servlet）选择点击作为JSON写入的方式，并使用这些标准点击（可通过ResultHitWriter服务扩展）：

    • 简单：

      最小项目，如path、title、lastmodified、excerpt（如果已设置）。

    • 完整：

      Sling JSON节点渲染，其中jcr:path指示点击路径：默认情况下，仅列出节点的直接属性，包括包含p.nodedepth=N的较深树，其中0表示整个无限子树；添加p.acls=true以包含给定结果项上当前会话的JCR权限（映射： create = add_node，modify = set_property，delete = remove）。

    • 选择性：

      仅在p.properties中指定的属性，该属性是相对路径的空格分隔列表（在URL中使用“+”）；如果相对路径的深度大于1，则这些属性表示为子对象；特殊的jcr：path属性包括点击的路径

savedquery savedquery

将持久查询生成器查询的所有谓词作为子组谓词包含到当前查询中。

这不会运行额外的查询，但会扩展当前查询。

可以使用QueryBuilder#storeQuery()以编程方式保留查询。 格式可以是多行字符串属性，也可以是以Java™属性格式将查询作为文本文件包含的nt:file节点。

不支持为已保存查询的谓词进行Facet提取。

属性 properties-19

  • savedquery

    已保存查询的路径（字符串属性或nt:file节点）。

相似 similar

使用JCR XPath的rep:similar()进行相似性搜索。

不支持筛选。 不支持Facet提取。

属性 properties-20

  • 相似
    要查找相似节点的节点的绝对路径。

  • 本地
    子节点或当前节点的.的相对路径（可选，默认为“.”）。

标记 tag

通过指定标记标题路径，搜索使用一个或多个标记标记的内容。

支持Facet提取。 使用每个唯一标记的当前标记标题路径为其提供存储段。

属性 properties-21

  • 标记

    要查找的标记标题路径，例如“资产属性：方向/横向”。

  • N_value

    使用1_value、2_value、…检查多个标记（默认情况下与OR相结合，如果为AND且为true）（从5.6开始）。

  • 属性

    要查看的属性（或属性的相对路径）（默认为“cq:tags”）

tagid tagid

通过指定标记ID来搜索使用一个或多个标记标记的内容。

支持Facet提取。 使用每个唯一标记的当前标记ID为其提供存储段。

属性 properties-22

  • tagid

    标记ID，以便查找，例如" properties:orientation/landscape"。

  • N_value

    使用1_value、2_value、…检查多个Tagid（默认情况下与OR组合，如果为AND且为True）（从5.6开始）。

  • 属性

    要查看的属性（或属性的相对路径）（默认为“cq:tags”）。

tagsearch tagsearch

通过指定关键字，搜索带有一个或多个标记的内容。 此操作将首先搜索其标题中包含这些关键字的标记，然后将结果限制为仅包含具有这些标记的项目。

不支持Facet提取。

属性 Properties-1

  • tagsearch

    要在标记标题中搜索的关键字。

  • 属性

    要查看的属性（或属性的相对路径）（默认cq:tags）。

  • lang

    仅搜索特定本地化的标记标题（例如，de）。

  • 所有

    （布尔）搜索整个标记全文，即所有标题、描述等。 优先于“l ang”。

类型 type

将结果限制到特定的JCR节点类型，即主节点类型或mixin类型。 这还将查找该节点类型的子类型。 存储库搜索索引必须涵盖节点类型才能有效执行。

支持Facet提取。 为结果中的每个唯一类型提供存储段。

属性 Properties-2

  • 类型

    要搜索的节点类型或mixin名称，例如cq:Page。

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2