ドキュメントAEM 6.5 LTSユーザーガイド

Query Builder の述語リファレンス query-builder-predicate-reference

最終更新日： 2026年6月12日
  • 適用対象：
  • Experience Manager 6.5 LTS

作成対象：

  • Developer
CAUTION
このページの情報は網羅的ではありません。
詳しくは、Query Builder Debugger コンソールで、使用可能な述語​のリストを参照してください。例：
例：

一般 general

述語 predicates

boolproperty boolproperty

JCR ブーリアンプロパティに一致します。 値「true」と「false」のみを受け入れます。 「false」に設定すると、プロパティの値「false」が指定されているか、まったく存在しない場合に一致します。 有効な場合にのみ設定されるブール値フラグをチェックするのに便利です。

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

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

プロパティ properties

  • boolproperty
    プロパティへの相対パス （例：myFeatureEnabledまたはjcr:content/myFeatureEnabled）。

  • 値
    「true」または「false」のプロパティをチェックする値。

contentfragment contentfragment

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

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

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

プロパティ properties-1

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

dateComparison datecomparison

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

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

プロパティ properties-2

  • property1

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

  • property2

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

  • operation

    完全一致の場合は「equals」、不等号比較の場合は「!=」、プロパティ 1 がプロパティ 2 より大きい場合は「greater」、プロパティ 1 がプロパティ 2 以上の場合は「>=」となります。 デフォルト値は「equals」です。

daterange daterange

JCR DATE プロパティを日付と時間間隔に一致させます。 ISO8601を使用
日付と時刻（YYYY-MM-DDTHH:mm:ss.SSSZ）の形式を指定します。また、YYYY-MM-DDのような部分的な表現も使用できます。 また、ミリ秒数のタイムスタンプ（UTC タイムゾーン、UNIX® 時刻形式、1970 年以降）を指定することもできます。

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

ファセット抽出をサポートしています。 「today」、「this week」、「this month」、「last 3 months」、「this year」、「last year」、「earlier than last year」のバケットを提供します。

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

プロパティ properties-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

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

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

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

プロパティ properties-4

  • excludepaths

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

fulltext fulltext

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

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

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

プロパティ properties-5

  • fulltext

    フルテキストの検索語句

  • relPath

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

group group

ネストされた条件を作成できます。 グループにはネストされたグループを含めることができます。 Query Builder クエリーのすべての要素は、暗黙的にルートグループに含まれます。ルートグループでは、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または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.or

    「true」に設定した場合、グループ内の1つの述語のみが一致する必要があります。 既定値は「false」です。すべて一致する必要があります

  • p.not

    「true」に設定すると、グループは無効になります（デフォルトは「false」）。

  • <predicate>

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

  • N_<predicate>

    1_property, 2_property, ... など、複数のネストされた述語をまとめて追加します。

hasPermission haspermission

指定された JCR 権限が現在のセッションに含まれる項目に、結果を制限します。

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

プロパティ properties-7

  • hasPermission

    該当のノードに対して現在のユーザーセッションがすべて持っている必要がある JCR 権限のコンマ区切りリスト。 jcr:write、jcr:modifyAccessControl などです。

language language

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

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

ファセット抽出をサポートしています。 一意の言語コードごとにバケットを提供します。

プロパティ properties-8

  • language

    ISO言語コード （例：「de」）

mainasset mainasset

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

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

ファセット抽出をサポートし、メインアセットとサブアセットに2つのバケットを提供します。

プロパティ properties-9

  • mainasset

    ブール値。メインアセットの場合は「true」、サブアセットの場合は「false」です。

memberOf memberof

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

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

プロパティ properties-10

  • memberOf

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

nodename nodename

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

ファセット抽出をサポートしています。 一意のノード名（ファイル名）ごとにグループを提供します。

プロパティ properties-11

  • nodename

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

notexpired notexpired

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

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

これは、データレンジの述語と同じ方法でファセット抽出をサポートしています。

プロパティ properties-12

  • notexpired

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

  • property

    チェックする DATE プロパティへの相対パス（必須）。

orderby orderby

結果を並べ替えることができます。 複数のプロパティ別に並べ替える必要がある場合は、1_orderby=first、2_oderby=second などの数字の接頭辞を使用して、この述語を複数回追加する必要があります。

プロパティ properties-13

  • orderby

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

  • 並べ替え

    並べ替えの方向。降順の場合は「desc」、昇順の場合は「asc」（デフォルト）です。

  • case

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

path path

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

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

プロパティ properties-14

  • path

    パスのパターン。 exact=false （デフォルト）の場合、検索は指定されたパスの下のサブツリー全体と一致します（XPathの//*の追加と同様ですが、ベースパス自体は含まれません）。 exact=trueの場合、検索は*個のワイルドカードを含むことができる正確なパスにのみ一致します。 selfが設定されている場合、検索にはベースノードとそのサブツリー全体が含まれます。

  • exact

    exactがtrue （on）の場合、正確なパスは一致する必要がありますが、一致する名前である単純なワイルドカード（*）を含めることができますが、「/」は含まれません。false （デフォルト）の場合、すべての子孫が含まれます（オプション）。

  • flat

    直接子のみを検索します（xpathに「/*」を追加するなど）（「exact」がtrueでない場合にのみ使用され、オプション）。

  • self

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

property property

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

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

プロパティ properties-15

  • property

    プロパティへの相対パス（jcr:title など）。

  • value

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

  • N_value

    1_value や 2_value などを使用し、複数の値をチェックします（デフォルトでは OR と結合され、and=true の場合は AND と結合されます）（5.3 以降）。

  • and

    複数の値（N_value）を AND で結合する場合は、true に設定します（5.3 以降）。

  • operation

    完全一致にはequals、不等式の比較にはunequalsを使用します。 likeを使用して、オプションのjcr:like XPath関数を適用します。 一致しない場合はnotを使用します（XPathではnot(@prop)など）。この場合、value パラメーターは無視されます。 existsを使用して、プロパティが存在するかどうかを確認します：true （デフォルト）にはプロパティが必要で、falseはnotと同等です。

  • depth

    プロパティと相対パスが存在する可能性がある下の多数のワイルドカードレベル。 例えば、property=size depth=2はノードとサイズ、node/*/size、node/*/*/sizeをチェックします。

rangeproperty rangeproperty

JCR プロパティと間隔を一致します。 LONG、DOUBLE、DECIMALなど、線形型を持つプロパティに適用されます。 DATE に関しては、日付書式入力を最適化した daterange 述語を参照してください。

下限と上限、またはそのうち 1 つのみを定義できます。 演算（「未満」や「以下」など）を下限と上限に個別に指定することもできます。

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

プロパティ properties-16

  • property

    プロパティへの相対パス。

  • lowerBound

    プロパティで確認する下限。

  • lowerOperation

    「>」（デフォルト）または「>=」（lowerValueに適用）

  • upperBound

    プロパティで確認する上限。

  • upperOperation

    「<」（デフォルト）または「<=」（lowerValueに適用）

  • decimal

    チェックされたプロパティのタイプが Decimal の場合は「true」

relativedaterange relativedaterange

現在のサーバー時間に対する時間オフセットを使用して、日付と時間間隔にJCR DATE プロパティを一致させます。 ミリ秒値またはbugzilla構文1s 2m 3h 4d 5w 6M 7yを使用して、lowerBoundとupperBoundを指定できます。 接頭辞として「-」を付けると、オフセットが現在の時間より前のマイナスであることを意味します。 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 日になります。

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

これは、データレンジの述語と同じ方法でファセット抽出をサポートしています。

プロパティ properties-17

  • 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

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

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

プロパティ properties-18

  • p.offset

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

  • p.limit

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

  • p.guessTotal

    完全な結果の合計を計算するコストを避けるために、すべての一致をカウントしないでください。 代わりに、最大カウント数を設定して（例えば、1000）、ユーザーに大まかなサイズと正確な合計を提供し、より小さな結果を得られるようにします。 または、必要な最小値p.offset + p.limitまでしかカウントしないようにtrueに設定します。

  • p.excerpt

    「true」に設定した場合は、結果にフルテキストの抜粋を含めます。

  • p.hits

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

    • simple：

      path、title、lastmodified、excerpt（設定されている場合）などの最小限の項目。

    • full：

      結果は各ノードのSling JSONとしてレンダリングされ、jcr:pathにはヒットパスが表示されます。 デフォルトでは、応答にはノードの直接プロパティのみが含まれます。より深いコンテンツを含めるにはp.nodedepth=Nを使用します。ここで、0はサブツリー全体を返します。 各項目に対する現在のセッションのJCR権限を含めるには、p.acls=trueを設定します（create = add_node, modify = set_property, delete = remove）。

    • selective：

      応答には、相対パスのスペース区切りリストであるp.propertiesにリストされているプロパティのみが含まれます（URLに+を使用）。 相対パスの深さが1より大きい場合、出力は子オブジェクトとしてネストします。 特殊なjcr:path プロパティには、常にヒット パスが含まれます。

savedquery savedquery

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

追加のクエリは実行しませんが、現在のクエリを拡張します。

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

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

プロパティ properties-19

  • savedquery

    保存済みクエリのパス（文字列プロパティまたは nt:file ノード）。

similar similar

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

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

プロパティ properties-20

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

  • ローカル
    現在のノードの子孫ノードまたは.への相対パス（オプション、デフォルトは「.」）。

tag tag

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

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

プロパティ properties-21

  • tag

    「アセットプロパティ：方向/横」などのタグ付けタイトルパスを検索します。

  • N_value

    1_value、2_value、…を使用して、複数のタグを確認します（デフォルトでは OR と組み合わせ、and=true の場合は AND と組み合わせます）（5.6 以降）

  • property

    検索するプロパティ（またはプロパティへの相対パス）（デフォルトは「cq:tags」）

tagid tagid

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

ファセット抽出をサポートしています。 現在のタグ ID を使用して、一意のタグごとにバケットを提供します。

プロパティ properties-22

  • tagid

    タグ IDを指定して、「properties:orientation/landscape」などのタグを検索します。

  • N_value

    1_value、2_value、…を使用して、複数のtagids （デフォルトではORと組み合わせ、ifとtrueはAND）を確認します（5.6以降）。

  • property

    検索するプロパティ（またはプロパティへの相対パス）（デフォルトは「cq:tags」）

tagsearch tagsearch

キーワードを指定して、1 つ以上のタグが付けられているコンテンツを検索します。 最初に、これらのキーワードがタイトルに含まれているタグを検索し、その結果をタグ付きアイテムのみに制限します。

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

プロパティ Properties-1

  • tagsearch

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

  • property

    検索するプロパティ（またはプロパティへの相対パス）（デフォルトは cq:tags）。

  • lang

    特定のローカライズされたタグタイトルのみを検索します（例：de）。

  • all

    （ブーリアン）タグのフルテキスト全体、つまりすべてのタイトルや説明などを検索します。 「l ang」よりも優先されます。

type type

結果を特定のJCR ノードタイプ（プライマリノードタイプまたはmixin タイプの両方）に制限し、そのノードタイプのサブタイプを見つけます。 効率的に実行するには、リポジトリ検索インデックスがノードタイプに対応する必要があります。

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

プロパティ Properties-2

  • type

    検索するノードタイプまたはミックスイン名（例：cq:Page）。

recommendation-more-help
experience-manager-65-lts-help-main-toc