検索ブループリント設定のリファレンス

Search Blueprints ユーザー・インターフェースには、ブループリントを作成するためのクエリ・ビルダーがあります。 要素の追加とクエリ設定の構成以外にも、多くのブループリントの使用例にとって重要な構成があります。 これらのコンフィギュレーションを操作するには、Global Menu → Applications → Blueprints にアクセスしてください。 新しいブループリントを追加するか、既存のブループリントを開き、 Configuration タブをクリックします。

各設定フィールドは、JSON文字列を受け付ける1つのテキスト・エリアからなる。

集約構成

Search Blueprint で Aggregations を構成します。 集計は、クエリの結果を取り込み、データを論理的な集合にグループ化する。 集計は、複雑なデータ要約を提供するために構成することができます。

検索ブループリントで追加された集約は、検索リクエストにすでに存在するもの（ファセットなど）に加えて適用されます。

ブループリントにアグリゲーションを追加するには

1. ブループリント・エディタで、 Configuration タブをクリックします。

2. Aggregation Configurationテキストエリアを見つけて、有効なJSONを入力する。 Elasticsearch DSLを使ってJSONを作成します。

   warning

   いくつかの集約プロパティはLiferayの検索APIではサポートされていません。

   {
      "aggs": {
         "date_histogram-test": {
            "date_histogram": {
               "date_histogram_interval": "minute",
               "field": "modified",
               "keyed": true,
               "min_doc_count": 1,
               "order": {
                  "_count": "asc"
               }
            }
         }
      }
   }
   

ハイライト構成

検索ブループリントで ハイライト を設定します。 検索ブループリントでハイライト設定を追加すると、デフォルトの検索ハイライト設定より優先されます。

ブループリントにハイライトを追加します、

1. ブループリント・エディタで、 Configuration タブをクリックします。

2. Highlight Configurationテキストエリアを見つけて、有効なJSONを入力します。 プロパティとその取り得る値については、 Elasticsearch ドキュメント に詳しく記述されています。

   {
      "fields": {
         "content${context.language_id}": {},
         "title${context.language_id}": {}
      },
      "fragment_size": 100,
      "number_of_fragments": 10,
      "post_tags": [
         "</liferay-hl>"
      ],
      "pre_tags": [
         "<liferay-hl>"
      ],
      "require_field_match": true
   }
   

並び替え構成

検索ブループリントで ソート を設定します。 検索ブループリントによって追加されたソートは、検索リクエストにすでに含まれているソート（例えば、Sort ウィジェットによるもの）に追加して適用されます。 ただし、検索ブループリントで追加されたソートは、ソート・ウィジェットのUIや設定画面には反映されません。

ブループリントにソートを追加するには

1. ブループリント・エディタで、 Configuration タブをクリックします。

2. Sort Configurationテキストエリアを見つけて、有効なJSONを入力する。

   {
      "sorts": [
         {
            "title_sortable": "desc"
         }
      ]
   }
   

パラメーター構成

検索コンテキストの属性から新規テンプレート変数を宣言します。 例えば、カスタムフィルタウィジェットをウィジェットテンプレートとブループリントと組み合わせることで、エンドユーザーが検索結果を未公開コンテンツと草稿コンテンツの間で切り替えることができます。

この例では、新しい検索コンテキスト属性を追加し、その属性値が true の場合、ウェブコンテンツを検索結果から除外します 。

1. 新しいブループリントにパラメータ構成を追加します。 Configuration タブに移動し、Parameter Configuration テキストボックスを見つけます。 追加

   {
      "parameters": {
         "exclude.journal_articles": {
            "type": "String"
         }
      }
   }
   

2. ブループリントにカスタム要素を追加します： Query Builder タブに移動し、Custom JSON Element を見つけて、 Add をクリックします。 既存のコンテンツを上書きする：

   {
      "description_i18n": {
         "en_US": "Conditionally exclude journal articles from the search."
      },
      "elementDefinition": {
         "category": "hide",
         "configuration": {
            "queryConfiguration": {
               "queryEntries": [
                  {
                     "clauses": [
                        {
                           "context": "query",
                           "occur": "filter",
                           "query": {
                              "bool": {
                                 "should": [
                                    {
                                       "bool": {
                                          "must_not": [
                                             {
                                                "term": {
                                                   "entryClassName": {
                                                   "value": "com.liferay.journal.model.JournalArticle"}
                                                }
                                             }
                                          ]
                                       }
                                    },
                                    {
                                       "bool": {
                                          "must": [
                                             {
                                                "term": {
                                                   "discussion": false
                                                }
                                             }
                                          ]
                                       }
                                    }
                                 ]
                              }
                           }
                        }
                     ],
                     "condition": {
                        "contains": {
                           "parameterName": "exclude.journal_articles",
                           "value": "true"
                        }
                     }
                  }
               ]
            }
         },
         "icon": "hidden"
      },
      "title_i18n": {
         "en_US": "Exclude Journal Articles"
      }
   }
   

3. 検索コンテキスト属性を追加する。 テスト目的で、 プレビュー サイドバーでこれを行うことができます。

4. ［プレビュー］ をクリックします。 歯車のアイコン () をクリックして、ブループリントのプレビュー検索に検索コンテキスト属性を追加します。 属性のキーと値のペアを入力してください： exclude.journal_articles/true

5. そして、 Done をクリックする。

チェックポイント ウェブコンテンツの記事を返すと予想される検索を実行し（必要であれば追加する）、記事が返されないことを確認する。 属性コンフィギュレーションをもう一度開き、値を false に設定する。 プレビュー検索にウェブコンテンツが含まれていることを確認します。

詳細設定

Advanced Configurationは、検索リクエスト・パラメーターとして、 source includesとexcludes を追加する。 _source フィールドは、インデックス要求に渡された保存されたドキュメント本体を含む。 このフィールド自体にはインデックスが付けられない。 ブループリントの詳細構成では、 _source フィールドに含めるフィールドまたはフィールドから除外するフィールドを指定して、 source フィールドを刈り込むことができます。 これは機能が重複しており、低レベル検索オプション・ウィジェットの Fields to Return_ 設定と衝突する可能性があるため、両方のアプローチを同時に使用してはならない。 ブループリントに詳細設定を追加するには、以下の手順に従います、

1. ブループリント・エディタで、 Configuration タブをクリックします。
2. Advanced Configurationのテキストエリアを見つけて、 excludes と includes を入力してください。 ワイルドカードは使用可能。

{
    "source":{
        "excludes":[
            "<fieldName1>",
            "<fieldName2>"
        ],
        "fetchSource":true,
        "includes":[
            "<fieldName3>",
            "<fieldName4>"
        ]
    }
}

コントロールパネルでの検索ブループリントの設定

検索ブループリントのほとんどの設定は、ブループリント・アプリケーションおよび検索ページ自体に直接あります。 ただし、Search Blueprints でジオロケーション機能をサポートするサービスを有効にするシステム/インスタンス構成が 2 つあります。

どちらの設定項目も、「コントロールパネル」 → 「システム/インスタンス設定」の「検索エクスペリエンス」カテゴリにあります。

Ipstack ユーザーのIPアドレスに基づくジオロケーション情報を提供します。

OpenWeatherMap は、ipstackと組み合わせて使用され、ユーザーの位置に基づいた気象情報を提供する。 検索ブループリントでこれを使用するには、ipstackも有効にする必要があります。