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

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

Last update: Sat Jan 31 2026 00:00:00 GMT+0000 (Coordinated Universal Time)
  • 適用対象：
  • Experience Manager 6.5 LTS
  • トピック：

作成対象：

  • 開発者
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

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

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

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

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

プロパティ 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 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/enManagement/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 メインアセットであるかどうかをチェックします。基本的に、すべてのノードが「サブアセット」ノード内にあるわけではありません。 は、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）に制限するために使用できます。

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

daterange 述語と同じ方法でファセットの抽出をサポートします。

プロパティ 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 の場合（オン）、正確なパスが一致する必要があります。ただし、名前に一致する簡単なワイルドカード（*）を含めることもできます（「/」は不可）。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 XPath 関数を適用するには、jcr:like を使用します。 一致しない場合は 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 構文 lowerBound を使用して、upperBound と 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 述語と同じ方法でファセットの抽出をサポートします。

プロパティ 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 など）を設定して、ユーザーに大まかなサイズを提供し、小さな結果に対する正確な合計を提供します。 または、true に設定すると、最低限必要な値 p.offset + p.limit までのみカウントされます。

  • 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

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

追加のクエリを実行するのではなく、現在のクエリを拡張します。

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

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

プロパティ properties-19

  • savedquery

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

similar similar

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

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

プロパティ properties-20

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

  • local
    下位ノードの相対パスまたは現在のノードの .（オプション、デフォルトは「.」）

tag tag

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

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

プロパティ properties-21

  • tag

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

  • 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 と組み合わせ、and=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
51c6a92d-a39d-46d7-8e3e-2db9a31c06a2