ウォークスルー

Commerceテンプレートプロパティのフィールドハンドラ作成

Sitecoreから継承するクラスを作成します 。Commerce.Plugin。Search。AbstractIndexFieldHandlerクラス:

public class ExternalSettingsFieldHandler : AbstractIndexFieldHandler

公共財産の名前を付け加えるExternalSettingsPropertyName:

public class ExternalSettingsFieldHandler : AbstractIndexFieldHandler { public string ExternalSettingsPropertyName { get; set; } = string.Empty;

ComposeValueメソッドのオーバーライドを追加し、有効なフィールドハンドラ情報を確認します:

public override object ComposeValue(object source, ConcurrentDictionary<string, object> context) { // check for valid field handler information if (context == null || source == null || !(source is CatalogItemBase entity) || string.IsNullOrEmpty(ExternalSettingsPropertyName)) { return null; }

ComposeValueの本文で「外部設定」コンポーネントを確認し、設定をインデックスするプロパティの決定論的IDに照合します。

• 一致があれば、指定された言語で最初にインデックスするプロパティ名を探してください。
• 指定された言語でマッチが存在しない場合は、共有設定を参照してください。
• 共有設定でマッチが見つからなければ、マッチは存在せず、インデックスするものがありません。

// check for required external settings information if (!entity.HasComponent() || !context.TryGetValue("LanguageCode", out object languageCode) || !context.TryGetValue("DeterministicId", out var tempDeterministicId) || !(tempDeterministicId is Guid deterministicId)) { return null; } string lang = languageCode.ToString().ToLowerInvariant(); var externalSettingsComponent = entity.GetComponent(); var settingsCollection = JsonConvert.DeserializeObject<Dictionary<Guid, Dictionary<string, Dictionary<string, string>>>>(externalSettingsComponent.Settings); if (!settingsCollection.ContainsKey(deterministicId)) { // this id in not in the external settings, return null return null; } var externalSettings = settingsCollectiondeterministicId; if (externalSettings == null) { // bad external settings return null return null; } // look for language first if (externalSettings.ContainsKey(lang)) { // we found a language, try to find the property var languageSettings = externalSettingslang; if (languageSettings.ContainsKey(ExternalSettingsPropertyName)) { // found it, return the value return languageSettingsExternalSettingsPropertyName; } } // no language property found, check shared settings var sharedSettings = externalSettings"shared"; if (sharedSettings.ContainsKey(ExternalSettingsPropertyName)) { // found in shared settings, return the value return sharedSettingsExternalSettingsPropertyName; } // Not found, just return null return null; } }

C:\inetpub\wwwroot\\wwwroot\data\Environments\PlugIn.Search.Solr.PolicySet-1.0.0.jsonファイルを開け。

インデックス構成を含むセクションを見つけてください。例えば、以下の例は新しいハンドラークラス("$type": "Myplugin.Search.Solr.ExternalSettingsFieldHandler, MyPlugin.Search.Solr")を定義するSitecoreマスターインデックス構成と、インデックス用のカスタムカタログエンティティプロパティ(「ExternalSettingsPropertyName」: "TestingText")を示しています。

{ "$type": "Sitecore.Commerce.Plugin.Search.ItemIndexablePolicy, Sitecore.Commerce.Plugin.Search", "IndexName": "sitecore_master_index", "FieldTypeMappers": ... "Fields": ... { "$type": "MyPlugin.Search.Solr.SolrIndexFieldConfiguration, MyPlugin.Search.Solr", "Name": "ExampleExternalSettingProperty", "Type": "System.String", "Handler": { "$type": "Myplugin.Search.Solr.ExternalSettingsFieldHandler, MyPlugin.Search.Solr", "ExternalSettingsPropertyName": "TestingText" }, "Localizable": true }

インデックス構成では、以下の変更を加えます。

• "Name"プロパティをテンプレートの新しいカスタムフィールドの名前に合わせて更新してくださいSitecore。

• "Handler"

  。

  !注新しいカスタムフィールドが共有設定でない場合は、"Localizable": true

設定変更を行ったら、Commerce Engineをブートストラップしてください。

IISマネージャー Microsoft Commerce Engineのミニオンサービスを再起動します(例: CommerceMinions_Sc)。

手動でインデックスSitecore XP再構築します。インデックスを再構築した後、Solr Adminクエリページで新しい検索ハンドラが検索インデックスに表示されます。以下の例では、新しいインデックスフィールドは "exampleexternalsettingproperty_t":"Testing Text"

{ "responseHeader":{ "status"

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

!注検索プロバイダーとしてAzureを使う場合は、Sitecore.Commerce.Engine.Connectors.Index.Azure.configファイルを開いてください。

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