Query Builder の述語リファレンス

一般

述語

boolproperty

JCR BOOLEAN プロパティに一致します。値のみを受け入れます。 true"および" false". 「false」では、プロパティの値が「false」の場合または存在しない場合に一致します。有効になっている場合のみ設定されるブール型のフラグをチェックする際に便利です。

継承される「operation」パラメーターには意味はありません。

ファセットの抽出に対応しています。true または false の値ごとにバケットを提供しますが、既存のプロパティに限ります。

プロパティ

  • boolproperty
    プロパティへの相対パス(例: )
    myFeatureEnabledjcr:content/myFeatureEnabled のどちらかにする必要があります。


  • プロパティをチェックする値 (")
    true" または " false"

contentfragment

結果をコンテンツフラグメントに限定します。

フィルターには対応していません。

ファセットの抽出には対応していません。

プロパティ

  • contentfragment 任意の値と併用してコンテンツフラグメントをチェックできます。

dateComparison

2 つの JCR DATE プロパティを比較します。等しい、等しくない、より大きい、以上かどうかをテストできます。

これはフィルターのみの述語で、検索インデックスは利用できません。

プロパティ

  • property1

    1 つ目の日付プロパティのパス

  • property2

    2 つ目の日付プロパティのパス

  • operation

    " ="完全一致の場合は" !="非等価の比較のために" >"プロパティ 1 がプロパティ 2 より大きい場合、" >=''プロパティ 1 がプロパティ 2 以上の場合は''を返します。 デフォルト値は" =".

daterange

JCR DATE プロパティと日時の間隔を照合します。ISO8601 を使用します。
日付と時刻の形式 ( YYYY-MM-DDTHH:mm:ss.SSSZ) や、などの部分表現も許可します。 YYYY-MM-DD. また、ミリ秒数のタイムスタンプ(UTC タイムゾーン、UNIX 時刻形式、1970 年以降)を指定することもできます。

2 つのタイムスタンプの間や、特定の日付より前または後のものを検索できるほか、両値を含めるか含めないかを選択することもできます。

ファセットの抽出に対応しています。「今日」、「今週」、「今月」、「過去 3 ヶ月」、「今年」、「前年」、「前年より前」のバケットを提供します。

フィルターには対応していません。

プロパティ

  • property

    への相対パス DATE プロパティ。例: jcr:lastModified

  • lowerBound

    プロパティでチェックする日付の下限(2014-10-01 など)。

  • lowerOperation

    " >" (新しい)または" >=」(以降) lowerBound. デフォルトは、 >".

  • upperBound

    例えば、プロパティをチェックする上限 2014-10-01T12:15:00

  • upperOperation

    " <" (古い)または" <=」(以前) upperBound. デフォルトは、 <".

  • timeZone

    ISO-8601 の日付文字列で指定されていない場合に使用するタイムゾーンの ID。デフォルトは、システムのデフォルトのタイムゾーンです。

excludepaths

パスが正規表現に一致するノードを結果から除外します。

これはフィルターのみの述語で、検索インデックスは利用できません。

ファセットの抽出には対応していません。

プロパティ

  • excludepaths

    結果のパスと照合される正規表現。一致したパスは結果から除外されます。

fulltext

フルテキストのインデックスの語句を検索します。

フィルターには対応していません。

ファセットの抽出には対応していません。

プロパティ

  • fulltext

    全文検索語

  • relPath

    プロパティまたはサブノードの検索の相対パス。このプロパティはオプションです。

グループ

ネストされた条件を作成できます。グループにはネストされたグループを含めることができます。querybuilder クエリのすべての要素は、暗黙的にルートグループに含まれます。ルートグループでは、p.or および p.not パラメーターを指定できます。

2 つのプロパティのいずれかを値と照合する例は次のとおりです。

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 OR 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.or

    を"に設定した場合 true」(グループ内の 1 つの述語のみが一致する必要があります) デフォルトは「false」です。この場合は、すべてが一致する必要があります。

  • p.not

    を"に設定した場合 true"、グループを否定します ( デフォルトは" false")

  • <predicate>

    ネストされた述語を追加します

  • N_<predicate>

    は、ネストされた複数の述語を同時に追加します。例: 1_property, 2_property, ...

hasPermission

現在のセッションが指定した JCR 権限.

これはフィルターのみの述語で、検索インデックスは利用できません。ファセットの抽出には対応していません。

プロパティ

  • hasPermission

    現在のユーザーセッションが対象のノードに対してすべて持つ必要がある、コンマ区切りの JCR 権限。例: jcr:write, jcr:modifyAccessControl

言語

特定の言語の CQ ページを検索します。ページの言語プロパティと、ページパス(一般的に最上位レベルのサイト構造に言語やロケールが含まれています)の両方を検索します。

これはフィルターのみの述語で、検索インデックスは利用できません。

ファセットの抽出に対応しています。固有の言語コードごとにバケットを提供します。

プロパティ

  • language

    ISO 言語コード(例: )。 de"

mainasset

ノードがサブアセットではなく、DAM メインアセットであるかどうかをチェックします。基本的には、DAM メインアセットは「subassets」ノード外のすべてのノードです。dam:Asset ノードタイプはチェックされません。この述語を使用するには、「 mainasset=true"または" mainasset=false「、これ以上のプロパティはありません。

これはフィルターのみの述語で、検索インデックスは利用できません。

ファセットの抽出に対応しています。メインとサブアセットの 2 つのバケットを提供します。

プロパティ

  • mainasset

    boolean, " true」(メインアセットの場合) false」(サブアセット)

memberOf

特定の sling リソースコレクションのメンバーである項目を検索します。

これはフィルターのみの述語で、検索インデックスは利用できません。ファセットの抽出には対応していません。

プロパティ

  • memberOf

    Sling リソースコレクションのパス

nodename

JCR ノード名と一致します。

ファセットの抽出に対応しています。固有のノード名(ファイル名)ごとにバケットを提供します。

プロパティ

  • nodename

    ワイルドカードを使用できるノード名パターン:* は 0 個以上の任意の文字、? は任意の文字、[abc] は角括弧内の文字のみ

notextired

JCR DATE プロパティが現在のサーバー時間より後か同じかをチェックすることで項目を照合します。これを使用すると、日付プロパティなどの「expiresAt」をチェックし、まだ有効期限が切れていないプロパティ(notexpired=true)または既に有効期限が切れているプロパティ(notexpired=false)に制限できます。

フィルターには対応していません。

daterange 述語と同じように、ファセットの抽出に対応しています。

プロパティ

  • notexpired

    ブール値。有効期限が切れていない(日付が現在以降である)場合は「true」、有効期限が切れている(日付が過去である)場合は「false」です(必須)。

  • プロパティ

    への相対パス DATE 確認するプロパティ(必須)

orderby

結果の並べ替えを有効にします。複数のプロパティ別に並べ替える必要がある場合は、1_orderby=first2_oderby=second などの数字のプレフィックスを使用して、この述語を複数回追加する必要があります。

プロパティ

  • orderby

    並べ替えの基準となる、先頭が @ の JCR プロパティ名(例:@jcr:lastModified@jcr:content/jcr:title)またはクエリ内の別の述語(例:2_property

  • 並べ替え

    並べ替え方向: desc「 」(降順)または「 asc''昇順(デフォルト)

  • ケース

    ignore」に設定すると、並べ替えで大文字と小文字が区別されなくなります(「a」が「B」の前になります)。空白または未指定の場合は、並べ替えで大文字と小文字が区別されます(「B」が「a」の前になります)。

パス

特定のパス内を検索します。

ファセットの抽出には対応していません。

プロパティ

  • path

    パスのパターン;完全一致に応じて、サブツリー全体が一致する ( //* xpath では含まれませんが、(exact=false、default)、または完全に一致するパスは含まれません。これにはワイルドカード ( *);self が設定されている場合、ベースノードを含むサブツリー全体が検索されます

  • 正確

    if exact が true/on の場合、パスは完全に一致する必要がありますが、単純なワイルドカード ( *)、名前に一致するが、"に一致しない /";false(デフォルト)の場合、すべての子孫が含まれます(オプション)

  • フラット

    直接の子のみを検索します (「 /*」 (xpath 内)(' exact'は true ではありません(オプション)

  • self

    サブツリーを検索しますが、パスとして指定されたベースノードが含まれます(ワイルドカードは不可)。

プロパティ

JCR プロパティとその値に一致します。

ファセットの抽出に対応しています。結果の固有のプロパティ値ごとにバケットを提供します。

プロパティ

  • プロパティ

    プロパティへの相対パス(例: ) jcr:title

  • value

    プロパティでチェックする値。JCR プロパティタイプから文字列への変換に従います

  • N_value

    use 1_value, 2_value、…複数の値をチェックします ( OR デフォルトでは、 AND and=true の場合 )(5.3 以降)

  • および

    複数の値を組み合わせる場合は true に設定 ( N_value) と AND(5.3 以降)

  • 操作

    " equals"完全一致の場合(デフォルト)、" unequals"非等価の比較のために" like」を jcr:like xpath 関数(オプション), " not」は一致しません ( 例: " not(@prop)" xpath では、値パラメーターは無視されます ) または" exists"存在を確認する場合 ( 値は true、プロパティは存在する必要があります。デフォルト (false) は" not")

  • 深さ

    プロパティや相対パスが存在できるワイルドカードレベルの数 ( 例: property=size depth=2 ノード/サイズ、ノード/*/size と node/*/*/*/size をチェックします。

rangeproperty

JCR プロパティと間隔を照合します。LONGDOUBLEDECIMAL などの線形タイプのプロパティに適用されます。DATE に関しては、最適化された日付形式の入力情報を含む daterange 述語を参照してください。

下限と上限、またはそのいずれかを定義できます。演算(「より少ない」や「以下」など)も、下限と上限に別々に指定することができます。

ファセットの抽出には対応していません。

プロパティ

  • プロパティ

    プロパティの相対パス

  • lowerBound

    プロパティをチェックする下限

  • lowerOperation

    " >" (デフォルト)または" >="、適用対象 lowerValue

  • upperBound

    プロパティをチェックする上限

  • upperOperation

    " <" (デフォルト)または" <="、適用対象 lowerValue

  • decimal

    " true"チェックされたプロパティのタイプが小数の場合

relativedaterange

JCR DATE プロパティと日時の間隔を照合します(現在のサーバー時間に対する時間オフセットを使用します)。次を指定できます。 lowerBound および upperBound ミリ秒値または bugzilla 構文を使用 1s 2m 3h 4d 5w 6M 7y (一秒、二分、三時間、四日、五週間、六ヶ月、七年) プレフィックス「 」 -」は、現在の時刻より前の負のオフセットを示します。 lowerBound または upperBound のいずれかのみを指定する場合は、他方がデフォルトで 0(現在の時間)になります。

次に例を示します。

  • upperBound=1h ( と lowerBound) が次の 1 時間以内に選択する
  • lowerBound=-1d ( と upperBound) が過去 24 時間以内に選択した項目を含む
  • lowerBound=-6M および upperBound=-3M 生後 6 か月から 3 か月までの任意の選択が可能です
  • lowerBound=-1500 および upperBound=5500 過去 1500 ミリ秒から将来 5500 ミリ秒の間のすべてを選択します。
  • lowerBound=1d および upperBound=2d 明後日に何かを選ぶだろう

うるう年は考慮されず、すべての月が 30 日になる点にご注意ください。

フィルターには対応していません。

daterange 述語と同じように、ファセットの抽出に対応しています。

プロパティ

  • upperBound

    ミリ秒または 1s 2m 3h 4d 5w 6M 7y (1 秒、2 分、3 時間、4 日、5 週間、6 か月、7 年)現在のサーバー時間を基準にした相対的な時間、負のオフセットには「 — 」を使用します。

  • lowerBound

    ミリ秒単位での下限の日付 1s 2m 3h 4d 5w 6M 7y (1 秒、2 分、3 時間、4 日、5 週間、6 か月、7 年)現在のサーバー時間を基準にした相対的な時間、負のオフセットには「 — 」を使用します。

root

ルート述語グループ。グループのすべての機能に対応し、グローバルクエリパラメーターを設定できます。

「root」という名前は暗黙的で、クエリでは使用されません。

プロパティ

  • p.offset

    結果ページの開始を表す数値(スキップする項目数)。

  • p.limit

    ページのサイズを表す数値

  • p.guessTotal

    推奨:コストのかかる結果の全体を計算するのを避ける。最大数を示す数(例:1000、大まかなサイズと小さい結果を得るための正確な数でユーザーに十分なフィードバックを提供する数)または「 true」をクリックして、必要最小限の値までカウントします。 p.offset + p.limit

  • p.excerpt

    を"に設定した場合 true"、結果に全文の抜粋を含める

  • p.hits

    (JSON サーブレット専用)ヒットを JSON として記述する方法を、次の標準的なものの中から選択します(ResultHitWriter サービスを使用して拡張可能)。

    • シンプル:

      次のような最小項目 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)

    • 選択的:

      で指定されたプロパティのみ p.properties:スペースで区切られた(URL で「+」を使用)相対パスのリスト。相対パスの深さが 1 を超える場合は、子オブジェクトとして表されます。特別な jcr:path プロパティには、ヒットのパスが含まれます

savedquery

永続的な querybuilder クエリのすべての述語を、サブグループの述語として現在のクエリに含めます。

これによって追加のクエリが実行されるわけではなく、現在のクエリが拡張されます。

クエリは QueryBuilder#storeQuery() を使用してプログラムで永続化できます。形式は、複数行の String プロパティか、Java プロパティ形式のテキストファイルとしてクエリを含む nt:file ノードにできます。

保存済みクエリの述語のファセット抽出には対応していません。

プロパティ

  • savedquery

    保存されたクエリのパス (String プロパティまたは nt:file ノード )

類似

JCR XPath を使用した類似性検索 rep:similar().

フィルターには対応していません。ファセットの抽出には対応していません。

プロパティ

  • similar 類似ノードを検索するノードの絶対パス。

  • local 下位ノードの相対パス、または現在のノードの場合は
    . 現在のノード ( オプション、デフォルトは" .")

タグ

タグタイトルのパスを指定して、タグが付けられているコンテンツを検索します。

ファセットの抽出に対応しています。現在のタグタイトルのパスを使用して固有のタグごとにバケットを提供します。

プロパティ

  • tag

    検索するタグタイトルのパス(「Asset Properties : Orientation / Landscape」など)。

  • N_value

    use 1_value, 2_value、…複数のタグ ( OR デフォルトでは、 AND and=true の場合 )(5.6 以降)

  • プロパティ

    参照するプロパティ(またはプロパティの相対パス)( デフォルトの「 」 cq:tags")

tagid

タグ ID を指定して、タグが付けられているコンテンツを検索します。

ファセットの抽出に対応しています。現在のタグ ID を使用して固有のタグごとにバケットを提供します。

プロパティ

  • tagid

    検索するタグ id(例: )。 properties:orientation/landscape"

  • N_value

    use 1_value, 2_value、…複数のタグ ID ( OR デフォルトでは、 AND and=true の場合 )(5.6 以降)

  • プロパティ

    参照するプロパティ(またはプロパティの相対パス)( デフォルトの「 」 cq:tags")

tagsearch

キーワードを指定して、タグが付けられているコンテンツを検索します。最初にタイトル内に対象のキーワードを含むタグを検索してから、それらのタグが付いている項目のみに結果を制限します。

ファセットの抽出には対応していません。

プロパティ

  • tagsearch

    タグタイトル内で検索するキーワード

  • プロパティ

    参照するプロパティ(またはプロパティの相対パス)( デフォルトの「 」 cq:tags")

  • lang

    特定のローカライズされたタグタイトルのみを検索する場合 ( 例:" de")

  • all

    (ブール値)タグのフルテキスト全体(すべてのタイトル、説明など)を検索します(「l」よりも優先 ang")

type

特定の JCR ノードのタイプ(プライマリノードタイプまたは Mixin タイプ)に結果を制限します。そのノードタイプのサブタイプも検索します。リポジトリーの検索インデックスでは、効率的に実行できるノードタイプに対応する必要があります。

ファセットの抽出に対応しています。結果の固有のタイプごとにバケットを提供します。

プロパティ

  • type

    検索するノードタイプまたは mixin 名。例: cq:Page

このページ