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

検索フォーム ​を使用すると、オーサー環境の様々な AEM コンソールやパネルで利用可能な検索パネルで使用する、検索用述語の選択をカスタマイズできます。これらのパネルをカスタマイズすると、特定のニーズに合わせて検索機能を柔軟に利用できるようになります。

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

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

  • ツール

    • 一般

      • 検索フォーム

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

検索フォームウィンドウ

設定 configurations

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

述語 predicates

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

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

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

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

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

  • オプションノードパス
    事実上は オプションパス ​と同じですが、これのみが共通の述語フィールドにあり、その他はアセット専用です。

  • 単一の選択 ​オンにすると、オプションは単一の選択のみを許可するチェックボックスとしてレンダリングされます。チェックボックスを誤って選択した場合は、選択を解除できます。

  • 公開とライブコピーのプロパティ名
    サイト専用の述語の、公開およびライブコピーのチェックボックスのラベル。

  • 設定」タブのフィールドラベルの * は必須のフィールドを表し、空白のままにするとエラーメッセージが表示されます。

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

カスタマイズされた設定を作成または開く creating-opening-a-customized-configuration

  1. ツール一般検索フォーム ​に移動します。

  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. フィールドを追加する場合は、「述語を選択」タブを開いて、必要な述語を必要な場所にドラッグします。日付の範囲の述語 ​の例を以下に示します。

    検索フォームの編集

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

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

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

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

      右側の述語フィールドを選択し、「設定」タブを開きます。

    日付の範囲の述語 ​の設定例を以下に示します。

    日付範囲の述語のプロパティ

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

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

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

    検索フォームをプレビュー

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

    検索フォームのプレビュー

  3. プレビューを​ 閉じて ​戻り、設定を終了します。

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

  1. 更新するカスタマイズ設定を開きます

  2. 述語フィールド(右側)を選択し、「設定」タブを開いて、削除 ​アイコン(左下)を選択します。

    削除アイコン

  3. 削除の確認をリクエストするダイアログボックスが表示されます。

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

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

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

NOTE
デフォルトの設定はどれも削除することができません。

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

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

    フォームの削除

  2. カスタマイズした設定が削除され、デフォルトが復帰します(このことは、コンソールに南京錠アイコンが再度表示されることで確認できます)。

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

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

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

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

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

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

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

    CRXDE でのオプションの追加

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

    次に、「検索フォームを編集」アイコンをクリックします。

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

  4. フィールドを更新します。具体的には次のフィールドです。

    • プロパティ名

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

      jcr:content/cq:template

    • オプションノードパス

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

      /apps/cq/gui/content/common/options/predicates/templatetype

    プロパティパスの追加

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

  6. 該当するコンソール(この例では Sites)に移動し、検索 ​レールを開きます。新しく定義された検索フォームと各種オプションが表示されます。必要なオプションを選択して検索結果を確認します。

    最終結果

ユーザーの権限 user-permissions

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

アクション
権限
編集
/apps ノード上の読み取り、書き込み権限。
削除
/apps ノード上の読み取り、書き込み、削除権限。
プレビュー
/var/dam/content ノード上の読み取り、書き込み、削除権限。
/apps ノード上の読み取り、書き込み権限。
recommendation-more-help
19ffd973-7af2-44d0-84b5-d547b0dffee2