検索フォームの設定 configuring-search-forms
用途 検索Forms を使用すると、様々なAEMコンソールやオーサー環境のパネルで使用できる検索パネルで使用される検索用述語の選択をカスタマイズできます。 これらのパネルをカスタマイズすると、検索機能を特定のニーズに合わせて汎用化できます。
述語の範囲は標準で使用できます。複数の述語を追加できます。たとえば、指定した単一のプロパティに一致するアセットを検索する Property 述語、または特定のプロパティに指定した 1 つまたは複数の値に一致するアセットを検索する Options 述語を含みます。
以下が可能です。 検索フォームの設定 様々なコンソールおよびアセットブラウザー内で使用されます(ページの編集時)。 この これらのフォームを設定するためのダイアログ は、次の場所からアクセスできます。
-
ツール
-
一般
- 検索フォーム
-
このコンソールに初めてアクセスすると、すべての設定に鍵アイコンが表示されます。これは、該当する設定はデフォルト(標準)の設定であり、削除できないことを示します。設定をカスタマイズすると、鍵アイコンは非表示になります。ただし、カスタマイズした設定を削除した場合は、デフォルトの設定(および鍵アイコン)が復帰します。
設定 configurations
使用可能なデフォルト設定は次のとおりです。
-
ページエディター(ドキュメント検索):
この設定は、アセットブラウザーで(ページ編集時に)ドキュメントを検索する際に使用可能なオプションを定義します。
-
ページエディター(画像検索):
この設定は、アセットブラウザーで(ページ編集時に)画像を検索する際に使用可能なオプションを定義します。
-
ページエディター(原稿検索):
この設定は、アセットブラウザーで(ページ編集時に)原稿を検索する際に使用可能なオプションを定義します。
-
ページエディター(ページ検索):
この設定は、アセットブラウザーで(ページ編集時に)ページを検索する際に使用可能なオプションを定義します。
-
ページエディター(段落検索):
この設定は、アセットブラウザーで(ページ編集時に)段落を検索する際に使用可能なオプションを定義します。
-
ページエディター(製品検索):
この設定は、アセットブラウザーで(ページ編集時に)商品を検索する際に使用可能なオプションを定義します。
-
ページエディター(Dynamic Media Classic)[旧 Scene7] 検索):
この設定は、(ページ編集時に)アセットブラウザーでDynamic Media Classicリソースを検索する際に使用できるオプションを定義します。
-
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))
-
オプションノードのパス
実質的に
オプションパス と同じ。前者は共通の述語フィールドにのみ存在し、後者はアセットに固有です。 -
単一の選択 オンにすると、オプションは単一の選択のみを許可するチェックボックスとしてレンダリングされます。チェックボックスを誤って選択した場合は、選択を解除できます。
-
公開とライブコピーのプロパティ名
Sites 専用の述語の、公開およびライブコピーのチェックボックスのラベル。 -
「設定」タブのフィールドラベルの * は必須のフィールドを表し、空白のままにするとエラーメッセージが表示されます。
検索フォームの設定 configuring-your-search-forms
カスタマイズされた設定を作成または開く creating-opening-a-customized-configuration
-
に移動します。 ツール, 運用, 検索Forms.
-
カスタマイズする設定を選択します。
-
以下を使用: 編集 アイコンをクリックして、更新する設定を開きます。
-
新規のカスタマイズの場合は、必要に応じて新しい述語フィールドを追加して設定を定義します。既存のカスタマイズの場合は、既存のフィールドを選択して設定を更新できます。
-
「完了」を選択して設定を保存します。
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 管理者の検索パネル」を選択します。
次に、 検索フォームを編集 アイコン
-
設定に応じて、 オプション または Options プロパティ を設定に追加します。
-
特に次のフィールドを更新します。
-
プロパティ名
ターゲットノードで検索するノードプロパティを指定します。次に例を示します。
jcr:content/cq:template
-
オプションノードパス
オプションを保持するパスを選択します。次に例を示します。
/apps/cq/gui/content/common/options/predicates/templatetype
-
-
「完了」を選択して設定を保存します。
-
該当するコンソール ( この例では サイト) をクリックし、 検索 パネル 新しく定義された検索フォームと各種オプションが表示されます。必要なオプションを選択して検索結果を確認します。
ユーザーの権限 user-permissions
次の表に、検索フォームで編集、削除およびプレビューのアクションを実行するために必要な権限を示します。