Commerce Engineの変更に関するベストプラクティス

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

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

ほとんどのCommerce実装では、Commerce Engineのカスタマイズは新しいプラグインアセンブリの作成によって行われ、その後Commerce Engineが参照します。

ほとんどの開発シナリオでは、Sitecore.Commerce.Engineプロジェクトの修正は通常以下の点に限定されます。

Sitecore内の参考文献。Commerce.Engineプロジェクト

新しいプラグインを作成したり、既存のプラグインをカスタマイズしたりする際は、Sitecore.Commerce.Engineプロジェクトへの参照を追加しなければなりません。 Sitecore.Commerce.Engineプロジェクトのコンポーネントに参照を追加する際は、ベストプラクティスに従ってください:

  • 公式 Sitecore NuGetフィードを使ってSitecoreプラグインへの参照を追加しましょう。
  • 可能な限りNuGet経由でサードパーティアセンブリへの参照を追加してください。
  • プロジェクト参照を使って、自分のソリューション内でカスタムプラグインへの参照を追加してください。

グローバル環境の設定に関する考慮事項

global.jsonファイルはブートストラップ中にグローバル環境の設定に使用され、Commerce Engineの起動と実行に必要な最低限の設定を含みます。

Global.jsonファイルの変更は避けてください。ただし、"policies"コレクションセクションをパラメータ値を変更したり、新しいグローバル構成ポリシーを追加したりする以外は避けてください。

カスタムエンティティ作成のベストプラクティス

Sitecore XC 9.2以降、商取引エンティティ(CommerceEntity)はGUID UniqueIdとEntityId文字列を持つようになりました。カスタムコマースエンティティを作成する際、SitecoreはGUIDをEntityId値の一部として含めないことを推奨します。なぜなら、ユニークなIDに曖昧さが生じ、エンティティ検索時にエラーが生じるNot found可能性があるからです。

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