文件AEM 6.5使用手冊

查詢產生器述詞參考 query-builder-predicate-reference

Last update: Wed Mar 06 2024 00:00:00 GMT+0000 (Coordinated Universal Time)
CAUTION
此頁面上的資訊並非詳盡無遺。
如需完整資訊，請參閱 可用述詞 在Query Builder Debugger主控台上；例如：
例如，請參閱：

一般 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.

recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2