1. Searchフィールドハンドラ

ウォークスルー

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

デフォルトのSearchプラグインが新しいフィールドに合ったハンドラータイプを提供していない場合、カスタムフィールドハンドラークラスを作成できます。

このウォークスルーでは、以下の方法を説明します:

  • 新しいフィールドをインデックスするために新しいフィールドハンドラを作成します。
  • 新しいフィールドをCE Connect検索プロバイダーの設定に追加し、Sitecoreで検索可能にします。

新しいフィールドをインデックスするための新しいフィールドハンドラーを作成する

カスタムインデックスフィールド用の新しいフィールドハンドラを作成するには:

!注現在の検索フィールドハンドラのアーキテクチャでは、パイプラインやコマンドのインスタンスを解決する機能がありません。ハンドラーがコンテキストに必要とする値を追加しなければなりません。

  1. Sitecoreから継承するクラスを作成します 。Commerce.Plugin.Search。AbstractIndexFieldHandlerクラスを使い、以下の例のようにComposeValueメソッドを実装します。

    public class CustomFieldHandler : AbstractIndexFieldHandler { /// public override object ComposeValue(object source, ConcurrentDictionary<string, object> context) { if (context == null || source == null || !(source is CatalogItemBase entity)) { return null; } return $"Custom field handler value: {entity.Id}"; } }

    !注リアルタイムの値をインデックスするためにパイプラインへの非同期呼び出しをサポートするカスタムハンドラを作成する必要がある場合は、AbstractAsyncIndexFieldHandlerクラスからカスタムハンドラを派生させる必要があります。

  2. カスタムフィールドハンドラを検索インデックスに登録するには、展開で使用している検索プロバイダーの検索ポリシーセットに追加する必要があります。Solr(PlugIn.Search.Solr.PolicySet-1.0.0.json)のポリシーセットには、Sitecore.Commerce.Plugin.Search.ItemIndexablePolicy, Sitecore.Commerce.Plugin.Search型の2つのポリシーが含まれています。これらのポリシーは、接続されたSitecore XPサイトのマスターデータベースとWebデータベースを表します。両方のインデックスの “Fields” コレクションにカスタムフィールドハンドラーを追加し、新しいハンドラを登録し、コンテンツがマスターデータベースとWebデータベースの両方でインデックスされていることを確認します。

    以下は、PlugIn.Search.Solr.PolicySet-1.0.0.jsonファイルに追加されたカスタムSolrフィールドハンドラー("Company.Project.Search.CustomFieldHandler, Company.Project")の例を示しています。

    {     "$type": "Sitecore.Commerce.Plugin.Search.ItemIndexablePolicy, Sitecore.Commerce.Plugin.Search",     "IndexName": "sitecore_web_index",     "FieldTypeMappers":         …     ,     "Fields":        {            "$type": "Sitecore.Commerce.Plugin.Search.Solr.SolrIndexFieldConfiguration, Sitecore.Commerce.Plugin.Search.Solr",            "Name": "customfield",            "Type": "System.String",            "Handler": {                "$type": "Company.Project.Search.CustomFieldHandler, Company.Project"             }         }     }

  3. 設定変更後、Commerce Engine環境をブートストラップして 変更を適用してください。

  4. IISマネージャー Microsoft、Commerce Engineのミニオンサービス(CommerceMinions_Sc)を再起動してください。

  5. インデックスSitecore XP手動で再構築します。インデックスを再構築した後、新しい検索ハンドラが検索インデックス上で確認されます。以下の例に示されています:

    New search handlers are visible in the search index.

CE Connect検索プロバイダー設定に新しいフィールドを追加する

新しいフィールドをSitecoreで検索可能にするには、CE Connectの検索プロバイダー設定に追加する必要があります。

CE Connectの検索プロバイダー設定に新しいフィールドを追加するには:

  1. Sitecoreサービスインスタンスの \App_Config\Include\Y.Commerce.Engineフォルダで検索プロバイダーの設定ファイルを開きます。例えば、Sorlの場合はSitecore.Commerce.Engine.Connectors.Index.Solr.configファイルを開いてください。

  2. FieldMapセクションで新しいfieldName定義を追加します。次の例では、"customfield"という新しいフィールドを追加します。

  3. 変更を保存して 、Commerce Engineをブートストラップしてください。

この記事を改善するための提案がある場合は、 お知らせください!