カスタムフルフィルメントオプションを作成する
このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。
Sitecore XCフルフィルメントプラグインは、Commerce Control Panelに表示されるデフォルトのフルフィルメントオプションをサポートしています。これらのフルフィルメントオプションは、Commerce Connectで定義されたデフォルトのShippingOptionType値にマッピングされており、以下の表にまとめられています。
フルフィルメントオプション
ShippingOptionType(配送オプションタイプ)
住所に配達
ShipToAddress
個別配送 - 発送を分割する
ラインシッピングオプション
デジタル配信
エレクトロニックデリバリー
!注「店舗から受け取り」というフルフィルメントオプションタイプは現在サポートされていません。
Sitecore XC実装の中にはカスタムフルフィルメントオプションの要件がある場合があります。このトピックでは、特定のフルフィルメントビジネス要件を満たすためにコマースエンジンを拡張するカスタムフルフィルメントプラグインの作成方法についての指針を提供します。
カスタムフルフィルメントオプションを含めるためにCommerce Engineを拡張し、Commerce Control Panelに追加してストアフロントで利用可能にする必要があります。
Commerce Engineを拡張してカスタムフルフィルメントオプションを使おう
カスタムフルフィルメントオプションをコマースコントロールパネルに追加し、データをCommerce Engineデータベースと同期したら、Commerce Engine Fulfillmentプラグインを拡張して新しいカスタムフルフィルメントオプションを処理できるようにする必要があります。
Commerce Engine Fulfillmentプラグインを拡張するには:
-
カスタムフルフィルメントオプション用に新しいクラス(例: MyCustomFulfillmentComponent.cs)を作成し、適切なプロパティ(例
、StoreAddress)を備えていることを確認してください。また、JsonConverter属性を含め、次のステップで作成するJsonConverterを指定する必要があります。
JsonConverter(typeof(MyCustomFulfillmentComponentConverter)) public class MyCustomFulfillmentComponent : FulfillmentComponent { … }
-
新しいカスタムフルフィルメントコンポーネント用のJSONコンバーターを作成します(Sitecore XC FulfillmentCOmponentConverter.csファイルをガイドとして使えます)。
public class MyCustomFulfillmentComponentConverter : JsonConverter { … public override object ReadJson(JsonReader reader, Type objectType, object existingValue, JsonSerializer serializer) { if (reader.TokenType == JsonToken.Null) { return null; }
var jObject = JObject.Load(reader); var type = (string)jObject.Property("@odata.type"); type = Regex.Replace(type, "#", string.Empty); FulfillmentComponent target = null; if (type.Equals("MyNamespace.MyCustomFulfillmentComponent", StringComparison.OrdinalIgnoreCase)) { target = new PhysicalFulfillmentComponent(); }
var jObjectReader = jObject.CreateReader(); jObjectReader.Culture = reader.Culture; jObjectReader.DateParseHandling = reader.DateParseHandling; jObjectReader.DateTimeZoneHandling = reader.DateTimeZoneHandling; jObjectReader.FloatParseHandling = reader.FloatParseHandling; serializer.Populate(jObjectReader, target);
return target; } … }
-
フルフィルメントを扱うパイプライン(例えば、カートやカートラインへのフルフィルメント追加)にパイプラインブロックを追加し、パイプラインが新しいカスタムフルフィルメントオプションを処理できるようにしましょう。
カスタム配送オプションのためにCE Connectを拡張しましょう
また、新しいカスタム履行オプションに対応するためにCommerce Engine Connectを拡張する必要があります。
CE Connectを新しいカスタムフルフィルメントオプションに対応するために拡張するには:
- AddShippingInfoToCartパイプラインプロセッサを拡張し、新しいカスタムフルフィルメントオプションを取り入れましょう。
- TranslateCartToEntityパイプラインプロセッサを拡張し、新しいカスタムフルフィルメントオプションを取り入れましょう。
- GetShippingOptionsパイプラインプロセッサを拡張し、新しいカスタムフルフィルメントオプションを取り入れましょう。
- 拡張 GetShippingMethods pipeline processor to include the new custom fulfillment option.
!注新しいフルフィルメントオプションを反映するように、ストアフロントサイトのユーザーインターフェースコードを変更する必要があります。
カスタムフルフィルメントオプションをCommerceコントロールパネルに追加してください
Commerce Control Panelは、Commerce Engine、ビジネスツール、ストアフロントのCommerce設定を設定するための、Sitecore XPツールスイートの中心的な場所です。
カスタムフルフィルメントオプションをコマースコントロールパネルに追加するには、以下の手順に従ってください:
-
Sitecore Launchpadから コンテンツエディターを開きます。
-
左側の パネルにあるsitecore/Commerce/Commerceコントロールパネル/共有設定/フルフィルメントオプションタイプ フォルダにアクセスし、メインペインの「 Fulfillment Option Type 」をクリックしてください。
-
ダイアログウィンドウで新しいフルフィルメントオプションタイプの名前(例
Custom Fulfillment)を入力し、「 **OK」**をクリックします。 -
フルフィルメントオプションタイプパネルで、フルフィルメントオプションタイプの名前とID(例
)を指定し、変更を保存します。 -
sitecore/Commerce/Commerce Control Panel/Shared Settings/Fulfillment Optionsフォルダに行き、メインペインの「Fulfillment Option」をクリックします。
-
フルフィルメントオプションのパネルで、先に作成したフルフィルメントオプションタイプを選択し、説明を追加してから変更を保存してください。
-
sitecore/Commerce/Commerce Control Panel/Storefront設定/Commerce Engine Default Storefront/Fulfillment Configurationフォルダに移動します。
-
カスタムフルフィルメントオプションを選択し、> アイコンをクリックして「 選択済み 」ペインに移動し、変更を保存します。
-
変更をCommerce Engineにプッシュするには、「 コンテンツ項目の同期 」トピックで説明されているように、SitecoreデータベースとCommerce Engineのデータベース間でコンテンツ項目を同期させます。 Sync content path APIサンプルを使って、コンテンツツリー全体を同期してください。