検索フォームの設定 configuring-search-forms

CAUTION
AEM 6.4 の拡張サポートは終了し、このドキュメントは更新されなくなりました。 詳細は、 技術サポート期間. サポートされているバージョンを見つける ここ.

用途 検索Forms を使用すると、様々なAEMコンソールやオーサー環境のパネルで使用できる検索パネルで使用される検索用述語の選択をカスタマイズできます。 これらのパネルをカスタマイズすると、検索機能を特定のニーズに合わせて汎用化できます。

述語の範囲は標準で使用できます。複数の述語を追加できます。たとえば、指定した単一のプロパティに一致するアセットを検索する Property 述語、または特定のプロパティに指定した 1 つまたは複数の値に一致するアセットを検索する Options 述語を含みます。

以下が可能です。 検索フォームの設定 様々なコンソールおよびアセットブラウザー内で使用されます(ページの編集時)。 この これらのフォームを設定するためのダイアログ は、次の場所からアクセスできます。

  • ツール

    • 一般

      • 検索フォーム

このコンソールに初めてアクセスすると、すべての設定に鍵アイコンが表示されます。これは、該当する設定はデフォルト(標準)の設定であり、削除できないことを示します。設定をカスタマイズすると、鍵アイコンは非表示になります。ただし、カスタマイズした設定を削除した場合は、デフォルトの設定(および鍵アイコン)が復帰します。

chlimage_1-374

設定 configurations

使用可能なデフォルト設定は次のとおりです。

  • ページエディター(ドキュメント検索):

    この設定は、アセットブラウザーで(ページ編集時に)ドキュメントを検索する際に使用可能なオプションを定義します。

  • ページエディター(画像検索):

    この設定は、アセットブラウザーで(ページ編集時に)画像を検索する際に使用可能なオプションを定義します。

  • ページエディター(原稿検索):

    この設定は、アセットブラウザーで(ページ編集時に)原稿を検索する際に使用可能なオプションを定義します。

  • ページエディター(ページ検索):

    この設定は、アセットブラウザーで(ページ編集時に)ページを検索する際に使用可能なオプションを定義します。

  • ページエディター(段落検索):

    この設定は、アセットブラウザーで(ページ編集時に)段落を検索する際に使用可能なオプションを定義します。

  • ページエディター(製品検索):

    この設定は、アセットブラウザーで(ページ編集時に)商品を検索する際に使用可能なオプションを定義します。

  • ページエディター(Dynamic Media Classic)[旧 Scene7] 検索)

    この設定は、(ページ編集時に)アセットブラウザーでDynamic Media Classicリソースを検索する際に使用できるオプションを定義します。

  • Sites 管理者の検索パネル:

    この設定は、サイトコンソールの検索パネルを使用する際にユーザーが使用できる検索オプションを定義します。

  • ページエディター(ビデオ検索):

    この設定は、アセットブラウザーで(ページ編集時に)ビデオを検索する際に使用可能なオプションを定義します。

  • アセット管理者の検索パネル:

    この設定は、Assets のコンソールを使用する際にユーザーが使用できる検索オプションを定義します。

  • カタログ管理者の検索パネル:

    この設定は、コマースカタログを検索する際にユーザーが使用できる検索オプションを定義します。

  • 注文管理者の検索パネル:

    この設定は、コマース注文を検索する際にユーザーが使用できる検索オプションを定義します。

  • 製品コレクション管理者の検索パネル:

    この設定は、コマース製品を検索する際にユーザーが使用できる検索オプションを定義します。

  • 製品管理者の検索パネル:

    この設定は、コマース製品を検索する際にユーザーが使用できる検索オプションを定義します。

  • プロジェクト管理者の検索パネル:

    この設定は、プロジェクトを検索する際にユーザーが使用できる検索オプションを定義します。

述語とその設定 predicates-and-their-settings

述語 predicates

設定に応じて、次の述語を使用できます。

述語
目的
設定
分析
Analytics データを表示する際の、Sites ブラウザーの検索/フィルター機能。Analytics の検索フィルターは、マッピングされ、カスタマイズされた Analytics 列に一致するまで読み込みます。
  • フィールドラベル
  • 説明
最終変更アセット
アセットが最後に変更された日付。
日付の述語に基づく、カスタマイズされた述語。
コンポーネント
作成者が、特定のコンポーネントを持つページを検索/フィルターできます。例えば、画像ギャラリーなどです。
  • フィールドラベル
  • プレースホルダー
  • プロパティ名*
  • プロパティの深さ
  • 説明
日付
日付プロパティに基づいた、アセットのスライダーベースの検索。
  • フィールドラベル
  • プロパティ名*
  • 説明
日付範囲
指定した範囲内で作成されたアセットを日付プロパティで検索します。 検索パネルで、開始日と終了日を指定できます。
  • フィールドラベル
  • プレースホルダー
  • プロパティ名*
  • 範囲テキスト (開始)*
  • 範囲テキスト (終了)*
  • 説明
有効期限ステータス
有効期限ステータスに基づいてアセットを検索します。
  • フィールドラベル
  • プロパティ名*
  • 説明
ファイルサイズ
サイズに基づいてアセットを検索します。
  • フィールドラベル
  • プロパティ名*
  • オプションパス
  • 説明
非表示フィルター
プロパティおよび値のフィルターで、ユーザーには表示されません。
  • プロパティ名
  • プロパティの値
  • 説明
オプション

オプションは、ユーザーが作成したコンテンツノードです。

詳しくは、 オプションの述語の追加 を参照してください。

  • フィールドラベル
  • JSON パス
  • プロパティ名*
  • 単一の選択
  • オプションパス
  • 説明
オプションプロパティ
オプションのプロパティで検索します。
  • フィールドラベル
  • プロパティ名*
  • オプションノードパス
  • 単一の選択
  • 説明
ページステータス
ステータスに従ってページを検索します。
  • フィールドラベル
  • プロパティ名を公開
  • ライブコピーのプロパティ名
  • 説明
パス
特定のパスの下にあるアセットを検索します。
  • フィールドラベル
  • 検索パスを追加
  • 説明
プロパティ
指定したプロパティで検索します。
なし
公開ステータス
公開ステータスに基づいてアセットを検索する
  • フィールドラベル
  • プロパティ名*
  • 説明
範囲
指定した範囲内にあるリソースを検索します。 検索パネルで、範囲の最小値と最大値を指定できます。
  • フィールドラベル
  • プロパティ名
  • 説明
範囲オプション
アセットに固有の検索用述語で、共通のスライダーの述語と同じもの。 後方互換性の問題が原因で、引き続き使用できます。
  • フィールドラベル
  • プロパティ名*
  • オプションパス
  • 説明
レーティング
評価に従ってアセットを検索します。
  • フィールドラベル
  • プロパティ名*
  • オプションパス
  • 説明
相対的な日付
相対的な作成日に基づいてアセットを検索する
  • フィールドラベル
  • プロパティ名*
  • 相対的な日付
  • 説明
スライダー範囲
スライダー機能を使用して範囲の述語を拡張する、共通の検索用述語。 検索対象のプロパティの値は、スライダーの制限値の間にする必要があります。
  • フィールドラベル
  • プロパティ名*
  • 説明
タグ
タグに基づいてアセットを検索します。 「パス」プロパティを設定して、「タグ」リストに様々なタグを表示できます。
  • フィールドラベル
  • プロパティ名*
  • オプションパス
  • 説明
タグ
タグに基づいて検索します。
  • プレースホルダー
  • プロパティ名*
  • 説明
NOTE
  • 一般的な検索用の述語は、次の場所で定義されています。
    /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

  1. に移動します。 ツール, 運用, 検索Forms.

  2. カスタマイズする設定を選択します。

  3. 以下を使用: 編集 アイコンをクリックして、更新する設定を開きます。

  4. 新規のカスタマイズの場合は、必要に応じて新しい述語フィールドを追加して設定を定義します。既存のカスタマイズの場合は、既存のフィールドを選択して設定を更新できます。

  5. 完了」を選択して設定を保存します。

    note note
    NOTE
    カスタマイズした設定は(必要に応じて)以下の場所に保存されます。
    • /apps/cq/gui/content/facets/<option>
    • /apps/commerce/gui/content/facets/<option>

述語フィールドの追加/編集とフィールド設定の定義 add-edit-a-predicate-field-and-define-field-settings

フィールドを追加または編集して、その設定を定義/更新できます。

  1. カスタマイズした設定を開く 更新用。

  2. 新しいフィールドを追加する場合は、 述語を選択 「 」タブをクリックし、必要な述語を必要な場所にドラッグします。 日付の範囲の述語 ​の例を以下に示します。

    chlimage_1-375

  3. 状況に応じて、以下の手順を実行します。

    • 新しいフィールドを追加する場合:

      述語を追加すると、「設定」タブが開き、定義可能なプロパティが表示されます。

    • 既存の述語を更新する場合:

      右側の述語フィールドを選択し、「設定」タブを開きます。
      日付の範囲の述語 ​の設定例を以下に示します。

    chlimage_1-376

  4. 必要に応じて変更を加え、「完了」を選択して確定します。

検索設定のプレビュー previewing-the-search-configuration

  1. 「プレビュー」アイコンを選択します。

  2. 検索フォームが、該当するコンソールの検索列に表示されるとおりに、すべて展開された状態で表示されます。

    chlimage_1-377

  3. 閉じる プレビューを使用して設定を戻し、完了します。

述語フィールドの削除 deleting-a-predicate-field

  1. カスタマイズした設定を開く 更新用。

  2. 述語フィールド(右側)を選択し、 設定 タブをクリックし、 削除 アイコン(左下)をクリックします。

  3. 削除の確認を要求するダイアログが表示されます。

  4. 完了」ボタンで削除およびその他の変更を確認します。

設定の削除(デフォルト復帰のため) deleting-a-configuration-to-reinstate-the-default

設定のカスタマイズが完了すると、デフォルトが上書きされます。カスタマイズした設定を削除することにより、デフォルトの設定を復帰させることができます。

NOTE
どちらのデフォルト設定も削除できません。

カスタマイズした設定の削除は、コンソールからおこないます。

  1. 必要な設定(ページエディター(段落検索) ​など)を選択して、ツールバーの「削除」アイコンを選択します。

    chlimage_1-378

  2. カスタマイズされた設定が削除され、デフォルトが復元されます(コンソールに南京錠アイコンが再表示されます)。

オプション述語の追加 adding-options-predicates

オプションの述語(オプション、オプションプロパティ)を使用すると、検索対象の項目を設定できます。通常は、ページノード上のプロパティなど、ページの直下にあるものを検索するために使用します。

以下の例(ページの作成に使用するテンプレートに従った検索)で、必要な手順を説明します。

  1. 検索対象のプロパティを定義するノードを作成します。

    ユーザーに提示される個々のオプションの定義を格納するルートノードが必要になります。

    個々のオプションのノードには、次のプロパティが必要です。

    • jcr:title - 検索パネルに表示されるフィールドラベル
    • value - 検索対象のプロパティ値

    chlimage_1-379

    note note
    NOTE
    /libs パス内の設定は​ 一切 ​変更しないでください。
    /libs コンテンツは、インスタンスを次回アップグレードするとき(場合によってはホットフィックスまたは機能パックを適用したとき)に上書きされるからです。
    設定およびその他の変更に推奨される方法は次のとおりです。
    1. 必要な項目(/libs 内に存在)を、/apps の下で再作成します。この場合、次の場所から選択します。
    2. /libs/cq/gui/content/common/options/predicates
    3. /apps. 内で変更作業をおこないます。
  2. 検索フォーム ​コンソールを開いて、更新する設定を選択します。例えば、「Sites 管理者の検索パネル」を選択します。

    次に、 検索フォームを編集 アイコン

  3. 設定に応じて、 オプション または Options プロパティ を設定に追加します。

  4. 特に次のフィールドを更新します。

    • プロパティ名

      ターゲットノードで検索するノードプロパティを指定します。次に例を示します。

      jcr:content/cq:template

    • オプションノードパス

      オプションを保持するパスを選択します。次に例を示します。

      /apps/cq/gui/content/common/options/predicates/templatetype
      chlimage_1-380

  5. 完了」を選択して設定を保存します。

  6. 該当するコンソール ( この例では サイト) をクリックし、 検索 パネル 新しく定義された検索フォームと各種オプションが表示されます。必要なオプションを選択して検索結果を確認します。

    chlimage_1-381

ユーザーの権限 user-permissions

次の表に、検索フォームで編集、削除およびプレビューのアクションを実行するために必要な権限を示します。

アクション
権限
編集
/apps ノード上の読み取り、書き込み権限。
削除
/apps ノード上の読み取り、書き込み、削除権限。
プレビュー
/var/dam/content ノード上の読み取り、書き込み、削除権限。
/apps ノード上の読み取り、書き込み権限。
recommendation-more-help
5ce3024a-cbea-458b-8b2f-f9b8dda516e8