検索フォームを使用して、オーサー環境の様々な AEM コンソール/パネルの検索パネルで使用する検索の述語の選択をカスタマイズできます。これらのパネルをカスタマイズすると、特定のニーズに合わせて検索機能の用途を拡大できます。
述語の範囲は標準で使用できます。複数の述語を追加できます。たとえば、指定した単一のプロパティに一致するアセットを検索する Property 述語、または特定のプロパティに指定した 1 つまたは複数の値に一致するアセットを検索する Options 述語を含みます。
様々なコンソール内およびアセットブラウザー(ページ編集時)で使用する検索フォームを設定できます。これらのフォームを設定するためのダイアログには、次の手順でアクセスできます。
ツール
一般
このコンソールに初めてアクセスすると、すべての設定に鍵アイコンが表示されます。これは、該当する設定はデフォルト(標準)の設定であり、削除できないことを示します。設定をカスタマイズすると、鍵アイコンは非表示になります。ただし、カスタマイズした設定を削除した場合は、デフォルトの設定(および鍵アイコン)が復帰します。
使用可能なデフォルト設定は次のとおりです。
ページエディター(ドキュメント検索):
この設定は、アセットブラウザーで(ページ編集時に)ドキュメントを検索する際に使用可能なオプションを定義します。
ページエディター(画像検索):
この設定は、アセットブラウザーで(ページ編集時に)画像を検索する際に使用可能なオプションを定義します。
ページエディター(原稿検索):
この設定は、アセットブラウザーで(ページ編集時に)原稿を検索する際に使用可能なオプションを定義します。
ページエディター(ページ検索):
この設定は、アセットブラウザーで(ページ編集時に)ページを検索する際に使用可能なオプションを定義します。
ページエディター(段落検索):
この設定は、アセットブラウザーで(ページ編集時に)段落を検索する際に使用可能なオプションを定義します。
ページエディター(製品検索):
この設定は、アセットブラウザーで(ページ編集時に)商品を検索する際に使用可能なオプションを定義します。
ページエディター(Dynamic Media Classic)[旧 Scene7] 検索):
この設定は、アセットブラウザーで(ページ編集時に)Scene7 リソースを検索する際に使用可能なオプションを定義します。
Sites 管理者の検索パネル:
この設定は、サイトコンソールの検索パネルを使用する際にユーザーが使用できる検索オプションを定義します。
ページエディター(ビデオ検索):
この設定は、アセットブラウザーで(ページ編集時に)ビデオを検索する際に使用可能なオプションを定義します。
アセット管理者の検索パネル:
この設定は、Assets のコンソールを使用する際にユーザーが使用できる検索オプションを定義します。
カタログ管理者の検索パネル:
この設定は、コマースカタログを検索する際にユーザーが使用できる検索オプションを定義します。
注文管理者の検索パネル:
この設定は、コマース注文を検索する際にユーザーが使用できる検索オプションを定義します。
製品コレクション管理者の検索パネル:
この設定は、コマース製品を検索する際にユーザーが使用できる検索オプションを定義します。
製品管理者の検索パネル:
この設定は、コマース製品を検索する際にユーザーが使用できる検索オプションを定義します。
プロジェクト管理者の検索パネル:
この設定は、プロジェクトを検索する際にユーザーが使用できる検索オプションを定義します。
設定によって、次の述語が使用可能です。
述語 | 目的 | 設定 |
---|---|---|
分析 | Analytics データを表示する際の、Sites ブラウザーの検索/フィルター機能。Analytics の検索フィルターは、マッピングされ、カスタマイズされた Analytics 列に一致するまで読み込みます。 |
|
最終変更アセット | アセットが最後に変更された日付。 |
日付の述語に基づくカスタマイズされた述語。 |
コンポーネント | 作成者が、特定のコンポーネントを持つページを検索/フィルターできます。例えば、画像ギャラリーなどです。 |
|
日付 | 日付のプロパティに基づく、アセットのスライダーベースの検索。 |
|
日付範囲 | 日付プロパティに指定した範囲内に作成されたアセットを検索します。検索パネルで、開始日と終了日を指定できます。 |
|
有効期限ステータス | 有効期限ステータスに基づいてアセットを検索します。 |
|
ファイルサイズ | サイズに基づいてアセットを検索します。 |
|
非表示のフィルター | プロパティおよび値のフィルターで、ユーザーには表示されません。 |
|
オプション | オプションは、ユーザーが作成したコンテンツノードです。 詳しくは、オプションの述語の追加を参照してください。 |
|
オプションプロパティ | オプションのプロパティで検索します。 |
|
ページステータス | ステータスに従ってページを検索します。 |
|
パス | 特定のパスに配置されているアセットを検索します。 |
|
プロパティ | 指定したプロパティで検索します。 | なし |
公開ステータス | 公開ステータスに基づいてアセットを検索します。 |
|
範囲 | 指定した範囲内にあるリソースを検索します。検索パネルで、範囲の最小値と最大値を指定できます。 |
|
範囲オプション | アセット専用の検索述語であり、共通のスライダーの述語と同じです。下位互換性の問題により、現在も使用可能です。 |
|
レーティング | 評価に従ってアセットを検索します。 |
|
相対的な日付 | 相対的な作成日に基づいてアセットを検索します。 |
|
スライダー範囲 | 範囲の述語をスライダー機能で拡張する共通の検索述語。検索対象のプロパティの値は、スライダーの制限内とする必要があります。 |
|
タグ | タグに基づいてアセットを検索します。タグリストに様々なタグを入力するように、パスプロパティを設定できます。 |
|
タグ | タグに基づいて検索します。 |
|
一般的な検索用の述語は、次の場所で定義されています。
/libs/cq/gui/components/common/admin/customsearch/searchpredicates
siteadmin(クラシック UI)にのみ関連する検索用の述語は、次の場所にあります。
/libs/cq/gui/components/siteadmin/admin/searchpanel/searchpredicates
この情報は参照用です。/libs
には変更を加えないでください。
述語によって、設定に使用できる項目を選択できます。
フィールドラベル
述語の折りたたみ可能なヘッダーまたはフィールドラベルとして表示されるラベル。
説明
ユーザーのための詳細な説明。
プレースホルダー
フィルターテキストを入力しない場合は、空のテキストまたは述語のプレースホルダー。
プロパティ名
検索対象のプロパティ。相対パスとワイルドカード */*/*
を使用して、jcr:content
ノードを基準とするプロパティの深さを指定します(各アスタリスクは 1 つのノードレベルを表します)。
jcr:content
ノード上の x
プロパティを持つリソースの第 1 レベルの子ノードでのみ検索する場合は、*/jcr:content/x
を使用してください。
プロパティの深さ
リソース内でそのプロパティを検索する最大の深さです。そのため、子のレベルが指定の深さに等しくなるまで、そのプロパティの検索をリソースと再帰的な子に対して実行できます。
プロパティの値
プロパティの値は、絶対文字列または式言語です。例えば、cq:Page
または
${empty requestPathInfo.suffix ? "/content" : requestPathInfo.suffix}
です。
範囲テキスト
日付の範囲の述語の範囲フィールドのラベル。
オプションパス
ユーザーは、「述語の設定」タブのパスブラウザーを使用してパスを選択できます。選択した後、+ アイコンを使用して、有効なオプションのリストに選択を追加します(必要に応じて、- アイコンを削除します)。
オプションは、ユーザーが作成したコンテンツノードで、次の構造を持ちます。
(jcr:primaryType = nt:unstructured, value (String), jcr:title (String))
オプションノードのパス
実質的に
オプションパスと同じ。前者は共通の述語フィールドにのみ存在し、後者はアセットに固有です。
単一の選択オンにすると、オプションは単一の選択のみを許可するチェックボックスとしてレンダリングされます。チェックボックスを誤って選択した場合は、選択を解除できます。
公開とライブコピーのプロパティ名
Sites 専用の述語の、公開およびライブコピーのチェックボックスのラベル。
「設定」タブのフィールドラベルの * は必須のフィールドを表し、空白のままにするとエラーメッセージが表示されます。
ツール/一般/検索フォームに移動します。
カスタマイズする設定を選択します。
「編集」アイコンを使用して、更新用に設定を開きます。
新規のカスタマイズの場合は、必要に応じて新しい述語フィールドを追加して設定を定義します。既存のカスタマイズの場合は、既存のフィールドを選択して設定を更新できます。
「完了」を選択して設定を保存します。
カスタマイズした設定は(必要に応じて)以下の場所に保存されます。
/apps/cq/gui/content/facets/<option>
/apps/commerce/gui/content/facets/<option>
フィールドを追加または編集して、その設定を定義/更新できます。
更新するカスタマイズ設定を開きます。
新しいフィールドを追加する場合は、「述語を選択」タブを開いて、必要な述語を必要な場所にドラッグします。日付の範囲の述語の例を以下に示します。
状況に応じて、以下の手順を実行します。
新しいフィールドを追加する場合:
述語を追加すると、「設定」タブが開き、定義可能なプロパティが表示されます。
既存の述語を更新する場合:
右側の述語フィールドを選択し、「設定」タブを開きます。
日付の範囲の述語の設定例を以下に示します。
必要に応じて変更を加え、「完了」を選択して確定します。
「プレビュー」アイコンを選択します。
検索フォームが、該当するコンソールの検索列に表示されるとおりに、すべて展開された状態で表示されます。
プレビューを閉じて戻り、設定を完了します。
更新するカスタマイズ設定を開きます。
述語フィールド(右側)を選択し、「設定」タブを開いて、削除アイコン(左下)を選択します。
削除の確認を要求するダイアログが表示されます。
「完了」ボタンで削除およびその他の変更を確認します。
設定のカスタマイズが完了すると、デフォルトが上書きされます。カスタマイズした設定を削除することにより、デフォルトの設定を復帰させることができます。
デフォルトの設定は削除できません。
カスタマイズした設定の削除は、コンソールからおこないます。
必要な設定(ページエディター(段落検索)など)を選択して、ツールバーの「削除」アイコンを選択します。
カスタマイズした設定が削除され、デフォルトが復帰します(このことは、コンソールに鍵アイコンが再度表示されることで確認できます)。
オプションの述語(オプション、オプションプロパティ)を使用すると、検索対象の項目を設定できます。通常は、ページノード上のプロパティなど、ページの直下にあるものを検索するために使用します。
以下の例(ページの作成に使用するテンプレートに従った検索)で、必要な手順を説明します。
検索対象のプロパティを定義するノードを作成します。
ユーザーに提示される個々のオプションの定義を格納するルートノードが必要になります。
個々のオプションのノードには、次のプロパティが必要です。
jcr:title
- 検索パネルに表示されるフィールドラベルvalue
- 検索対象のプロパティ値/libs
パス内の設定は一切変更しないでください。
/libs
コンテンツは、インスタンスを次回アップグレードするとき(場合によってはホットフィックスまたは機能パックを適用したとき)に上書きされるからです。
設定およびその他の変更に推奨される方法は次のとおりです。
/libs
内に存在)を、/apps
の下で再作成します。この場合、次の場所から選択します。/libs/cq/gui/content/common/options/predicates
/apps.
内で変更作業をおこないます。検索フォームコンソールを開いて、更新する設定を選択します。例えば、「Sites 管理者の検索パネル」を選択します。
次に、「検索フォームを編集」アイコンをクリック/タップします。
設定により、オプションまたはオプションプロパティを設定に追加します。
フィールドを更新します。具体的には次のフィールドです。
プロパティ名
ターゲットノードで検索するノードプロパティを指定します。次に例を示します。
jcr:content/cq:template
オプションノードパス
オプションを保持するパスを選択します。次に例を示します。
/apps/cq/gui/content/common/options/predicates/templatetype
「完了」を選択して設定を保存します。
該当するコンソール(この例ではサイト)に移動し、検索レールを開きます。新しく定義された検索フォームと各種オプションが表示されます。必要なオプションを選択して検索結果を確認します。
次の表に、検索フォームで編集、削除およびプレビューのアクションを実行するために必要な権限を示します。
アクション | 権限 |
編集 | /apps ノード上の読み取り、書き込み権限。 |
削除 | /apps ノード上の読み取り、書き込み、削除権限。 |
プレビュー | /var/dam/content ノード上の読み取り、書き込み、削除権限。/apps ノード上の読み取り、書き込み権限。 |