Show Menu
主題×

Query Builder Predicate Reference

謂語

布爾屬性

在JCR布爾屬性上匹配。 僅接受值" true "和" false "。 如果是" false ",則屬性是否具有" false "或完全不存在,則會相符。 這對於檢查僅在啟用時設定的布爾標誌非常有用。
繼承的" operation "參數沒有意義。
支援Facet擷取。 將為每個或值提 true 供時 false 段,但僅為現有屬性提供。

屬性

  • boolproperty ​屬性的相對路徑,例如 myFeatureEnabled jcr:content/myFeatureEnabled
  • ​值,用於檢查屬 true 性「」或「 false

contentfragment

將結果限制為內容片段。
不支援篩選。
不支援Facet擷取。

屬性

  • contentfragment ​它可與任何值搭配使用,以檢查內容片段。

dateComparison

將兩個JCR DATE屬性相互比較。 可以測試它們是等於、不等於、大於或等於。
這是僅限篩選的謂語,無法運用搜尋索引。

屬性

  • property1
    第一個日期屬性的路徑
  • property2
    路徑至第二個日期屬性
  • 操作
    " = "表示完全匹配, " != "表示不等式比較, " > "表示屬性1大於屬性2, " >= "表示屬性1大於或等於屬性2。 預設值為" = "。

達朗日

與日期/時間間隔的JCR DATE屬性相符。 這會使用ISO8601格式來處理日期和時間( YYYY-MM-DDTHH:mm:ss.SSSZ ),並允許部分表示,例如 YYYY-MM-DD 。 或者,時間戳可以以1970年以來的毫秒數提供,以UTC時區(UNIX時間格式)表示。
您可以尋找兩個時間戳記之間的任何項目(任何比指定日期更新或更舊的項目),也可以選擇包含和開啟的間隔。
支援Facet擷取。 將提供「今天」、「本週」、「本月」、「最近3個月」、「今年」、「去年」和「比去年早」的時段。
不支援篩選。

屬性

  • 屬性
    屬性的相 DATE 對路徑,例如 jcr:lastModified
  • 下界
    lower date bound to check property for,例如 2014-10-01
  • lowerOperation
    " > "(較新)或" >= "(at或更新),則套用至 lowerBound 。 預設值為「 > 」。
  • 上界
    上界檢查屬性,例如 2014-10-01T12:15:00
  • upperOperation
    " < "(舊版)或" <= "(舊版),則適用於 upperBound 。 預設值為「 < 」。
  • 時區
    未指定為ISO-8601日期字串時使用的時區ID。 預設為系統的預設時區。

排除路徑

從其路徑與規則運算式匹配的結果中排除節點。
這是僅限篩選的謂語,無法運用搜尋索引。
不支援Facet擷取。

屬性

  • 排除路徑
    規則運算式與結果路徑相符,從結果中排除相符的運算式。

fulltext

在全文索引中搜尋詞語。
不支援篩選。
不支援Facet擷取。

屬性

  • 全文
    全文搜尋詞
  • relPath
    屬性或子節點中要搜索的相對路徑。 此屬性為可選屬性。

群組

允許建立巢狀條件。 群組可以包含巢狀群組。 查詢建立工具查詢中的所有項目都會隱式顯示在根群組中,而根群組 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 是OR 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
    當前用戶會話必須ALL對有問題的節點具有的逗號分隔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擷取。 將為每個唯一節點名稱(檔案名)提供儲存段。

屬性

  • nodename
    允許通配符的節點名模式: * =任何或無字元, ? =任何字元, [abc] =只有方括弧的字元

notexpired

檢查JCR DATE屬性是否大於或等於目前伺服器時間,以比對項目。 這可用來檢查「 expiresAt 」類似日期屬性,並僅限於尚未到期( notexpired=true )或已到期( notexpired=false )的屬性。
不支援篩選。
支援Facet擷取,其方式與daterange謂詞相同。

屬性

  • 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, default)或僅匹配完全路徑(可包括通配符( * ));如果設定了self,則搜索包含基節點的整個子樹
  • 精確
    exact 果為true/on,則精確路徑必須相符,但可包含簡單的萬用字元( * )、相符名稱,但不是" / ";如果為false(預設),則會包含所有子系(選用)
  • 扁平
    僅搜索直接子項(如在xpath中附加" /* ")(僅在「 exact '不是true時使用,可選)
  • self
    搜索子樹,但包括作為路徑給定的基節點(無通配符)

屬性

與JCR屬性及其值相符。
支援Facet擷取。 將為結果中的每個唯一屬性值提供時段。

屬性

  • 屬性
    屬性的相對路徑,例如 jcr:title
  • 值以檢查屬性;跟隨JCR屬性類型到字串轉換
  • N值
    使 1_value 2_value , ...若要檢查多個值(依預 OR 設結合, AND 含if和=true)(自5.3起)
  • 設為true,以組合多個值( N_value )與AND(自5.3起)
  • 操作
    equals 」代表完全符合(預設),「 unequals 」代表不等式比較,「 like 」代表使用 jcr:like xpath函式(選用),「 not 」代表不符合(例如 xpath中 not(@prop) 的" ",值param將被忽略)或" exists "以檢查是否存在(值可以是true —— 屬性必須存在,預設——或false —— 與" not "相同)
  • 深度
    屬性/相對路徑可存在的通配符級別數(例如, property=size depth=2 將檢查節點/大小、node/&ast;/size和node/&ast;/&ast;/sast;/&/size)

rangeproperty

與JCR屬性對應的時間間隔。 這適用於線性類型(例如, LONG DOUBLE )的屬性 DECIMAL 。 如需 DATE 資訊,請參閱已最佳化日期格式輸入的daterange謂詞。
您可以定義下界和上界,或僅定義其中一個。 操作(如 也可以針對下界限和上界限分別指定「小於」或「小於或等於」)。
不支援Facet擷取。

屬性

  • 屬性
    相對路徑至屬性
  • 下界
    下界檢查屬性
  • lowerOperation
    > 」(預設值)或「 >= 」,套用至 lowerValue
  • 上界
    上界檢查屬性
  • upperOperation
    < 」(預設值)或「 <= 」,套用至 lowerValue
  • 小數點
    " true "如果選定的屬性類型為Decimal

相對變更

使用 JCR DATE 相對於目前伺服器時間的時間偏移,比對日期/時間間隔的屬性。 您可以指 lowerBound 定並使 upperBound``1s 2m 3h 4d 5w 6M 7y 用毫秒值或bugzilla語法(一秒、二分鐘、三小時、四天、五週、六個月、七年)。 首碼為" - ",表示目前時間前有負偏移。 如果您只指 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擷取,其方式與daterange謂詞相同。

屬性

  • 上界
    相對於目前伺服器時間的上限日期界限(一秒、二分鐘、三小時、四天、五週、六個月、七年),使用「-」作為負偏移 1s 2m 3h 4d 5w 6M 7y
  • 下界
    相對於目前伺服器時間的較低日期界限(一秒、二分鐘、三小時、四天、五週、六個月、七年),使用「-」作為負偏移 1s 2m 3h 4d 5w 6M 7y

root

根謂片語。 支援群組的所有功能,並允許設定全域查詢參數。
「root」名稱從未用於查詢,它是隱式的。

屬性

  • p.offset
    表示結果頁面開始的編號,即要略過的項目數
  • p.limit
    表示頁面大小的數字
  • p.guessTotal
    建議:避免計算全部結果總和,代價高昂;指出總計上限的數字(例如1000,此數字可讓使用者獲得對粗細大小的足夠回饋,並提供精確數字以取得較小結果)或「 true 」只計算最小必要 p.offset + p.limit
  • p.expert
    如果設為" 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#storeQuery() 。 格式可以是多行String屬性,也可以是包含查詢 nt:file 的節點,該查詢是Java屬性格式的文本檔案。
不支援儲存查詢的謂語的Facet擷取。

屬性

  • savedquery
    已保存查詢的路徑(字串屬性或節 nt:file 點)

相似

使用JCR XPath的相似性搜索 rep:similar()
不支援篩選。 不支援Facet擷取。

屬性

  • ​似的絕對路徑,指向要查找相似節點的節點
  • ​地指向子節點或當前節 . 點的相對路徑(可選,預設為「 . 」)

tag

透過指定標籤標題路徑,搜尋以一或多個標籤標籤的內容。
支援Facet擷取。 將使用每個唯一標籤的目前標籤標題路徑,為每個標籤提供區段。

屬性

  • 標籤
    要尋找的標籤標題路徑,例如「資產屬性:方向/橫向」
  • N值
    使 1_value 2_value , ...若要檢查多個標籤(依預 OR 設結合, AND 含if和=true)(自5.6起)
  • 屬性
    屬性(或屬性的相對路徑)以查看(預設為" cq:tags ")

tagid

透過指定標籤ID,搜尋以一或多個標籤標籤的內容。
支援Facet擷取。 將使用每個唯一標籤的目前標籤ID來提供區段。

屬性

  • tagid
    要尋找的標籤ID,例如" properties:orientation/landscape "
  • N值
    使 1_value 2_value , ...若要檢查多個標語(依預 OR 設結合, AND 含if和=true)(自5.6起)
  • 屬性
    屬性(或屬性的相對路徑)以查看(預設為" cq:tags ")

tagsearch

透過指定關鍵字,搜尋以一或多個標籤標籤的內容。 這會先搜尋標題中包含這些關鍵字的標籤,然後將結果限制為僅包含這些標籤的項目。
不支援Facet擷取。

屬性

  • tagsearch
    在標籤標題中搜尋的關鍵字
  • 屬性
    屬性(或屬性的相對路徑)以查看(預設為" cq:tags ")
  • lang
    僅在特定本地化標籤標題中搜尋(例如" de ")
  • 全部
    (bool)搜尋整個標籤全文,即所有標題、說明等。 (優先於"l ang ")

類型

將結果限制為特定的JCR節點類型,包括主節點類型或混合類型。 這也會找出該節點類型的子類型。 請注意,儲存庫搜索索引需要涵蓋節點類型,以便高效執行。
支援Facet擷取。 將為結果中的每個唯一類型提供時段。

屬性

  • 類型
    節點類型或混合名稱以進行搜索,例如 cq:Page