検索フォームの設定 configuring-search-forms
検索フォーム を使用すると、オーサー環境の様々な AEM コンソールやパネルで利用可能な検索パネルで使用する、検索用述語の選択をカスタマイズできます。これらのパネルをカスタマイズすると、特定のニーズに合わせて検索機能を柔軟に利用できるようになります。
述語の範囲は標準で使用できます。複数の述語を追加できます。例えば、指定した単一のプロパティに一致するアセットを検索する Property 述語、または特定のプロパティに指定した 1 つまたは複数の値に一致するアセットを検索する Options 述語を含みます。
様々なコンソールおよびアセットブラウザー(ページ編集時)内で使用する検索フォームを設定できます。これらのフォームを設定するためのダイアログは、次のパスでアクセスできます。
-
ツール
-
一般
- 検索フォーム
-
このコンソールに初めてアクセスすると、すべての設定に鍵アイコンが表示されます。これは、該当する設定はデフォルト(標準)の設定であり、削除できないことを示します。設定をカスタマイズすると、鍵アイコンは非表示になります。ただし、カスタマイズした設定を削除した場合は、デフォルトの設定(および鍵アイコン)が復帰します。
設定 configurations
使用可能なデフォルト設定は次のとおりです。
-
ページエディター(ドキュメント検索):
この設定は、アセットブラウザーで(ページ編集時に)ドキュメントを検索する際に使用可能なオプションを定義します。
-
ページエディター(画像検索):
この設定は、アセットブラウザーで(ページ編集時に)画像を検索する際に使用可能なオプションを定義します。
-
ページエディター(原稿検索):
この設定は、アセットブラウザーで(ページ編集時に)原稿を検索する際に使用可能なオプションを定義します。
-
ページエディター(ページ検索):
この設定は、アセットブラウザーで(ページ編集時に)ページを検索する際に使用可能なオプションを定義します。
-
ページエディター(段落検索):
この設定は、アセットブラウザーで(ページ編集時に)段落を検索する際に使用可能なオプションを定義します。
-
ページエディター(製品検索):
この設定は、アセットブラウザーで(ページ編集時に)商品を検索する際に使用可能なオプションを定義します。
-
ページエディター(Dynamic Media Classic)[旧 Scene7] 検索):
この設定は、アセットブラウザーで(ページ編集時に)Scene7 リソースを検索する際に使用可能なオプションを定義します。
-
Sites 管理者の検索パネル:
この設定は、サイトコンソールの検索パネルを使用する際にユーザーが使用できる検索オプションを定義します。
-
ページエディター(ビデオ検索):
この設定は、アセットブラウザーで(ページ編集時に)ビデオを検索する際に使用可能なオプションを定義します。
-
アセット管理者の検索パネル:
この設定は、Assets のコンソールを使用する際にユーザーが使用できる検索オプションを定義します。
-
カタログ管理者の検索パネル:
この設定は、コマースカタログを検索する際にユーザーが使用できる検索オプションを定義します。
-
注文管理者の検索パネル:
この設定は、コマース注文を検索する際にユーザーが使用できる検索オプションを定義します。
-
製品コレクション管理者の検索パネル:
この設定は、コマース製品を検索する際にユーザーが使用できる検索オプションを定義します。
-
製品管理者の検索パネル:
この設定は、コマース製品を検索する際にユーザーが使用できる検索オプションを定義します。
-
プロジェクト管理者の検索パネル:
この設定は、プロジェクトを検索する際にユーザーが使用できる検索オプションを定義します。
述語とその設定 predicates-and-their-settings
述語 predicates
設定に応じて、次の述語を使用できます。
-
一般的な検索用の述語は、次の場所で定義されています。
/libs/cq/gui/components/common/admin/customsearch/searchpredicates
-
siteadmin(クラシック UI)にのみ関連する検索用の述語は、次の場所にあります。
/libs/cq/gui/components/siteadmin/admin/searchpanel/searchpredicates
- これらは非推奨であり、後方互換性のためにのみ使用できます。
/libs
には変更を加えないでください。述語の設定 predicate-settings
述語によって、設定に使用できる項目を選択できます。
-
フィールドラベル
述語の折りたたみ可能なヘッダーまたはフィールドラベルとして表示されるラベル。
-
説明
ユーザーのための詳細な説明。
-
プレースホルダー
フィルターテキストを入力しない場合は、空のテキストまたは述語のプレースホルダー。
-
プロパティ名
検索対象のプロパティ。相対パスとワイルドカード
*/*/*
を使用して、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))
-
オプションノードパス
事実上は オプションパス と同じですが、これのみが共通の述語フィールドにあり、その他はアセット専用です。 -
単一の選択 オンにすると、オプションは単一の選択のみを許可するチェックボックスとしてレンダリングされます。チェックボックスを誤って選択した場合は、選択を解除できます。
-
公開とライブコピーのプロパティ名
サイト専用の述語の、公開およびライブコピーのチェックボックスのラベル。 -
「設定」タブのフィールドラベルの * は必須のフィールドを表し、空白のままにするとエラーメッセージが表示されます。
検索フォームの設定 configuring-your-search-forms
カスタマイズされた設定を作成または開く creating-opening-a-customized-configuration
-
ツール/一般/検索フォーム に移動します。
-
カスタマイズする設定を選択します。
-
「編集」アイコンを使用して、更新する設定を開きます。
-
新規のカスタマイズの場合は、必要に応じて新しい述語フィールドを追加して設定を定義します。既存のカスタマイズの場合は、既存のフィールドを選択して設定を更新できます。
-
「完了」を選択して設定を保存します。
note note NOTE カスタマイズした設定は(必要に応じて)以下の場所に保存されます。 /apps/cq/gui/content/facets/<option>
/apps/commerce/gui/content/facets/<option>
述語フィールドの追加/編集とフィールド設定の定義 add-edit-a-predicate-field-and-define-field-settings
フィールドを追加または編集して、その設定を定義/更新できます。
-
更新するカスタマイズ設定を開きます。
-
フィールドを追加する場合は、「述語を選択」タブを開いて、必要な述語を必要な場所にドラッグします。日付の範囲の述語 の例を以下に示します。
-
状況に応じて、以下の手順を実行します。
-
フィールドを追加する場合:
述語を追加すると、「設定」タブが開き、定義可能なプロパティが表示されます。
-
既存の述語を更新する場合:
右側の述語フィールドを選択し、「設定」タブを開きます。
日付の範囲の述語 の設定例を以下に示します。
-
-
必要に応じて変更を加え、「完了」を選択して確定します。
検索設定のプレビュー previewing-the-search-configuration
-
「プレビュー」アイコンを選択します。
-
検索フォームが、該当するコンソールの検索列に表示されるとおりに、すべて展開された状態で表示されます。
-
プレビューを 閉じて 戻り、設定を終了します。
述語フィールドの削除 deleting-a-predicate-field
-
更新するカスタマイズ設定を開きます。
-
述語フィールド(右側)を選択し、「設定」タブを開いて、削除 アイコン(左下)を選択します。
-
削除の確認をリクエストするダイアログボックスが表示されます。
-
「完了」ボタンで削除およびその他の変更を確認します。
設定の削除(デフォルト復帰のため) deleting-a-configuration-to-reinstate-the-default
設定のカスタマイズが完了すると、デフォルトが上書きされます。カスタマイズした設定を削除することにより、デフォルトの設定を復帰させることができます。
カスタマイズした設定の削除は、コンソールからおこないます。
-
必要な設定(ページエディター(段落検索) など)を選択して、ツールバーの「削除」アイコンを選択します。
-
カスタマイズした設定が削除され、デフォルトが復帰します(このことは、コンソールに南京錠アイコンが再度表示されることで確認できます)。
オプションの述語の追加 adding-options-predicates
オプションの述語(オプション、オプションプロパティ)を使用すると、検索する項目を設定できます。ページノード上のプロパティなど、ページの直下にある何かを検索するために使用します。
以下の例(ページの作成に使用するテンプレートに従った検索)で、必要な手順を説明します。
-
検索対象のプロパティを定義するノードを作成します。
ユーザーに提示される個々のオプションの定義を格納するルートノードが必要です。
個々のオプションのノードには、次のプロパティが必要です。
jcr:title
- 検索パネルに表示されるフィールドラベルvalue
- 検索対象のプロパティ値
note note NOTE /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
-
-
「完了」を選択して設定を保存します。
-
該当するコンソール(この例では Sites)に移動し、検索 レールを開きます。新しく定義された検索フォームと各種オプションが表示されます。必要なオプションを選択して検索結果を確認します。
ユーザーの権限 user-permissions
次の表に、検索フォームで編集、削除およびプレビューのアクションを実行するために必要な権限を示します。