Query Builder Predicate Reference

一般

謂語

boolproperty

在JCR布爾屬性上匹配。 僅接受值" true"和" false"。 對於" false"，如果屬性的值為" false"，或完全不存在，則匹配。 這對於檢查僅在啟用時設定的布爾標誌非常有用。

繼承的" operation"參數沒有意義。

支援Facet擷取。 將為每個true或false值提供儲存區，但僅為現有屬性提供儲存區。

屬性

  • Boolpropertyproperty
    屬性相對路徑，例如
    myFeatureEnabled 或 jcr:content/myFeatureEnabled

  • ​
    值值，用於檢查屬性， "
    true" 或 " false"

contentfragment

將結果限制為內容片段。

不支援篩選。

不支援Facet擷取。

屬性

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

dateComparison

將兩個JCR DATE屬性相互比較。 可以測試它們是等於、不等於、大於或等於。

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

屬性

  • property1

    第一個日期屬性的路徑

  • property2

    路徑至第二個日期屬性

  • 操作

    「 =」代表完全相符，「 !=」代表不等比，「 >」代表屬性1大於屬性2,「 >=」代表屬性1大於或等於屬性2。 預設值為 " =".

daterange

與日期／時間間隔的JCR DATE屬性相符。 這使用ISO8601
格式(YYYY-MM-DDTHH:mm:ss.SSSZ)，並允許部分表示，例如YYYY-MM-DD。 或者，時間戳可以以1970年以來的毫秒數提供，以UTC時區（UNIX時間格式）表示。

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

支援Facet擷取。 將提供「今天」、「本週」、「本月」、「最近3個月」、「今年」、「去年」和「比去年早」的時段。

不支援篩選。

屬性

  • 屬性

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

  • 下界

    lower date bound to check property for, for example 2014-10-01

  • lowerOperation

    " >"（較新）或" >="（at或更新），適用於lowerBound。 預設值為" >"。

  • 上界

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

  • upperOperation

    " <"（舊版）或" <="（舊版）適用於upperBound。 預設值為" <"。

  • 時區

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

排除路徑

從其路徑與規則運算式匹配的結果中排除節點。

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

不支援Facet擷取。

屬性

  • 排除路徑

    規則運算式與結果路徑相符，從結果中排除相符的運算式。

全文

在全文索引中搜尋詞語。

不支援篩選。

不支援Facet擷取。

屬性

  • 全文

    全文搜尋詞

  • relPath

    屬性或子節點中要搜索的相對路徑。 此屬性為可選屬性。

群組

允許建立巢狀條件。 群組可以包含巢狀群組。 查詢建立工具查詢中的所有項目都會隱含在根群組中，根群組中也可以有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的資產中搜尋「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, ...

hasPermission

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

這是僅限篩選的謂語，無法運用搜尋索引。 它不支援Facet擷取。

屬性

  • hasPermission

    當前用戶會話必須ALL對有問題的節點具有的逗號分隔JCR權限；例如jcr:write、jcr:modifyAccessControl

語言

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

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

支援Facet擷取。 將為每個唯一的語言代碼提供時段。

屬性

  • 語言

    ISO語言代碼，例如" de"

mainasset

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

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

支援Facet擷取。 將為主資產和子資產提供2個桶。

屬性

  • mainasset

    布林值，主資產為" true"，子資產為" false"

的成員

查找屬於特定sling資源集合成員的項目。

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

屬性

  • memberOf

    Sling資源集合的路徑

nodename

與JCR節點名稱匹配。

支援Facet擷取。 將為每個唯一節點名稱（檔案名）提供儲存段。

屬性

  • nodename

    允許通配符的節點名模式：* = any or no char, ? = any char, [abc] = only chars, = only chars

notexpired

檢查JCR DATE屬性是否大於或等於目前伺服器時間，以比對項目。 這可用於檢查「 expiresAt」類似日期屬性，並僅限於尚未過期的(notexpired=true)或已過期的(notexpired=false)。

不支援篩選。

支援Facet擷取，其方式與daterange謂詞相同。

屬性

  • notexpired

    布林值、「 true」（未到期日或等於未來日期）、「 false」（過去日期）（必要）

  • 屬性

    要檢查的DATE屬性的相對路徑（必需）

orderby

允許對結果進行排序。 如果需要按多個屬性排序，則需要使用數字前置詞多次添加此謂語，如1_orderby=first、2_oderby=second。

屬性

  • orderby

    由前導@（例如@jcr:lastModified或@jcr:content/jcr:title）指示的JCR屬性名稱，或查詢中的另一個謂語，例如2_property，要對其排序

  • 排序

    排序方向，「 desc」代表遞減，「 asc」代表遞增（預設）

  • 案例

    如果設為" ignore"，則排序不區分大小寫，表示"a"在"B"之前；如果空或缺，則排序區分大小寫，表示"B"在"a"之前

路徑

在指定路徑內搜尋。

不支援Facet擷取。

屬性

  • 路徑

    路徑模式；根據具體情況，整個子樹將匹配（如在xpath中附加//*，但請注意，這不包括基本路徑）(exact=false, default)或僅匹配完全路徑(可包括通配符(*));如果設定了self，則搜索包含基節點的整個子樹

  • 精確

    如果exact為true/on，則精確路徑必須相符，但可包含簡單萬用字元(*)、符合名稱，但不能包含" /";如果為false（預設），則會包含所有子系（選用）

  • 扁平

    僅搜索直接子項（如在xpath中附加" /*"）（僅在' exact'不是true時使用，可選）

  • self

    搜索子樹，但包括作為路徑給定的基節點（無通配符）

屬性

與JCR屬性及其值相符。

支援Facet擷取。 將為結果中的每個唯一屬性值提供時段。

屬性

  • 屬性

    屬性的相對路徑，例如jcr:title

  • 值

    值以檢查屬性；跟隨JCR屬性類型到字串轉換

  • N值

    使用1_value、2_value、…若要檢查多個值（依預設與OR結合，若與=true則與AND結合）（自5.3起）

  • 與

    設為true時，結合多個值(N_value)與AND（自5.3起）

  • 操作

    「 equals」代表完全相符（預設值）,「 unequals」代表不等比較，「 like」代表使用jcr:like xpath函式（選用）,「 not」代表不相符(例如 xpath中的" not(@prop)"，值param將被忽略)或" exists" for existh check(value can be true - property must exist, default - or false - same as " not")

  • 深度

    屬性／相對路徑可存在的通配符級別數（例如，property=size depth=2將檢查節點／大小、node/&ast;/size和node/&ast;/&ast;/size）

rangeproperty

與JCR屬性對應的時間間隔。 這適用於具有線性類型的屬性，例如LONG、DOUBLE和DECIMAL。 如需DATE，請參閱已最佳化日期格式輸入的變更述詞。

您可以定義下界和上界，或僅定義其中一個。 操作(如 也可以針對下界限和上界限分別指定「小於」或「小於或等於」)。

不支援Facet擷取。

屬性

  • 屬性

    相對路徑至屬性

  • 下界

    下界檢查屬性

  • lowerOperation

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

  • 上界

    上界檢查屬性

  • upperOperation

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

  • 小數點

    " true"（如果選中的屬性類型為Decimal）

相對變更範圍

使用相對於目前伺服器時間的時間偏移，比對日期／時間間隔的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天。

不支援篩選。

支援Facet擷取，其方式與daterange謂詞相同。

屬性

  • 上界

    相對於目前伺服器時間的上限日期界限(毫秒，或1s 2m 3h 4d 5w 6M 7y（一秒、二分鐘、三小時、四天、五週、六個月、七年）)，對於負偏移使用"-"

  • 下界

    相對於目前伺服器時間的較低日期界限（毫秒、兩分鐘、三小時、四天、五週、六個月、七年），對於負偏移使用"-"1s 2m 3h 4d 5w 6M 7y

root

根謂片語。 支援群組的所有功能，並允許設定全域查詢參數。

「root」名稱從未用於查詢，它是隱式的。

屬性

  • p.offset

    表示結果頁面開始的編號，即要略過的項目數

  • p.limit

    表示頁面大小的數字

  • p.guessTotal

    建議：避免計算全部結果總和，代價高昂；指出總計上限的數字（例如1000，一個數字可讓使用者對粗略大小有足夠意見回應，而結果較小的數字）或" true"，只計算最低所需的p.offset + p.limit

  • p.expert

    如果設定為" 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()以程式設計方式保存。 格式可以是多行String屬性或nt:file節點，該節點將查詢作為Java屬性格式的文本檔案。

不支援儲存查詢的謂語的Facet擷取。

屬性

  • savedquery

    已保存查詢的路徑（String屬性或nt:file節點）

類似

使用JCR XPath的rep:similar()進行相似性搜索。

不支援篩選。 不支援Facet擷取。

屬性

  • 要
    查找相似節點的節點的相似絕對路徑

  • 到
    子節點或
    . 對於當前節點(可選，預設為" .")

標籤

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

支援Facet擷取。 將使用每個唯一標籤的目前標籤標題路徑，為每個標籤提供區段。

屬性

  • 標籤

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

  • N值

    使用1_value、2_value、…若要檢查多個標籤（依預設與OR結合，若與=true則與AND結合）（自5.6起）

  • 屬性

    屬性（或屬性的相對路徑）以查看（預設值" cq:tags"）

tagid

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

支援Facet擷取。 將使用每個唯一標籤的目前標籤ID來提供區段。

屬性

  • tagid

    要尋找的標籤ID，例如" properties:orientation/landscape"

  • N值

    使用1_value、2_value、…若要檢查多個標語（依預設與OR結合，並搭配ANDif和=true）（自5.6起）

  • 屬性

    屬性（或屬性的相對路徑）以查看（預設值" cq:tags"）

tagsearch

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

不支援Facet擷取。

屬性

  • tagsearch

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

  • 屬性

    屬性（或屬性的相對路徑）以查看（預設值" cq:tags"）

  • lang

    僅在特定本地化標籤標題中搜尋(例如" de"

  • 全部

    (bool)搜尋整個標籤全文，即所有標題、說明等。 （優先於"l ang"）

類型

將結果限制為特定的JCR節點類型，包括主節點類型或混合類型。 這也會找出該節點類型的子類型。 請注意，儲存庫搜索索引需要涵蓋節點類型，以便高效執行。

支援Facet擷取。 將為結果中的每個唯一類型提供時段。

屬性

  • 類型

    要搜索的節點類型或混合名稱，例如cq:Page

本頁內容

Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now
Adobe Maker Awards Banner

Time to shine!

Apply now for the 2021 Adobe Experience Maker Awards.

Apply now