查詢產生器述詞參考

一般

根

這是根謂語組。 它支援組的所有功能，並允許設定全局查詢參數。

查詢中從未使用「root」名稱，此名稱為隱式。

屬性

• p.offset — 表示結果頁面開始的數字，即要略過的項目數
• p.limit — 表示頁面大小的數字
• p.guessTotal — 建議：避免計算全部結果總計，而這可能會造成很大成本；指出總計上限的數字（例如1000，該數字讓使用者對粗細大小有足夠的意見，而且精確數字較小）或 true 僅計算最低必要 p.offset 值+ p.limit
• p.excerpt — 如果設為， true請在結果中加入全文摘要
• p.hits — （僅限JSON servlet）選取將點擊寫入為JSON的方式，並搭配這些標準點擊（可透過ResultHitWriter服務擴充）:
  • simple — 最小項 path目， title、 lastmodified、 excerpt （如果已設定）
  • full - sling JSON轉譯節點，並 jcr:path 指出點擊的路徑：預設情況下，僅列出節點的直接屬性，包含一個更深的樹，其 p.nodedepth=N中0表示整個無限子樹；新增 p.acls=true 以包含目前工作階段對指定結果項目的JCR權限(對應： create = add_node, modify = set_property, delete = remove)
  • selective — 僅限中指定的 p.properties屬性，這是相對路徑的以空格分隔( + 在URL中使用)的清單；如果相對路徑具有深度， >1 則這些將表示為子對象；特殊 jcr:path 屬性包含點擊的路徑

群組

此述詞允許建立巢狀條件。 群組可包含巢狀群組。 查詢產生器查詢中的所有項目都隱含在根群組中，根群組也可包含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/wknd/ch/de
group.1_group.type=cq:Page
group.2_group.path=/content/dam/wknd
group.2_group.type=dam:Asset

這會在/content/wknd/ch/de的頁面或/content/dam/wknd的資產中搜尋​Management​一詞。

這在概念上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, ...

orderby

此謂語允許排序結果。 如果需要依多個屬性排序，則需要使用數字首碼（例如1_orderby=first、2_oderby=second）多次新增此述詞。

屬性

• orderby — 以前導@（例如或）指示的JCR屬性名 @jcr:lastModified 稱， @jcr:content/jcr:title或查詢中的其他述詞(例如 2_property，要對其排序)
• sort — 排序方向， desc 遞減或 asc 遞增（預設）
• case — 如果設為， ignore 會讓排序不區分大小寫，表示 a 會在前 B;如果空白或遺漏，則排序會區分大小寫，表示 B 會優先於 a

謂語

布爾屬性

此謂語與JCR布林屬性相符。 僅接受值true和false。 若是false，如果屬性具有false值，或完全不存在，則符合。 這對於檢查僅在啟用時設定的布林值標幟非常有用。

繼承的operation參數沒有意義。

此述詞支援Facet擷取，並提供每個true或false值的貯體，但僅提供現有屬性。

屬性

• boolproperty — 屬性的相對路徑，例 myFeatureEnabled 如或 jcr:content/myFeatureEnabled
• value — 要檢查屬性的值， true 或 false

contentfragment

此述詞將結果限制為內容片段。

• 不支援篩選。
• 不支援小面擷取。

屬性

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

dateComparison

此謂語會比較兩個JCR日期屬性。 可以測試它們是否相等、不等、是否大於或等於。

這是僅限篩選的謂語，無法使用搜尋索引。

屬性

• property1 — 第一個日期屬性的路徑
• property2 — 第二個日期屬性的路徑
• operation
  • = 完全相符（預設）
  • != 不等式比較
  • > property1 大於 property2
  • >= property1 大於或等於 property2

達特朗日

此述詞會比對日期/時間間隔的JCR日期屬性。 這使用ISO8601
日期和時間的格式(YYYY-MM-DDTHH:mm:ss.SSSZ)，並允許部分表示，例如YYYY-MM-DD。 或者，時間戳記可以提供為POSIX時間。

您可以尋找兩個時間戳記之間的任何項目，任何較新或較指定日期舊的項目，也可以在包含和開啟的間隔之間進行選擇。

它支援小面擷取，並提供貯體today、this week、this month、last 3 months、this year、last year及earlier than last year。

不支援篩選。

屬性

• property — 屬性的相 DATE 對路徑，例如 jcr:lastModified
• lowerBound — 例如，下限界限以檢查屬性 2014-10-01
• lowerOperation - > （更新） >= 或（更新）適用於 lowerBound。預設值為>
• upperBound — 例如，上界可檢查屬性 2014-10-01T12:15:00
• upperOperation - < （舊） <= 或（at或舊）適用於 upperBound。預設值為<
• timeZone — 未指定為ISO-8601日期字串時使用的時區ID。預設為系統的預設時區。

排除路徑

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

這是僅限篩選的謂語，無法使用搜尋索引。

不支援小面擷取。

屬性

• excludepaths — 與結果路徑匹配的規則表達式，將匹配的表達式從結果中排除。

全文

此謂語會搜尋全文索引中的詞語。

不支援篩選。

不支援小面擷取。

屬性

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

hasPermission

此謂語將結果限制為當前會話具有指定JCR權限的項目。

這是僅限篩選的謂語，無法使用搜尋索引。 不支援小面擷取。

屬性

• hasPermission — 目前使用者工作階段必須具有的逗號分隔JCR權限，「全部」才能擁有相關節點；例如 jcr:write jcr:modifyAccessControl

語言

此謂語會尋找特定語言的AEM頁面。 這會同時查看頁面語言屬性和頁面路徑，這些路徑通常包括頂層網站結構中的語言或地區設定。

這是僅限篩選的謂語，無法使用搜尋索引。

它支援Facet擷取，並為每個唯一語言程式碼提供貯體。

屬性

• language — 例如ISO語言代碼 de

mainasset

此述詞會檢查節點是否為DAM主要資產，而非子資產。 這基本上是每個節點，而不是子資產節點內。 請注意，這不會檢查dam:Asset節點類型。 要使用此謂語，只需設定mainasset=true或mainasset=false即可。 沒有其他屬性。

這是僅限篩選的謂語，無法使用搜尋索引。

它支援Facet擷取，並提供主要和子資產的兩個貯體。

屬性

• mainasset — 布林值， true 主要資產，子 false 資產

memberOf

此謂語查找屬於特定sling資源集合的項。

這是僅限篩選的謂語，無法使用搜尋索引。

不支援小面擷取。

屬性

• memberOf - Sling資源收集路徑

nodename

此謂語與JCR節點名稱相符。

它支援Facet擷取，並提供每個唯一節點名稱（檔案名稱）的貯體。

屬性

• nodename — 允許通配符的節點名稱模式： * =任何或無字元， ? =任何字元， [abc] =僅限方括弧中的字元

notexpired

此述詞會檢查JCR日期屬性是否大於或等於目前伺服器時間來比對項目。 這可用來檢查expiresAt值，並將結果限制為尚未過期(notexpired=true)或已過期(notexpired=false)的值。

不支援篩選。

其支援與daterange述詞相同的面向擷取。

屬性

• notexpired — 布林值， true 對於尚未到期（未來日期或等於）, false 對於過期（過去日期）（必要）
• property — 要檢查的屬 DATE 性的相對路徑（必要）

路徑

此述詞會在指定路徑內搜尋。

不支援小面擷取。

屬性

• path — 這會定義路徑模式。
  • 根據exact屬性，整個子樹會相符（例如在xpath中附加//*，但請注意，這不包括基本路徑），或僅有完全相符的路徑，其中可能包含萬用字元(*)。
    • 預設為 true
  • 如果設定了self屬性，則會搜索包含基節點的整個子樹。
• exact — 如果 exact 為 true，則確切路徑必須相符，但可包含簡單的萬用字元(*)，該萬用字元符合名稱，但不 /符；如果是(預 false 設值)，則包括所有子體（可選）
• flat — 僅搜尋直接子項(例如在 /* xpath中附加)(僅在 exact 不是true時使用，可選)
• self — 搜索子樹，但包含指定為路徑的基節點（無通配符）

屬性

此謂語與JCR屬性及其值相符。

它支援Facet擷取，並為結果中的每個唯一屬性值提供貯體。

屬性

• property — 屬性的相對路徑，例如 jcr:title
• value — 要檢查屬性的值；會遵循JCR屬性類型來轉換字串
• N_value — 使 1_value用、 2_value、 …檢查多個值(預設 OR 會結合， AND 若 and=true)
• and — 若要結 true 合多個值(N_value)，請設為 AND
• operation
  • equals 完全相符（預設）
  • unequals 不等式比較
  • like 用於使用 jcr:like xpath函式（可選）
  • not 若不符合(例如， not(@prop) 在xpath中，值參數會被忽略)
  • exists 存在檢查
    • true 屬性必須存在
    • false 與相同， not 且為預設值
• depth — 屬性/相對路徑可存在的萬用字元層數(例 property=size depth=2 如將 node/size檢查 node/*/size 和 node/*/*/size)

範圍屬性

此述詞與間隔的JCR屬性相符。 這會套用至具有線性類型的屬性，例如LONG、DOUBLE和DECIMAL。 對於DATE，請參閱daterange謂詞，該謂詞已優化日期格式輸入。

您可以定義下界限、上界限或兩者。 也可以為上下界限分別指定操作（例如小於或等於）。

不支援小面擷取。

屬性

• property — 屬性的相對路徑
• lowerBound — 下限以檢查屬性
• lowerOperation - > （預設值）或 >=，套用至 lowerValue
• upperBound — 上限，檢查屬性
• upperOperation - < （預設值）或 <=，套用至 lowerValue
• 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 過去3到6個月內選擇任何
• lowerBound=-1500 和 upperBound=5500 會選取1500毫秒到5500毫秒之間的未來值
• lowerBound=1d 然後 upperBound=2d 在後天選擇任何東西

請注意，不需要考慮閏年，且所有月份均為30天。

不支援篩選。

其支援與daterange述詞相同的面向擷取。

屬性

• upperBound — 相對於當前伺服器時 1s 2m 3h 4d 5w 6M 7y 間，以毫秒或（一秒、二分鐘、三小時、四天、五週、六個月、七年）為上限，使用負偏移 - ,
• lowerBound — 相對於當前伺服器時 1s 2m 3h 4d 5w 6M 7y 間，以毫秒或（一秒、二分鐘、三小時、四天、五週、六個月、七年）為下限，用於負偏移 - ,

savedquery

此述詞包含持續存在的查詢產生器查詢的所有述詞，並以子群組述詞的形式放入目前的查詢中。

請注意，這不會執行額外的查詢，而會延伸目前的查詢。

可使用QueryBuilder#storeQuery()以寫程式方式保存查詢。 格式可以是多行String屬性，也可以是nt:file節點，該節點以Java屬性格式的文本檔案形式包含查詢。

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

屬性

• savedquery — 儲存查詢的路徑(String 屬性或 nt:file 節點)

相似

此謂語是使用JCR XPath的rep:similar()的相似性搜尋。

不支援篩選，也不支援小面擷取。

屬性

• similar — 要查找類似節點的節點的絕對路徑
• local — 子代節點的相對路徑或 . 當前節點(可選，預設為 .)

標籤

此述詞會指定標籤標題路徑，以搜尋標籤有一或多個標籤的內容。

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

屬性

• tag — 要尋找的標題路徑，例如 properties:orientation/landscape
• N_value — 使 1_value用、 2_value、 …檢查多個標籤(預設 OR 會結合， AND 若 and=true)
• property — 要查看的屬性（或相對屬性路徑）(預設 cq:tags)

tagid

此述詞會指定標籤ID，以搜尋標籤有一或多個標籤的內容。

它支援Facet擷取，並使用每個唯一標籤的目前標籤ID，為每個標籤提供貯體。

屬性

• tagid — 要尋找的標籤ID，例如 properties:orientation/landscape
• N_value — 使 1_value用、 2_value、 …來檢查多個標籤ID(依預設 OR 結合，搭配 AND if and=true)
• property — 要查看的屬性（或相對屬性路徑）(預設 cq:tags)

tagsearch

此述詞會指定關鍵字，以搜尋標籤有一或多個標籤的內容。 這會先搜尋標題中包含這些關鍵字的標籤，然後將結果限制為僅限標籤這些關鍵字的項目。

不支援小面擷取。

屬性

• tagsearch — 要在標籤標題中搜索的關鍵字
• property — 要考慮的屬性（或相對屬性路徑）(預設 cq:tags)
• lang — 僅搜尋特定本地化標籤標題(例如 de)
• all — 用於搜索整個標籤全文的布爾值，即所有標題、說明等。（優先於lang）

類型

此謂語將結果限制為特定的JCR節點類型，主節點類型或混合類型皆可。 這也會找到該節點類型的子類型。 請注意，儲存庫搜索索引需要涵蓋節點類型，才能有效執行。

它支援Facet擷取，並為結果中的每個唯一類型提供貯體。

屬性

• type — 要搜尋的節點類型或混合名稱，例如 cq:Page