查詢產生器述詞參考 query-builder-predicate-reference
一般 general
述詞 predicates
布林屬性 boolproperty
符合JCR布林值屬性。 僅接受值" true
「和」 false
「。 若為「 false
",如果屬性的值為",則會相符 false
」或如果它根本不存在。 這對於檢查只在啟用時才會設定的布林值標幟很有用。
繼承的" operation
「引數沒有意義。
支援多面向擷取。 提供儲存貯體給每個 true
或 false
值,但僅適用於現有屬性。
屬性 properties
-
布林屬性
屬性的相對路徑,例如,myFeatureEnabled
或jcr:content/myFeatureEnabled
. -
值
要檢查屬性的值, "true
「或」false
「。
contentfragment contentfragment
將結果限制在內容片段。
不支援篩選。
不支援多面向擷取。
屬性 properties-1
- contentfragment
它可與任何值搭配使用,以檢查內容片段。
dateComparison datecomparison
比較兩個JCR DATE屬性彼此。 您可以測試這些值是否相等、不相等、大於或大於或等於。
這是僅供篩選的述詞,無法使用搜尋索引。
屬性 properties-2
-
property1
第一個日期屬性的路徑。
-
property2
第二個日期屬性的路徑。
-
操作
"
equals
",以取得完全相符的結果, "!=
「若為不相等比較, 」greater
",代表property1大於property2, ">=
" (屬性1大於或等於property2)。 預設值為"equals
「。
日期範圍 daterange
比對JCR DATE屬性與日期/時間間隔。 這會在日期和時間使用ISO8601格式( YYYY-MM-DDTHH:mm:ss.SSSZ
)並允許部分表示,例如 YYYY-MM-DD
. 或者,時間戳記也可以提供為UTC時區(UNIX®時間格式)自1970年以來的毫秒數。
您可以尋找兩個時間戳記之間的任何專案,或比指定日期新或舊的專案,也可以選擇介於包含間隔和開啟間隔之間的專案。
支援多面向擷取。 提供值區「今天」、「本週」、「本月」、「最近3個月」、「今年」、「去年」和「比去年早」。
不支援篩選。
屬性 properties-3
-
屬性
相對路徑
DATE
屬性,例如,jcr:lastModified
. -
下限
用於檢查屬性的日期下限,例如,
2014-10-01
. -
lowerOperation
"
>
「 (較新)或」>=
「 (在或更新版本),套用至lowerBound
. 預設為">
「。 -
上限
檢查屬性的上限,例如,
2014-10-01T12:15:00
. -
upperOperation
"
<
「 (較舊)或」<=
「 (等於或大於),適用於upperBound
. 預設為"<
「。 -
時區
未指定為ISO-8601日期字串時要使用的時區ID。 預設為系統的預設時區。
排除路徑 excludepaths
從結果中排除其路徑符合規則運算式的節點。
這是僅供篩選的述詞,無法使用搜尋索引。
不支援多面向擷取。
屬性 properties-4
-
排除路徑
符合結果路徑的規則運算式,將符合的路徑排除在結果之外。
全文 fulltext
搜尋全文檢索索引中的詞語。
不支援篩選。
不支援多面向擷取。
屬性 properties-5
-
全文
全文檢索搜尋詞。
-
Repath
在屬性或子節點中搜尋的相對路徑。 此屬性是選用的。
群組 group
允許建立巢狀條件。 群組可以包含巢狀群組。 查詢產生器查詢中的所有專案都會以隱含方式位於根群組中,根群組可以有 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聯結需要良好的索引來提升效能。
屬性 properties-6
-
p.或
若設為"
true
「」,群組中只能有一個相符的述詞。 此預設為"false
",表示所有條件都必須符合 -
p.非
若設為"
true
「」,這會讓群組失效(預設為「」false
「)。 -
<predicate>
新增巢狀述詞。
-
N_<predicate>
同時新增多個巢狀述詞,例如
1_property, 2_property, ...
.
hasPermission haspermission
將結果限制在目前工作階段具有指定值的專案 JCR許可權。
這是僅供篩選的述詞,無法使用搜尋索引。 不支援多面向擷取。
屬性 properties-7
-
hasPermission
目前使用者工作階段必須全部有問題節點的逗號分隔JCR許可權。 例如,
jcr:write
,jcr:modifyAccessControl
.
語言 language
尋找特定語言的CQ頁面。 這會檢視頁面語言屬性和頁面路徑,後者通常包含頂層網站結構中的語言或地區設定。
這是僅供篩選的述詞,無法使用搜尋索引。
支援多面向擷取。 提供每個唯一語言代碼的貯體。
屬性 properties-8
-
語言
ISO語言代碼,例如「
de
"
主要資產 mainasset
檢查節點是否為DAM主要資產而非子資產。 這基本上是每個不在「子資產」節點內的節點。 這不會檢查 dam:Asset
節點型別。 若要使用此述詞,請設定" mainasset=true
「或」 mainasset=false
「」,沒有其他屬性。
這是僅供篩選的述詞,無法使用搜尋索引。
支援面向擷取,並為主要和子資產提供兩個貯體。
屬性 properties-9
-
主要資產
布林值, "
true
"適用於主要資產, "false
」作為子資產。
memberOf memberof
尋找屬於特定成員的專案 sling資源集合.
這是僅供篩選的述詞,無法使用搜尋索引。 不支援多面向擷取。
屬性 properties-10
-
memberOf
Sling資源集合的路徑。
nodename nodename
符合JCR節點名稱。
支援多面向擷取。 提供每個唯一節點名稱(檔案名稱)的貯體。
屬性 properties-11
-
nodename
允許萬用字元的節點名稱模式:
*
=任何或無字元,?
=任何字元,[abc]
=僅括弧中的字元。
notexpired notexpired
透過檢查JCR DATE屬性是否大於或等於目前伺服器時間來比對專案。 這可用來檢查「 expiresAt
」喜歡日期屬性,並限製為僅限尚未過期的屬性( notexpired=true
)或已過期的( notexpired=false
)。
不支援篩選。
以與日期範圍述詞相同的方式支援多面向擷取。
屬性 properties-12
-
notexpired
布林值, "
true
「適用於尚未過期(未來日期或相等), 」false
「代表已過期(過去的日期) (必要)。 -
屬性
相對路徑
DATE
要檢查的屬性(必要)。
orderby orderby
允許對結果進行排序。 如果需要依多個屬性排序,則必須使用數字首碼多次新增此述詞,例如 1_orderby=first
, 2_oderby=second
.
屬性 properties-13
-
orderby
JCR屬性名稱由前導@表示,例如,
@jcr:lastModified
或@jcr:content/jcr:title
,或查詢中的其他述詞,例如,2_property
,依此排序。 -
sort
排序方向, 「
desc
"表示降序或"asc
"以遞增方式顯示(預設)。 -
案例
如果設為
ignore
,因此排序不區分大小寫,表示「a」在「B」之前;如果為空白或省略,排序會區分大小寫,表示「B」在「a」之前
路徑 path
在指定路徑內搜尋。
不支援多面向擷取。
屬性 properties-14
-
path
路徑模式。 視完全相符而定,可能是整個子樹狀結構相符(如附加
//*
在xpath中,但請注意,其中不包含基本路徑) (exact=false,預設),或只有完全相符的路徑,其中可能包含萬用字元(*
);如果設定self,則會搜尋包含基底節點的整個子樹狀結構。 -
精確
如果
exact
為true/on,確切路徑必須相符,但可包含簡單萬用字元(*
),但與「/
";若為false (預設),則會包含所有下階(選用)。 -
平坦
僅搜尋直接子項(如附加)
/*
在xpath中的「」) (僅用於「exact
'不是true,是選擇性的)。 -
自我
搜尋子樹狀結構,但包含指定作為路徑的基本節點(無萬用字元)。
屬性 property
符合JCR屬性及其值。
支援多面向擷取。 為結果中的每個唯一屬性值提供值區。
屬性 properties-15
-
屬性
屬性的相對路徑,例如,
jcr:title
. -
值
要檢查屬性的值;遵循JCR屬性型別進行字串轉換。
-
N_value
使用
1_value
,2_value
, …以檢查多個值(與OR
依預設,使用AND
if和=true) (從5.3開始)。 -
和
設定為True可組合多個值(
N_value
)和(自5.3開始)。 -
操作
"
equals
",以取得完全相符的結果(預設), "unequals
「若為不相等比較, 」like
",表示使用jcr:like
xpath函式(選用), "not
",表示沒有相符專案(例如, "not(@prop)
「在xpath中,值引數會被忽略)或」exists
存在性檢查(值可以是true — 屬性必須存在,預設 — 或false — 與"not
「)。 -
深度
屬性/相對路徑可以存在的萬用字元層級數目(例如,
property=size depth=2
檢查節點/大小、節點/&ast;/大小以及節點/&ast;/&ast;/size)。
rangeproperty rangeproperty
比對JCR屬性與間隔。 這適用於具有線性型別的屬性,例如 LONG
, DOUBLE
、和 DECIMAL
. 的 DATE
,請參閱已最佳化日期格式輸入的日期範圍述詞。
您可以定義下限與上限,或僅定義其中一個。 也可以分別針對下限與上限指定操作(例如「小於」或「小於或等於」)。
不支援多面向擷取。
屬性 properties-16
-
屬性
屬性的相對路徑。
-
下限
檢查屬性的下限。
-
lowerOperation
"
>
「 (預設)或」>=
",適用於lowerValue
-
上限
檢查屬性的上限。
-
upperOperation
"
<
「 (預設)或」<=
",適用於lowerValue
-
小數
"
true
" (如果核取的屬性是小數型別)
相對日期範圍 relativedaterange
符合 JCR DATE
屬性會使用相對於目前伺服器時間的時間位移,以針對日期/時間間隔設定。 您可以指定 lowerBound
和 upperBound
使用毫秒值或bugzilla語法 1s 2m 3h 4d 5w 6M 7y
(一秒、兩分鐘、三小時、四天、五週、六個月、七年)。 前置詞為" -
」表示目前時間之前的負位移。 如果您只指定 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天。
不支援篩選。
以與日期範圍述詞相同的方式支援多面向擷取。
屬性 properties-17
-
上限
日期上限(以毫秒為單位)或
1s 2m 3h 4d 5w 6M 7y
(一秒、兩分鐘、三小時、四天、五週、六個月、七年)相對於目前伺服器時間,使用「 — 」代表負位移。 -
下限
以毫秒為單位的下限日期或
1s 2m 3h 4d 5w 6M 7y
(一秒、兩分鐘、三小時、四天、五週、六個月、七年)相對於目前伺服器時間,使用「 — 」代表負位移。
根 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服務擴充):
-
簡單:
最小專案,例如
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 savedquery
將持續查詢產生器查詢的所有述詞納入目前查詢,做為子群組述詞。
這不會執行額外的查詢,但會擴充目前的查詢。
可使用以下程式設計方式儲存查詢 QueryBuilder#storeQuery()
. 格式可以是多行字串屬性或 nt:file
以Java™屬性格式包含查詢作為文字檔案的節點。
不支援為已儲存查詢的述詞擷取Facet。
屬性 properties-19
-
savedquery
已儲存查詢的路徑(字串屬性或
nt:file
節點)。
相似 similar
使用JCR XPath的相似性搜尋 rep:similar()
.
不支援篩選。 不支援多面向擷取。
屬性 properties-20
-
相似
要尋找類似節點之節點的絕對路徑。 -
本機
下級節點的相對路徑,或.
目前節點的(選擇性,預設為".
「)。
標籤 tag
透過指定標籤標題路徑,搜尋以一或多個標籤標籤標籤的內容。
支援多面向擷取。 使用每個唯一標籤的目前標籤標題路徑,為其提供貯體。
屬性 properties-21
-
標籤
要尋找的標籤標題路徑,例如「資產屬性:方向/橫向」。
-
N_value
使用
1_value
,2_value
, …以檢查多個標籤(與OR
依預設,使用AND
if和=true) (從5.6開始)。 -
屬性
要檢視的屬性(或屬性的相對路徑) (預設"
cq:tags
")
標籤ID tagid
透過指定標籤ID來搜尋以一個或多個標籤標籤的內容。
支援多面向擷取。 使用每個唯一標籤的目前標籤ID提供貯體。
屬性 properties-22
-
標籤ID
標籤ID,方便您尋找,例如"
properties:orientation/landscape
「。 -
N_value
使用
1_value
,2_value
, …以檢查多個tagid (與OR
依預設,使用AND
if和=true) (從5.6開始)。 -
屬性
要檢視的屬性(或屬性的相對路徑) (預設"
cq:tags
「)。
tagsearch tagsearch
透過指定關鍵字,搜尋標籤有一或多個標籤的內容。 這會先搜尋標題中包含這些關鍵字的標籤,然後將結果限製為僅搜尋具有這些標籤的專案。
不支援多面向擷取。
屬性 Properties-1
-
tagsearch
要在標籤標題中搜尋的關鍵字。
-
屬性
要檢視的屬性(或屬性的相對路徑) (預設)
cq:tags
)。 -
lang
僅搜尋特定當地語系化標籤標題(例如:
de
)。 -
全部
(布林值)搜尋整個標籤全文,也就是所有標題、說明等。 優先於「l」
ang
「。
類型 type
將結果限製為特定的JCR節點型別,包括主要節點型別或mixin型別。 這也會尋找該節點型別的子型別。 存放庫搜尋索引必須涵蓋節點型別,才能有效執行。
支援多面向擷取。 為結果中的每個唯一型別提供值區。
屬性 Properties-2
-
type
要搜尋的節點型別或mixin名稱,例如
cq:Page
.