事前定義商務エンジンのミニオン

Sitecoreのウェブおよびマスターインデックスのミニオンインデックス作成

Catalogプラグインは、カタログ、カテゴリ、販売可能なアイテムを含むカタログエンティティの完全または増分的なインデックス化を担当するミニオンを定義します。Sitecoreで使用されている検索プロバイダー(例えばSolr)は、Commerce Engineでインデックス化されたカタログエンティティをSitecoreのウェブやマスターインデックスの再構築時に使用し、Sitecore Content Editorやストアフロントユーザーに最新の検索結果を提供できます。

Business Tools検索のためのミニオンのインデックス作成

Searchプラグインは、注文、顧客、カタログ項目などのCommerceエンティティのインデックス作成タスクを行うミニオンを提供します。Business Toolsをサービスしている検索プロバイダー(例えばSolr)は、Commerceのインデックスを使って検索結果をBusiness Toolsユーザーに返すことができます。

商取引命令の手下たち

注文プロセスのミニオン は、注文が最初の 保留 状態から 最終注文完了 状態へと移行する過程で、注文をリストからリストへと移動させる重要な役割を果たします。

パージカーツの手下

PurgeCartsMinionミニオンは、あらかじめ設定された閾値に基づいて削除可能になった放置または空のカートをデータベースから削除するメンテナンスプロセスとして動作します。

PurgeCartsMinionミニオンはカートのリスト("ListsToWatch": "Carts")を監視し、24時間ごとに("WakeupInterval": "01.0:00

PurgeCartsPolicy構成は閾値(日数)を決定し、その後ミニオンは空または放棄されたカートをカートリストから削除します。以下の例は、サンプルPlugin.AdventureWorks.CommerceMinions.jsonファイル(Sitecoreの一部としてパッケージ化されている)で定義されたポリシー設定を示しています。Commerce.Engine。SDK)。

{ "$type":"Sitecore.Commerce.Plugin.Carts.PurgeCartsPolicy, Sitecore.Commerce.Plugin.Carts", "AbandonedCartsThreshold": 14, "EmptyCartsThreshold": 2 },

前述の方針定義に基づく:

• 放置されたカートは14日間の非活動で削除対象となります。
• 空のカートは2日間の非活動で削除対象となります。

PurgeCartsMinionの手下がIPurgeCartsMinionPipelineパイプラインを呼びます。

パージカタログの手下

PurgeCatalogsMinionミニオンは、データベースから削除されたカタログを一掃するメンテナンスプロセスとして動作します。カタログが削除される際、例えばBusiness ToolsユーザーインターフェースやPostmanのサンプルDelete Catalogリクエストを使って行うと、削除済みカタログのリストに載せられます。パージカタログのミニオンはそのリスト("ListsToWatch": "PurgeCatalogs")を監視し、一定の間隔でリストから削除されたカタログをデータベースから一掃します。デフォルトでは、ミニオンは5分ごとに実行されます。

!注Sitecore XC Business Toolsでは、削除されたカタログはパージカタログのミニオンが実行して事実上データベースから削除されるまで検索結果に現れ続けます。

削除されたカタログがデータベースから削除される場合:

• 削除されたカタログにのみ関連付けられる販売可能な商品はデータベースから削除されます。
• 削除されたカタログに関連するカテゴリもデータベースから削除されます。

以下の例は、Plugin.Minions.PolicySet-1.*.*.jsonファイルで定義されたデフォルトのPurgeCatalogsMinionsポリシーを示しています。

{ "$type": "Sitecore.Commerce.Core.MinionPolicy, Sitecore.Commerce.Core", "WakeupInterval": "`00

!注PostmanでRun Purge Catalogs Minionリクエストを実行して、データベースから削除されたカタログを強制的に削除できます。

大規模なカタログを整理する際の考慮事項

PurgeCatalogsMinionおよびPurgeCategoriesMinionミニオンはトランザクションプロセスとして動作します。これらはSystem.Transactions.TransactionScopeクラスに基づいており、カタログやカテゴリをデータベースから削除するためにSitecore.Commerce.Core.Commands.CommerceCommand.PerformTransaction()メソッドを使用します。

MachineSettingsSection.MaxTimeoutプロパティは、トランザクションがタイムアウトされるまでの最大許容時間を設定します。タイムアウトのデフォルト値は10分です。データベースから非常に多くのエンティティをパージすると、トランザクションはパージ操作が完了する前にタイムアウトする可能性があります。タイムアウトエラーを避けるために、MachineSettingsSection.MaxTimeoutプロパティの値を変更することを検討してください。パージ操作を実行する前にカタログからカテゴリを削除することもタイムアウトエラーの回避に役立ちます。

!注置き換えモードでカタログインポートリクエストを呼び出すと、バックグラウンドでPurgeCatalogsMinionミニオンもトリガーされます。これは置換される既存のカタログを削除するために必要です。大規模なカタログインポート操作中にMachineSettingsSection.MaxTimeoutプロパティの値を変更することで、タイムアウトエラーを避けることができます。

パージカテゴリーのミニオン

このPurgeCategoriesMinionは、データベースから削除されたカタログカテゴリを一掃するメンテナンスプロセスとして動作します。カテゴリがカタログから削除された場合、例えばBusiness ToolsユーザーインターフェースやPostmanのサンプルDelete Categoryリクエストを使って、それらは削除済みカテゴリのリストに載せられます。パージカテゴリミニオンはそのリスト("ListsToWatch": "PurgeCategories")を監視し、一定の間隔でリストされた削除済みカテゴリをデータベースから削除します。デフォルトではミニオンは5分ごとに実行されます。

!注Sitecore XC Business Toolsでは、削除されたカテゴリはPurge Categoriesのミニオンが実行して実質的にデータベースから削除されるまで検索結果に現れ続けます。

以下はPlugin.Minions.PolicySet-1.*.*.jsonファイルで定義されたデフォルトのPurgeCategoriesMinionポリシーの例です。

{ "$type": "Sitecore.Commerce.Core.MinionPolicy, Sitecore.Commerce.Core", "WakeupInterval": "`00

!注PostmanでRun Purge Categories Minionリクエストを実行して、削除されたカテゴリを強制的にデータベースから削除できます。

アーカイブエンティティのミニオン

このArchiveEntitiesMinionは、キャンセル済みまたは完了した注文、または遅延した注文仕訳記入など、適格性に基づいて 商務関連のエンティティをアーカイブ するメンテナンスプロセスとして動作します。

PlugIn.Minions.PolicySet-1.0.0.jsonファイルは、ArchiveEntitiesMinionミニオンの2つのインスタンスを定義しており、それぞれがCommerceエンティティタイプ(注文エンティティとジャーナルエントリエンティティ)のアーカイブを担当します。

サンプルミニオンポリシーセットファイルへのパスはwwwroot/data/Environments/PlugIn.Minions.PolicySet-1.0.0.jsonです。

!注エンティティアーカイブはデフォルトで無効化されており、エンティティの種類や環境ごとにエンティティの アーカイブポリシーを更新することで設定可能です。

!重要デフォルトでは、エンティティアーカイブミニオンは24時間ごとに実行されるように設定されています。このデフォルトの動作を変更する前に、以下の推奨事項とベストプラクティスを考慮してください。