查詢產生器述詞參考 query-builder-predicate-reference
一般 general
述詞 predicates
布林屬性 boolproperty
符合JCR布林值屬性。 僅接受值" true"和" false"。 若為" false"，則符合屬性是否具有" false"值或根本不存在。 這對於檢查只在啟用時才會設定的布林值標幟很有用。
繼承的" operation"引數沒有意義。
支援多面向擷取。 提供每個true或false值的值區，但僅限現有屬性。
屬性 properties
-
boolproperty
屬性的相對路徑，例如myFeatureEnabled或jcr:content/myFeatureEnabled。 -
值
要檢查「true」或「false」之屬性的值。
contentfragment contentfragment
將結果限制在內容片段。
不支援篩選。
不支援多面向擷取。
屬性 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年以來的毫秒數。
您可以尋找兩個時間戳記之間的任何專案，或比指定日期新或舊的專案，也可以選擇介於包含間隔和開啟間隔之間的專案。
支援多面向擷取。 提供值區「今天」、「本週」、「本月」、「最近3個月」、「今年」、「去年」和「比去年早」。
不支援篩選。
屬性 properties-3
-
屬性
DATE屬性的相對路徑，例如jcr:lastModified。 -
lowerBound
檢查屬性的日期下限，例如
2014-10-01。 -
lowerOperation
「
>」（較新）或「>=」（等於或較新）適用於lowerBound。 預設值為">"。 -
上限
檢查屬性的上限，例如
2014-10-01T12:15:00。 -
upperOperation
「
<」（較舊）或「<=」（等於或較舊），適用於upperBound。 預設值為"<"。 -
時區
未指定為ISO-8601日期字串時要使用的時區ID。 預設為系統的預設時區。
排除路徑 excludepaths
從結果中排除其路徑符合規則運算式的節點。
這是僅供篩選的述詞，無法使用搜尋索引。
不支援多面向擷取。
屬性 properties-4
-
excludepaths
符合結果路徑的規則運算式，將符合的路徑排除在結果之外。
全文 fulltext
搜尋全文檢索索引中的詞語。
不支援篩選。
不支援多面向擷取。
屬性 properties-5
-
全文
全文檢索搜尋詞。
-
relPath
在屬性或子節點中搜尋的相對路徑。 此屬性是選用的。
群組 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.not
若設為"
true"，此專案會讓群組無效（預設為"false"）。 -
<述詞>
新增巢狀述詞。
-
N_<述詞>
新增多個相同的巢狀述詞，例如
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
-
mainasset
布林值，主要資產為"
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。 -
排序
排序方向，
desc代表遞減，asc代表遞增（預設）。 -
個案例
若設為
ignore，排序會不區分大小寫，表示「a」在「B」之前；若為空白或省略，排序會區分大小寫，表示「B」在「a」之前
路徑 path
在指定路徑內搜尋。
不支援多面向擷取。
屬性 properties-14
-
path
路徑模式。 視精確而定，整個子樹狀結構相符（例如在xpath中附加
//*，但請注意，這不包括基底路徑） （精確=false，預設），或只有精確路徑相符，其中可能包括萬用字元(*)；如果設定self，則會搜尋包含基底節點的整個子樹狀結構。 -
完全
如果
exact為true/on，則確切的路徑必須相符，但它可以包含簡單萬用字元(*)，這些萬用字元符合名稱，但不符合「/」；如果為false （預設），則會包含所有子代（選擇性）。 -
平坦
僅搜尋直接子系（例如在xpath中附加"
/*"） (僅在'exact'不是true （選用）時使用)。 -
self
搜尋子樹狀結構，但包含指定作為路徑的基本節點（無萬用字元）。
屬性 property
符合JCR屬性及其值。
支援多面向擷取。 為結果中的每個唯一屬性值提供值區。
屬性 properties-15
-
屬性
屬性的相對路徑，例如
jcr:title。 -
值
要檢查屬性的值；遵循JCR屬性型別進行字串轉換。
-
N_value
使用
1_value、2_value、…檢查多個值（預設會結合OR，若為AND，且為AND=TRUE） （自5.3起）。 -
和
設定為True以結合多個值(
N_value)與AND （自5.3起）。 -
作業
equals、完全相符（預設）、unequals、不相等比較、like、使用jcr:likexpath函式（選用）、not、無相符（例如xpath中的not(@prop)、忽略值引數）或exists、存在性檢查（值可以是true — 屬性必須存在，預設 — 或false — 與not）相同。 -
深度
屬性/相對路徑可存在的萬用字元層級數目（例如，
property=size depth=2會檢查節點/大小、節點/&； AST；/大小和節點/&； AST；/&； AST；/size）。
rangeproperty rangeproperty
比對JCR屬性與間隔。 這適用於具有線性型別的屬性，例如LONG、DOUBLE和DECIMAL。 若為DATE，請參閱具有最佳化日期格式輸入的日期範圍述詞。
您可以定義下限與上限，或僅定義其中一個。 也可以分別針對下限與上限指定操作（例如「小於」或「小於或等於」）。
不支援多面向擷取。
屬性 properties-16
-
屬性
屬性的相對路徑。
-
lowerBound
檢查屬性的下限。
-
lowerOperation
「
>」（預設）或「>=」，套用至lowerValue -
上限
檢查屬性的上限。
-
upperOperation
「
<」（預設）或「<=」，套用至lowerValue -
decimal
如果核取的屬性型別為Decimal，則為"
true"
相對日期範圍 relativedaterange
使用相對於目前伺服器時間的時間位移，以日期/時間間隔比對JCR DATE屬性。 您可以使用毫秒值或Bugzilla語法1s 2m 3h 4d 5w 6M 7y （一秒、兩分鐘、三小時、四天、五週、六個月、七年）來指定lowerBound和upperBound。 前置詞為" -"，表示目前時間之前的負位移。 如果您只指定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（一秒、兩分鐘、三小時、四天、五週、六個月、七年），使用「 — 」表示負位移。 -
lowerBound
以毫秒為單位或相對於目前伺服器時間的
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()以程式設計方式保留查詢。 格式可以是多行String屬性，或是以Java™屬性格式將查詢作為文字檔案包含的nt:file節點。
不支援為已儲存查詢的述詞擷取Facet。
屬性 properties-19
-
savedquery
已儲存查詢的路徑（字串屬性或
nt:file節點）。
相似 similar
使用JCR XPath的rep:similar()進行相似性搜尋。
不支援篩選。 不支援多面向擷取。
屬性 properties-20
-
類似
要尋找類似節點之節點的絕對路徑。 -
本機
子系節點的相對路徑或目前節點的.（選擇性，預設為"."）。
標籤 tag
透過指定標籤標題路徑，搜尋以一或多個標籤標籤標籤的內容。
支援多面向擷取。 使用每個唯一標籤的目前標籤標題路徑，為其提供貯體。
屬性 properties-21
-
標籤
要尋找的標籤標題路徑，例如「資產屬性：方向/橫向」。
-
N_value
使用
1_value、2_value、…來檢查多個標籤（預設會與OR結合，若為AND且為AND=TRUE） （自5.6起）。 -
屬性
要檢視的屬性（或屬性的相對路徑） （預設"
cq:tags"）
標籤ID tagid
透過指定標籤ID來搜尋以一個或多個標籤標籤的內容。
支援多面向擷取。 使用每個唯一標籤的目前標籤ID提供貯體。
屬性 properties-22
-
tagid
標籤ID，讓您尋找"
properties:orientation/landscape"之類的標籤。 -
N_value
使用
1_value、2_value、…檢查多個Tagid （預設會與OR結合，若為AND且為True） （自5.6起）。 -
屬性
要檢視的屬性（或屬性的相對路徑） （預設為"
cq:tags"）。
tagsearch tagsearch
透過指定關鍵字，搜尋標籤有一或多個標籤的內容。 這會先搜尋標題中包含這些關鍵字的標籤，然後將結果限製為僅搜尋具有這些標籤的專案。
不支援多面向擷取。
屬性 Properties-1
-
tagsearch
要在標籤標題中搜尋的關鍵字。
-
屬性
要檢視的屬性（或屬性的相對路徑） （預設
cq:tags）。 -
lang
只搜尋特定當地語系化標籤標題（例如，
de）。 -
全部
（布林值）搜尋整個標籤全文，也就是所有標題、說明等。 優先於「l
ang」。
類型 type
將結果限製為特定的JCR節點型別，包括主要節點型別或mixin型別。 這也會尋找該節點型別的子型別。 存放庫搜尋索引必須涵蓋節點型別，才能有效執行。
支援多面向擷取。 為結果中的每個唯一型別提供值區。
屬性 Properties-2
-
型別
要搜尋的節點型別或mixin名稱，例如
cq:Page。