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

CAUTION
本页上的信息并非详尽无遗。
有关完整信息,请参阅Query Builder Debugger控制台上​ 可用谓词 ​下的列表;例如,位于:
例如,请参阅:

常规 general

谓词 predicates

布尔属性 boolproperty

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

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

支持Facet提取。 为每个truefalse值提供存储段,但仅适用于现有属性。

属性 properties

  • 布尔属性
    属性的相对路径,例如myFeatureEnabledjcr: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.orp.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_property2_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:writejcr: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=first2_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_value2_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属性与时间间隔匹配。 这适用于线性类型的属性,如LONGDOUBLEDECIMAL。 对于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年)指定lowerBoundupperBound。 带有“-”的前缀,表示当前时间之前的负偏移。 如果仅指定lowerBoundupperBound,则另一个将默认为0,即当前时间。

例如:

  • upperBound=1h (没有任何lowerBound)将在下一小时选择任何内容
  • lowerBound=-1d (没有任何upperBound)将选择过去24小时内的任何内容
  • lowerBound=-6MupperBound=-3M将选择6个月到3个月之前的任何内容
  • lowerBound=-1500upperBound=5500将选择过去1500毫秒到未来5500毫秒之间的任何时间
  • lowerBound=1dupperBound=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服务扩展):

    • 简单

      最小项目,如pathtitlelastmodifiedexcerpt(如果已设置)。

    • 完整

      Sling JSON节点渲染,其中jcr:path指示点击路径:默认情况下,仅列出节点的直接属性,包括包含p.nodedepth=N的较深树,其中0表示整个无限子树;添加p.acls=true以包含给定结果项上当前会话的JCR权限(映射: create = add_nodemodify = set_propertydelete = 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_value2_value、…检查多个标记(默认情况下与OR相结合,如果为AND且为true)(从5.6开始)。

  • 属性

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

tagid tagid

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

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

属性 properties-22

  • tagid

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

  • N_value

    使用1_value2_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