查询生成器谓词参考 query-builder-predicate-reference
常规 general
根 root
根谓词组。 它支持组的所有功能，并允许设置全局查询参数。
名称“root”从未在查询中使用；它是隐式的。
属性 properties-18
-
p.offset— 指示结果页开始的数字，即要跳过多少项。 -
p.limit— 表示页面大小的数字。 -
p.guessTotal— 建议：避免计算完整结果总计，这可能代价高昂。 指示可计数的最大总数的数字（例如，1000，一个数字，该数字为用户提供对粗略大小的足够反馈以及用于较小结果的精确数字）。 或者，true仅计数到所需的最小值p.offset+p.limit。 -
p.excerpt— 如果设置为true，则在结果中包含全文摘录。 -
p.indexTag— 如果设置，将在查询中包含索引标记选项（请参阅查询选项索引标记）。 -
p.facetStrategy— 如果设置为oak，Query Builder将向Oak委派Facet提取（请参阅Facet）。 -
p.hits— （仅适用于JSON servlet）选择命中项作为JSON写入的方式，并使用这些标准命中项（可通过ResultHitWriter服务扩展）。simple— 最小项目，如path、title、lastmodified、excerpt（如果已设置）。full— 节点的sling JSON渲染，其中jcr:path指示点击的路径。 默认情况下，仅列出节点的直接属性，包括包含p.nodedepth=N的较深树，0表示整个无限子树。 添加p.acls=true以包含给定结果项上当前会话的JCR权限（映射：create=add_node，modify=set_property，delete=remove）。selective— 仅在p.properties中指定的属性，该属性是以空格分隔的（在URL中使用+）相对路径列表。 如果相对路径的深度为>1，则这些属性表示为子对象。 特殊jcr:path属性包含点击的路径。
组 group
此谓词允许构建嵌套条件。 组可以包含嵌套的组。 Query Builder查询中的所有内容都隐式位于根组中，该组也可以有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/wknd/ch/de
group.1_group.type=cq:Page
group.2_group.path=/content/dam/wknd
group.2_group.type=dam:Asset
在/content/wknd/ch/de中的页面或/content/dam/wknd中的资产中搜索术语 管理。
从概念上讲，它是fulltext AND ( (path AND type) OR (path AND type) )。 出于性能原因，此类OR连接需要良好的索引。
属性 properties-6
p.or— 如果设置为true，则组中只能有一个谓词匹配。 默认为false，表示所有规则必须匹配p.not— 如果设置为true，它将使组无效（默认为false）<predicate>— 添加嵌套谓词N_<predicate>— 同时添加多个嵌套谓词，如1_property, 2_property, ...
orderby orderby
此谓词允许对结果进行排序。 如果需要按多个属性排序，则必须使用数字前缀（如1_orderby=first、2_oderby=second）多次添加此谓词。
属性 properties-13
orderby— 由前导@指示的JCR属性名称，例如@jcr:lastModified或@jcr:content/jcr:title，或者查询中的另一个谓词，例如2_property，要对其排序sort— 排序方向，desc表示降序，asc表示升序（默认）case— 如果设置为ignore，则排序不区分大小写，表示a在B之前；如果为空或缺席，则排序区分大小写，表示B在a之前
谓词 predicates
布尔属性 boolproperty
此谓词与JCR布尔属性匹配。 仅接受值true和false。 如果该值为false，则当该属性的值为false或根本不存在时，该值将匹配。 此谓词可用于检查仅在启用时设置的布尔标记。
继承的operation参数没有意义。
此谓词支持Facet提取并为每个true或false值提供存储段，但仅适用于现有属性。
属性 properties
boolproperty— 属性的相对路径，例如myFeatureEnabled或jcr:content/myFeatureEnabledvalue— 要检查的属性，true或false的值
contentfragment contentfragment
此谓词将结果限制为内容片段。
- 它不支持筛选。
- 它不支持彩块化提取。
属性 properties-1
contentfragment— 可与任何值一起使用来检查内容片段。
dateComparison datecomparison
此谓词将两个JCR日期属性相互进行比较。 可以测试它们是相等、不相等、大于还是大于或等于。
仅限过滤的谓词，不能使用搜索索引。
属性 properties-2
-
property1— 指向第一个日期属性的路径 -
property2— 指向第二个日期属性的路径 -
operation=表示完全匹配（默认）- 不相等比较的
!= property1的>大于property2property1的>=大于或等于property2
日期范围 daterange
此谓词根据日期/时间间隔匹配JCR日期属性。 使用ISO8601
日期和时间的格式(YYYY-MM-DDTHH:mm:ss.SSSZ)，并允许部分呈现，如YYYY-MM-DD。 或者，时间戳可以作为POSIX时间提供。
您可以查找介于两个时间戳之间的任何内容，比给定日期更新或更早的任何内容，也可以选择介于包含时间间隔和打开时间间隔之间的内容。
它支持Facet提取并提供存储段today、this week、this month、last 3 months、this year、last year和earlier than last year。
它不支持筛选。
属性 properties-3
property-DATE属性的相对路径，例如jcr:lastModifiedlowerBound— 用于检查属性（例如，2014-10-01）的日期下限lowerOperation->（较新）或>=（大于或等于），适用于lowerBound。 默认值为>upperBound— 检查属性的上限，例如2014-10-01T12:15:00upperOperation-<（较旧）或<=（等于或较旧）适用于upperBound。 默认值为<timeZone— 未作为ISO-8601日期字符串提供时要使用的时区ID。 默认值是系统的默认时区。
排除路径 excludepaths
此谓词从路径与正则表达式匹配的结果中排除节点。
仅限过滤的谓词，不能使用搜索索引。
它不支持彩块化提取。
属性 properties-4
excludepaths— 与结果路径匹配的正则表达式，从结果中排除匹配的路径。
全文 fulltext
搜索全文索引中的术语。
它不支持筛选。
它不支持彩块化提取。
属性 properties-5
fulltext— 全文搜索词relPath— 在属性或子节点中搜索的相对路径。 此属性是可选的。
hasPermission haspermission
此谓词将结果限制在当前会话具有指定JCR权限的项目中。
仅限过滤的谓词，不能使用搜索索引。 它不支持彩块化提取。
属性 properties-7
hasPermission— 当前用户会话必须拥有的对相关节点的所有逗号分隔JCR权限。 例如，jcr:write，jcr:modifyAccessControl
语言 language
此谓词查找特定语言的AEM页面。 它同时查看页面语言属性和页面路径，后者通常包括顶级网站结构中的语言或区域设置。
仅限过滤的谓词，不能使用搜索索引。
它支持Facet提取，并为每个唯一的语言代码提供存储桶。
属性 properties-8
language- ISO语言代码，例如，de
mainasset mainasset
此谓词检查节点是否是DAM主资产而不是子资产。 它基本上是每个不在子资产节点内的节点。 它不检查dam:Asset节点类型。 若要使用此谓词，请设置mainasset=true或mainasset=false。 没有其他属性。
仅限过滤的谓词，不能使用搜索索引。
它支持彩块化提取，并为主资产和子资产提供两个存储桶。
属性 properties-9
mainasset— 布尔值，true（主资产），false（子资产）
memberOf memberof
此谓词查找属于特定sling资源集合成员的项。
仅限过滤的谓词，不能使用搜索索引。
它不支持彩块化提取。
属性 properties-10
memberOf- Sling资源集合的路径
节点名称 nodename
此谓词与JCR节点名称匹配。
它支持Facet提取，并为每个唯一的节点名称（文件名）提供存储段。
属性 properties-11
nodename— 允许使用通配符的节点名称模式：*=任何或不包含字符，?=任何字符，[abc]=仅包含括号中的字符
notexpired notexpired
此谓词通过检查JCR日期属性是否大于或等于当前服务器时间来匹配项。 它可用于检查expiresAt值，并将结果限制为仅包含尚未过期(notexpired=true)或已过期(notexpired=false)的值。
它不支持筛选。
它支持彩块化提取，其方式与daterange谓词相同。
属性 properties-12
notexpired— 布尔值，true表示尚未过期（日期在将来或等于），false表示过期（日期在过去）（必需）property— 要检查的DATE属性的相对路径（必需）
路径 path
此谓词在给定路径内搜索。
它不支持彩块化提取。
属性 properties-14
path— 定义路径模式。- 根据
exact属性，整个子树匹配（如在xpath中附加//*，但请注意，它不包括基路径），或者只匹配精确路径，该路径可以包括通配符(*)。- 默认为
true。
<！— *如果设置了self属性，则会搜索包含基节点的整个子树。—>
- 默认为
- 根据
exact— 如果exact是true，则确切的路径必须匹配，但它可以包含简单通配符(*)，这些通配符与名称匹配，但不匹配/；如果它是false（默认值），则包括所有后代（可选）。flat— 仅搜索直接子级（例如在xpath中附加/*）（仅在exact不是true或可选时使用）。self— 搜索子树，但包含作为路径指定的基节点（无通配符）。- 重要说明：在查询生成器的当前实现中发现
self属性存在问题，在查询中使用它可能无法生成正确的搜索结果。 更改self属性的当前实现也是不可行的，因为它可能会中断依赖它的现有应用程序。 由于此功能，self属性现已弃用；建议避免使用它。
- 重要说明：在查询生成器的当前实现中发现
属性 property
此谓词与JCR属性及其值相匹配。
它支持方面提取，并为结果中的每个唯一属性值提供存储段。
属性 properties-15
-
property— 属性的相对路径，例如jcr:title。 -
value— 要检查属性的值；遵循JCR属性类型到字符串的转换。 -
N_value— 使用1_value、2_value、…检查多个值（默认情况下与OR组合，如果and=true则为AND）。 -
and— 设置为true以将多个值(N_value)与AND组合 -
operation-
equals表示完全匹配（默认）。 -
unequals进行不等式比较。 -
使用
jcr:likexpath函数的like（可选）。 -
没有匹配项的
not（例如，xpath中的not(@prop)，值参数将被忽略）。 -
exists是否存在检查。true属性必须存在。false与not相同，是默认值。
-
-
depth— 属性/相对路径可以存在的通配符级别数（例如，property=size depth=2检查node/size、node/*/size和node/*/*/size）。
rangeproperty rangeproperty
此谓词根据间隔匹配JCR属性。 它适用于线性类型的属性，如LONG、DOUBLE和DECIMAL。 对于DATE，查看具有优化日期格式输入的daterange谓词。
您可以定义下限、上限或同时定义两者。 也可以分别为下限和上限指定操作（例如，小于或小于或等于）。
它不支持彩块化提取。
属性 properties-16
property— 属性的相对路径lowerBound— 检查属性的下限lowerOperation->（默认）或>=适用于lowerValueupperBound— 检查属性的上限upperOperation-<（默认）或<=适用于lowerValue- 如果检查的属性为Decimal类型，则为
decimal-true
相对日期范围 relativedaterange
此谓词使用相对于当前服务器时间的时间偏移，根据日期/时间间隔匹配JCR DATE属性。 您可以使用毫秒值或Bugzilla语法1s 2m 3h 4d 5w 6M 7y（一秒、两分钟、三小时、四天、五周、六个月、七年）指定lowerBound和upperBound。 前缀为-表示当前时间之前的负偏移。 如果仅指定lowerBound或upperBound，则另一个将默认为0，表示当前时间。
例如：
upperBound=1h（没有任何lowerBound）在下一个小时选择任何内容lowerBound=-1d（无upperBound）选择过去24小时内的任何内容lowerBound=-6M和upperBound=-3M选择过去3到6个月的任何内容lowerBound=-1500和upperBound=5500选择在1500毫秒之前和将来5500毫秒之间的任何时间lowerBound=1d和upperBound=2d选择后天的任何内容
它不考虑闰年，所有月份都是30天。
它不支持筛选。
它支持彩块化提取，其方式与daterange谓词相同。
属性 properties-17
upperBound— 以毫秒为单位的上限日期或相对于当前服务器时间的1s 2m 3h 4d 5w 6M 7y（一秒、两分钟、三小时、四天、五周、六个月、七年），将-用于负偏移lowerBound— 以毫秒为单位的下限日期或相对于当前服务器时间的1s 2m 3h 4d 5w 6M 7y（一秒、两分钟、三小时、四天、五周、六个月、七年），将-用于负偏移
savedquery savedquery
此谓词包括作为子组谓词添加到当前查询中的持久查询生成器查询的所有谓词。
它不会运行额外的查询，但会扩展当前查询。
可以使用QueryBuilder#storeQuery()以编程方式保留查询。 格式可以是多行String属性，也可以是以Java™属性格式将查询作为文本文件包含的nt:file节点。
它不支持为已保存查询的谓词进行Facet提取。
属性 properties-19
savedquery— 已保存查询的路径（String属性或nt:file节点）
相似 similar
此谓词是使用JCR XPath的rep:similar()进行相似性搜索。
它不支持筛选，也不支持Facet提取。
属性 properties-20
similar— 要查找相似节点的节点的绝对路径local— 下级节点的相对路径，或当前节点的.（可选，默认为.）
标记 tag
此谓词通过指定标记标题路径来搜索使用一个或多个标记标记的内容。
它支持彩块化提取，并使用每个唯一标记的当前标记标题路径为其提供存储段。
属性 properties-21
tag— 要查找的标记标题路径，例如properties:orientation/landscapeN_value— 使用1_value、2_value、…检查多个标记（默认情况下与OR相结合，如果and=true则为AND）property— 要查看的属性（或属性的相对路径）（默认cq:tags）
tagid tagid
此谓词通过指定标记ID来搜索使用一个或多个标记标记标记的内容。
它支持彩块化提取，并使用每个唯一标记的当前标记ID为其提供存储桶。
属性 properties-22
tagid— 要查找的标记ID，例如properties:orientation/landscapeN_value— 使用1_value、2_value、…检查多个标记ID（默认情况下与OR组合，如果and=true则为AND）property— 要查看的属性（或属性的相对路径）（默认cq:tags）
tagsearch tagsearch
此谓词通过指定关键字来搜索使用一个或多个标记标记的内容。 首先在标题中搜索包含这些关键字的标记，然后将结果限制为仅包含这些关键字标记的项目。
它不支持彩块化提取。
属性 Properties-1
tagsearch— 要在标记标题中搜索的关键字property— 要考虑的属性（或属性的相对路径）（默认cq:tags）lang— 仅搜索特定本地化的标记标题（例如，de）all— 用于搜索整个标记全文（即所有标题、描述等）的布尔值（优先于lang）
类型 type
此谓词将结果限制为特定的JCR节点类型，包括主节点类型或mixin类型。 它还会查找该节点类型的子类型。 存储库搜索索引必须涵盖节点类型才能有效执行。
它支持方面提取，并为结果中的每种唯一类型提供存储段。
属性 Properties-2
type— 要搜索的节点类型或mixin名称，例如cq:Page