查詢產生器述詞參考

一般

• 根
• 群組
• orderby

述詞

• 布林屬性
• contentfragment
• dateComparison
• 日期範圍
• 排除路徑
• 全文
• hasPermission
• 語言
• 主要資產
• memberOf
• nodename
• notexpired
• path
• 屬性
• rangeproperty
• 相對日期範圍
• savedquery
• 相似
• 標籤
• 標籤ID
• tagsearch
• 類型

布林屬性

符合JCR布林值屬性。 僅接受值" true「和」 false「。 若為「 false"，如果屬性的值為"，則會相符 false」或如果它根本不存在。 這對於檢查只在啟用時才會設定的布林值標幟很有用。

繼承的" operation「引數沒有意義。

支援多面向擷取。 提供儲存貯體給每個 true 或 false 值，但僅適用於現有屬性。

屬性

• 布林屬性
  屬性的相對路徑，例如， myFeatureEnabled 或 jcr:content/myFeatureEnabled.

• 值
  要檢查屬性的值， " true「或」 false「。

contentfragment

將結果限制在內容片段。

不支援篩選。

不支援多面向擷取。

屬性

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

dateComparison

比較兩個JCR DATE屬性彼此。 您可以測試這些值是否相等、不相等、大於或大於或等於。

這是僅供篩選的述詞，無法使用搜尋索引。

屬性

• property1

  第一個日期屬性的路徑。

• property2

  第二個日期屬性的路徑。

• 操作

  " equals"，以取得完全相符的結果， " !=「若為不相等比較， 」 greater"，代表property1大於property2， " >=" （屬性1大於或等於property2）。 預設值為 " equals".

日期範圍

比對JCR DATE屬性與日期/時間間隔。 這會在日期和時間使用ISO8601格式( YYYY-MM-DDTHH:mm:ss.SSSZ)並允許部分表示，例如 YYYY-MM-DD. 或者，時間戳記也可以提供為UTC時區(UNIX®時間格式)自1970年以來的毫秒數。

您可以尋找兩個時間戳記之間的任何專案，或比指定日期新或舊的專案，也可以選擇介於包含間隔和開啟間隔之間的專案。

支援多面向擷取。 提供值區「今天」、「本週」、「本月」、「最近3個月」、「今年」、「去年」和「比去年早」。

不支援篩選。

屬性

• 屬性

  相對路徑 DATE 屬性，例如， jcr:lastModified.

• 下限

  用於檢查屬性的日期下限，例如， 2014-10-01.

• lowerOperation

  " >「 （較新）或」 >=「 （在或更新版本），套用至 lowerBound. 預設為" >「。

• 上限

  檢查屬性的上限，例如， 2014-10-01T12:15:00.

• upperOperation

  " <「 （較舊）或」 <=「 （等於或大於），適用於 upperBound. 預設為" <「。

• 時區

  未指定為ISO-8601日期字串時要使用的時區ID。 預設為系統的預設時區。

排除路徑

從結果中排除其路徑符合規則運算式的節點。

這是僅供篩選的述詞，無法使用搜尋索引。

不支援多面向擷取。

屬性

• 排除路徑

  符合結果路徑的規則運算式，將符合的路徑排除在結果之外。

全文

搜尋全文檢索索引中的詞語。

不支援篩選。

不支援多面向擷取。

屬性

• 全文

  全文檢索搜尋詞。

• Repath

  在屬性或子節點中搜尋的相對路徑。 此屬性是選用的。

群組

允許建立巢狀條件。 群組可以包含巢狀群組。 查詢產生器查詢中的所有專案都會以隱含方式位於根群組中，根群組可以有 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.或

  若設為" true「」，群組中只能有一個相符的述詞。 此預設為" false"，表示所有條件都必須符合

• p.非

  若設為" true「」，這會讓群組失效(預設為「」 false「)。

• <predicate>

  新增巢狀述詞。

• N_<predicate>

  同時新增多個巢狀述詞，例如 1_property, 2_property, ....

hasPermission

將結果限制在目前工作階段具有指定值的專案 JCR許可權。

這是僅供篩選的述詞，無法使用搜尋索引。 不支援多面向擷取。

屬性

• hasPermission

  目前使用者工作階段必須全部有問題節點的逗號分隔JCR許可權。 例如， jcr:write， jcr:modifyAccessControl.

語言

尋找特定語言的CQ頁面。 這會檢視頁面語言屬性和頁面路徑，後者通常包含頂層網站結構中的語言或地區設定。

這是僅供篩選的述詞，無法使用搜尋索引。

支援多面向擷取。 提供每個唯一語言代碼的貯體。

屬性

• 語言

  ISO語言代碼，例如「de"

主要資產

檢查節點是否為DAM主要資產而非子資產。 這基本上是每個不在「子資產」節點內的節點。 這不會檢查 dam:Asset 節點型別。 若要使用此述詞，請設定" mainasset=true「或」 mainasset=false「」，沒有其他屬性。

這是僅供篩選的述詞，無法使用搜尋索引。

支援面向擷取，並為主要和子資產提供兩個貯體。

屬性

• 主要資產

  布林值， " true"適用於主要資產， " false」作為子資產。

memberOf

尋找屬於特定成員的專案 sling資源集合.

這是僅供篩選的述詞，無法使用搜尋索引。 不支援多面向擷取。

屬性

• memberOf

  Sling資源集合的路徑。

nodename

符合JCR節點名稱。

支援多面向擷取。 提供每個唯一節點名稱（檔案名稱）的貯體。

屬性

• nodename

  允許萬用字元的節點名稱模式： * =任何或無字元， ? =任何字元， [abc] =僅括弧中的字元。

notexpired

透過檢查JCR DATE屬性是否大於或等於目前伺服器時間來比對專案。 這可用來檢查「 expiresAt」喜歡日期屬性，並限製為僅限尚未過期的屬性( notexpired=true)或已過期的( notexpired=false)。

不支援篩選。

以與日期範圍述詞相同的方式支援多面向擷取。

屬性

• 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」之前

path

在指定路徑內搜尋。

不支援多面向擷取。

屬性

• path

  路徑模式。 視完全相符而定，可能是整個子樹狀結構相符(如附加 //* 在xpath中，但請注意，其中不包含基本路徑) （exact=false，預設），或只有完全相符的路徑，其中可能包含萬用字元( *)；如果設定self，則會搜尋包含基底節點的整個子樹狀結構。

• 精確

  如果 exact 為true/on，確切路徑必須相符，但可包含簡單萬用字元( *)，但與「 /"；若為false （預設），則會包含所有下階（選用）。

• 平坦

  僅搜尋直接子項（如附加） /*在xpath中的「」) (僅用於「 exact'不是true，是選擇性的)。

• self

  搜尋子樹狀結構，但包含指定作為路徑的基本節點（無萬用字元）。

屬性

符合JCR屬性及其值。

支援多面向擷取。 為結果中的每個唯一屬性值提供值區。

屬性

• 屬性

  屬性的相對路徑，例如， 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

比對JCR屬性與間隔。 這適用於具有線性型別的屬性，例如 LONG， DOUBLE、和 DECIMAL. 的 DATE，請參閱已最佳化日期格式輸入的日期範圍述詞。

您可以定義下限與上限，或僅定義其中一個。 也可以分別針對下限與上限指定操作（例如「小於」或「小於或等於」）。

不支援多面向擷取。

屬性

• 屬性

  屬性的相對路徑。

• 下限

  檢查屬性的下限。

• lowerOperation

  " >「 （預設）或」 >="，適用於 lowerValue

• 上限

  檢查屬性的上限。

• upperOperation

  " <「 （預設）或」 <="，適用於 lowerValue

• 小數

  " true" （如果核取的屬性是小數型別）

相對日期範圍

符合 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天。

不支援篩選。

以與日期範圍述詞相同的方式支援多面向擷取。

屬性

• 上限

  日期上限（以毫秒為單位）或 1s 2m 3h 4d 5w 6M 7y （一秒、兩分鐘、三小時、四天、五週、六個月、七年）相對於目前伺服器時間，使用「 — 」代表負位移。

• 下限

  以毫秒為單位的下限日期或 1s 2m 3h 4d 5w 6M 7y （一秒、兩分鐘、三小時、四天、五週、六個月、七年）相對於目前伺服器時間，使用「 — 」代表負位移。

根

根述詞群組。 支援群組的所有特徵，並可讓您設定全域查詢引數。

查詢中從未使用過名稱「root」，這是隱含的名稱。

屬性

• 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

將持續查詢產生器查詢的所有述詞納入目前查詢，做為子群組述詞。

這不會執行額外的查詢，但會擴充目前的查詢。

可使用以下程式設計方式儲存查詢 QueryBuilder#storeQuery(). 格式可以是多行字串屬性或 nt:file 以Java™屬性格式包含查詢作為文字檔案的節點。

不支援為已儲存查詢的述詞擷取Facet。

屬性

• savedquery

  已儲存查詢的路徑(字串屬性或 nt:file 節點)。

相似

使用JCR XPath的相似性搜尋 rep:similar().

不支援篩選。 不支援多面向擷取。

屬性

• 相似
  要尋找類似節點之節點的絕對路徑。

• 本機
  下級節點的相對路徑，或 . 目前節點的(選擇性，預設為" .「)。

標籤

透過指定標籤標題路徑，搜尋以一或多個標籤標籤標籤的內容。

支援多面向擷取。 使用每個唯一標籤的目前標籤標題路徑，為其提供貯體。

屬性

• 標籤

  要尋找的標籤標題路徑，例如「資產屬性：方向/橫向」。

• N_value

  使用 1_value， 2_value， …以檢查多個標籤(與 OR 依預設，使用 AND if和=true) （從5.6開始）。

• 屬性

  要檢視的屬性（或屬性的相對路徑） (預設" cq:tags")

標籤ID

透過指定標籤ID來搜尋以一個或多個標籤標籤的內容。

支援多面向擷取。 使用每個唯一標籤的目前標籤ID提供貯體。

屬性

• 標籤ID

  標籤ID，方便您尋找，例如" properties:orientation/landscape「。

• N_value

  使用 1_value， 2_value， …以檢查多個tagid (與 OR 依預設，使用 AND if和=true) （從5.6開始）。

• 屬性

  要檢視的屬性（或屬性的相對路徑） (預設" cq:tags「)。

tagsearch

透過指定關鍵字，搜尋標籤有一或多個標籤的內容。 這會先搜尋標題中包含這些關鍵字的標籤，然後將結果限製為僅搜尋具有這些標籤的專案。

不支援多面向擷取。

屬性

• tagsearch

  要在標籤標題中搜尋的關鍵字。

• 屬性

  要檢視的屬性（或屬性的相對路徑） （預設） cq:tags)。

• lang

  僅搜尋特定當地語系化標籤標題(例如： de)。

• 全部

  （布林值）搜尋整個標籤全文，也就是所有標題、說明等(優先於「l」 ang「)。

類型

將結果限製為特定的JCR節點型別，包括主要節點型別或mixin型別。 這也會尋找該節點型別的子型別。 存放庫搜尋索引必須涵蓋節點型別，才能有效執行。

支援多面向擷取。 為結果中的每個唯一型別提供值區。

屬性

• 類型

  要搜尋的節點型別或mixin名稱，例如 cq:Page.