查询生成器谓词引用

常规

• 根
• 组
• orderby

谓词

• 布尔属性
• contentfragment
• dateComparison
• 达朗日
• 排除路径
• 全文
• hasPermission
• 语言
• mainasset
• memberOf
• 诺登姆
• notexpired
• 路径
• 属性
• 牧场属性
• 相对变化
• savedquery
• 相似
• 标签
• tagid
• 标语
• 类型

布尔属性

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

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

支持facet提取。 将为每个true或false值提供存储段，但仅为现有属性提供存储段。

属性

• ​
  boolpropertyrelative path to property，例如
  myFeatureEnabled 或 jcr:content/myFeatureEnabled

• 要
  检查属性的值， "
  true" 或 " false"

contentfragment

将结果限制为内容片段。

不支持筛选。

不支持facet提取。

属性

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

dateComparision

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

这是只筛选谓词，无法利用搜索索引。

属性

• property1

  第一个日期属性的路径

• property2

  路径到第二个日期属性

• 操作

  “ =”表示精确匹配，“ !=”表示不等式比较，“ >”表示属性1大于属性2,“ >=”表示属性1大于或等于属性2。 默认值为 " =".

daterange

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

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

支持facet提取。 将提供“今天”、“本周”、“本月”、“过去3个月”、“今年”、“去年”和“比去年更早”的桶。

不支持筛选。

属性

• 属性

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

• lowerBound

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

• lowerOperation

  " >"（较新）或" >="（at或较新）适用于lowerBound。 默认为 " >".

• 上界

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

• upperOperation

  " <"（旧版）或" <="（旧版）适用于upperBound。 默认为 " <".

• 时区

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

excludepaths

从其路径与常规表达式匹配的结果中排除节点。

这是只筛选谓词，无法利用搜索索引。

不支持facet提取。

属性

• 排除路径

  与结果路径匹配的常规表达式，从结果中排除匹配的路径。

全文

在全文索引中搜索词。

不支持筛选。

不支持facet提取。

属性

• 全文

  全文搜索词

• relPath

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

组

允许构建嵌套条件。 组可以包含嵌套组。 querybuilder查询中的所有内容都隐式位于根组中，根组中也可以有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连接需要良好的性能索引。

属性

• p.or

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

• p.not

  如果设置为“ true”，则它将忽略该组（默认为“ false”）

• <predicate>

  添加嵌套谓词

• N_<predicate>

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

hasPermission

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

这是只筛选谓词，无法利用搜索索引。 它不支持facet提取。

属性

• hasPermission

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

语言

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

这是只筛选谓词，无法利用搜索索引。

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

属性

• 语言

  ISO语言代码，例如" de"

mainasset

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

这是只筛选谓词，无法利用搜索索引。

支持facet提取。 将为主资产和子资产提供2个存储段。

属性

• mainasset

  布尔值，“ true”（主资产）,“ false”（子资产）

memberOf

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

这是只筛选谓词，无法利用搜索索引。 不支持facet提取。

属性

• memberOf

  Sling资源收集路径

nodename

在JCR节点名称上匹配。

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

属性

• 诺登姆

  允许通配符的节点名称模式：* =任意或无字符，? =任意字符，[abc] =仅在括号中有字符

notexpired

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

不支持筛选。

支持facet提取，方法与更改谓词相同。

属性

• notexpired

  布尔值、“ true”（未过期日期或等于日期）、“ false”（过去日期）（必需）

• 属性

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

orderby

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

属性

• orderby

  JCR属性名称由前导@（如@jcr:lastModified或@jcr:content/jcr:title）表示，或查询中的另一个谓词（如2_property）表示，要对其进行排序

• 排序

  排序方向，“ desc”表示降序，“ asc”表示升序（默认）

• 案例

  如果设置为“ ignore”，则排序不区分大小写，即“a”在“B”之前；如果为空或未排除，则排序区分大小写，即“B”在“a”之前

路径

在给定路径内搜索。

不支持facet提取。

属性

• 路径

  路径模式；根据具体情况，整个子树将进行匹配（如在xpath中附加//*，但请注意，这不包括基本路径）（exact=false，默认值），或只有精确路径匹配，其中可以包括通配符(*);如果设置了“自”，则将搜索包括基节点的整个子树

• 精确

  如果exact为true/on，则精确路径必须匹配，但可以包含简单通配符(*)，该通配符与名称匹配，但不能包含" /";如果为false（默认），则包括所有后代（可选）

• 扁平

  仅搜索直接子项（如在xpath中附加“ /*”）（仅在“ exact”不为true时使用，可选）

• self

  搜索子树，但包括作为路径给定的基节点（无通配符）

属性

与JCR属性及其值匹配。

支持facet提取。 将为结果中的每个唯一属性值提供时段。

属性

• 属性

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

• 选定

  值：检查属性；跟在JCR属性类型到字符串转换之后

• N_value

  使用1_value、2_value、…检查多个值（默认情况下与OR结合，如果与=true则与AND结合）（自5.3起）

• 和

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

• 操作

  " equals"（对于exactmatch，默认值）," 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

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

您可以定义下界和上界，也可以只定义其中一个。 操作(例如 “小于”或“小于或等于”)也可单独指定用于下界和上界。

不支持facet提取。

属性

• 属性

  属性相对路径

• lowerBound

  下界检查属性

• lowerOperation

  " >"（默认）或" >="，适用于lowerValue

• 上界

  上界检查属性

• upperOperation

  " <"（默认）或" <="，适用于lowerValue

• 小数

  " true"（如果选中的属性类型为Decimal）

相对变量

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

不支持筛选。

支持facet提取，方法与更改谓词相同。

属性

• 上界

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

• lowerBound

  以毫秒为单位的较低日期界限，或者1s 2m 3h 4d 5w 6M 7y（一秒、二分钟、三小时、四天、五周、六个月、七年），相对于当前服务器时间，使用“-”表示负偏移

根

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

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

属性

• p.offset

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

• p.limit

  指示页面大小的数字

• p.guessTotal

  推荐：避免计算全部结果总和，代价昂贵；一个数字，表示最大总数最多可计算（例如1000，该数字为用户提供对粗略大小和精确数字的足够反馈以获得较小结果），或“ true”，以仅计算最小必要值p.offset + p.limit

• p.摘录

  如果设置为“ 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

作为子组谓词，将保留的querybuilder查询的所有谓词包含到当前查询中。

请注意，这不会执行额外查询，而会扩展当前查询。

查询可以使用QueryBuilder#storeQuery()以编程方式持久化。 格式可以是多行String属性或nt:file节点，该节点将查询作为Java属性格式的文本文件。

不支持已保存提取的谓词的facet查询。

属性

• savedquery

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

类似

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

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

属性

• 相
  似绝对路径，指向要查找相似节点的节点

• 到
  子节点或子节点的locala相对路径
  . 对于当前节点(可选，默认为“ .”)

标签

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

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

属性

• 标签

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

• N_value

  使用1_value、2_value、…检查多个标记（默认情况下与OR组合，如果与=true，则与AND组合）（自5.6起）

• 属性

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

tagid

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

支持facet提取。 将使用每个唯一标记的当前标记ID为其提供桶。

属性

• tagid

  要查找的标记id，例如" properties:orientation/landscape"

• N_value

  使用1_value、2_value、…检查多个标记（默认情况下与OR结合，如果与=true，则与AND结合）（自5.6起）

• 属性

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

tagsearch

通过指定关键字搜索用一个或多个标记标记的内容。 这将首先搜索标题中包含这些关键字的标记，然后将结果限制为仅包含这些关键字的标记。

不支持facet提取。

属性

• 标语

  用于在标记标题中搜索的关键字

• 属性

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

• 朗

  仅搜索特定的本地化标记标题(例如，" de"

• 全部

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

类型

将结果限制为特定的JCR节点类型，主节点类型或混合类型。 此外，还将查找该节点类型的子类型。 请注意，存储库搜索索引需要涵盖节点类型，以便有效执行。

支持facet提取。 将为结果中的每个唯一类型提供时段。

属性

• 类型

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