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

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

常规 general

谓词 predicates

布尔属性 boolproperty

匹配JCR BOOLEAN属性。 仅接受值" true”和“ false“。 If " 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"对于property1,大于属性2, " >=”表示property1大于或等于property2。 默认值为'' 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_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.非

    如果设置为" true“”,这将使组无效(默认为“ false“)。

  • <predicate>

    添加嵌套谓词。

  • N_<predicate>

    同时添加多个嵌套谓词,如 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,进行排序。

  • sort

    排序方向,或者为“ desc”表示降序或“ asc”表示升序(默认)。

  • 案例

    如果设置为 ignore,它使排序区分大小写,这意味着“a”在“B”之前输入;如果为空或缺席,则排序区分大小写,这意味着“B”在“a”之前输入

路径 path

在给定路径内搜索。

不支持Facet提取。

属性 properties-14

  • path

    路径模式。 根据具体情况,整个子树都将匹配(如附加 //* 在xpath中,但请注意,这不包括基本路径)(exact=false,默认),或者仅包括精确路径匹配,其中可以包括通配符( *);如果设置了self,则搜索包括基节点的整个子树。

  • 精确

    如果 exact 为true/on,则确切路径必须匹配,但它可以包含简单的通配符( *),名称匹配,但不匹配" /“;如果为false(默认),则包含所有后代(可选)。

  • 平整

    仅搜索直接子项(如追加" /*在xpath中为“”)(仅在“ exact'不为true,可选)。

  • 自身

    搜索子树,但包含作为路径指定的基础节点(无通配符)。

属性 property

匹配JCR属性及其值。

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

属性 properties-15

  • 属性

    属性的相对路径,例如, jcr:title.

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

  • N_value

    使用 1_value2_value, …以检查多个值(与 OR 默认情况下,使用 AND if和=true)(从5.3开始)。

  • 设置为true可组合多个值( N_value)与AND一起使用(从5.3开始)。

  • 操作

    "equals“”表示完全匹配(默认), “ unequals“对于不平等比较,” like”用于使用 jcr:like xpath函数(可选), " not”表示无匹配项(例如,“not(@prop)“在xpath中,值参数被忽略)或” exists”进行存在性检查(值可以为true — 属性必须存在,默认值 — 或false — 与“ not“)。

  • 深度

    属性/相对路径可以存在的通配符级别数(例如, property=size depth=2 检查节点/大小、 node/&ast;/size和node/&ast;/&ast;/size)。

rangeproperty rangeproperty

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

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

不支持Facet提取。

属性 properties-16

  • 属性

    属性的相对路径。

  • 下限

    检查属性的下限。

  • lowerOperation

    " >“(默认)或” >=",适用于 lowerValue

  • 上限

    检查属性的上限。

  • upperOperation

    " <“(默认)或” <=",适用于 lowerValue

  • 小数

    " true"(如果checked属性的类型为Decimal)

相对日期范围 relativedaterange

匹配 JCR DATE 属性针对某个日期/时间间隔使用相对于当前服务器时间的时间偏移。 您可以指定 lowerBoundupperBound 使用毫秒值或bugzilla语法 1s 2m 3h 4d 5w 6M 7y (一秒、两分钟、三小时、四天、五周、六个月、七年)。 前缀为" -”表示当前时间之前的负偏移。 如果您只指定 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(). 格式可以是多行字符串属性或 nt:file 以Java™属性格式将查询作为文本文件包含的节点。

不支持为已保存查询的谓词进行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 if和=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 if和=true)(从5.6开始)。

  • 属性

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

tagsearch tagsearch

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

不支持Facet提取。

属性 Properties-1

  • tagsearch

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

  • 属性

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

  • lang

    仅搜索特定本地化的标记标题(例如, de)。

  • 所有

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

类型 type

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

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

属性 Properties-2

  • type

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

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