ウォークスルー

メッセージ内容フィールドの作成または変更

メッセージ内容フィールドの作成または変更:

1. Sitecore Launchpadで「 Content Editor」をクリックしてください。

2. sitecore/Templates/Feature/Commerce Experience Accelerator/Emailsに行って。

3. Cart、Order、Products、またはSharedフォルダを展開します。

   

4. メールのコンポーネント(ヘッダー、行、合計など)を選択します。

5. ビルダータブで、テンプレートのフィールドラベルやタイプを追加、修正、削除できます。

6. 変更を保存するには「 保存 」をクリックしてください。

メッセージレンダリングを修正する

1. コンテンツエディターでsitecore/Layout/Renderings/Feature/Commerce Experience Accelerator/Commerce Emailsフォルダに移動します。
2. Email Cart、カタログ、Order、またはSharedフォルダを展開してください。
3. メールコンポーネント(カートの列、カート合計など)を選択してください。
4. コンテンツタブのデータセクションで、必要に応じてコントローラーの操作を変更します。
5. 変更を保存するには「 保存 」をクリックしてください。

メールメッセージでレンダリングするためのCommerceデータを取得する

CommerceのメールメッセージがストアフロントからCommerceデータを取得するためには、以下のコントローラーコードを追加する必要があります。

public ActionResult OrderHeader() { EmailOrderModel model = null; string renderingViewPath = string.Empty; var visitorContext = Foundation.Connect.VisitorContext.Current;

// This code sets up the context for the Commerce site and user if the Sitecore and contact // information are present based on the query parameters.

using (var commerceSiteContext = new SetupCommerceSiteContext(visitorContext)) { var linkRepository = ServiceLocator.ServiceProvider.GetService(); model = linkRepository.GetOrder(commerceSiteContext);

// This code calls the base GetRenderingView() controller method, which supports the SXA view // override feature.

renderingViewPath = GetRenderingView("EmailOrderHeader"); } return View(renderingViewPath, model); }

!注SXAビューの詳細については、「 サイトごとのHTMLレンダリングカスタマイズ」をご覧ください。

リポジトリメソッドコードは、SetupCommerceSiteContextコンテキストスイッチ内のコントローラーから呼び出しられ、提供されたクエリパラメータに基づいてSitecoreサイトと現在ログイン中のユーザーを設定します。

public virtual EmailOrderModel GetOrder(SetupCommerceSiteContext commerceSiteContext) { var orderId = string.Empty;

// This code looks for the order_id query parameter and, if specified, retrieves the model for // a specific order.

if (Sitecore.Modules.EmailCampaign.Core.ExmContext.QueryString != null) { orderId = Sitecore.Modules.EmailCampaign.Core.ExmContext.QueryString"order_id"; } var model = ModelProvider.GetModel(); ; var visitorContext = Foundation.Connect.VisitorContext.Current;

// This code verifies if the user context was switched to a valid user.  If the context was // switched, the order is retrieved using the Storefront foundation code.

if (commerceSiteContext.HasSwitchedUsers) { var storefrontContext = ServiceLocator.ServiceProvider.GetService(); var customerId = visitorContext.CustomerId; Engine.Connect.Entities.CommerceOrder order = null;

// This code caches the returned order on the site context items collection. To avoid // retrieving the same order multiple times when an email has multiple renderings using the // same model (called from within the same HttpContext), the order is retrieved once and // cached so all other calls retrieve the order from the cache.  The site context item // collection is emptied at the end of the HttpRequest.

if (SiteContext.ItemsOrderModelKey != null) { order = (Engine.Connect.Entities.CommerceOrder)SiteContext.ItemsOrderModelKey; } else { var orderManager = ServiceLocator.ServiceProvider.GetService(); var response = orderManager.GetOrderDetails(storefrontContext.CurrentStorefront, visitorContext, orderId); order = response.Result as Engine.Connect.Entities.CommerceOrder; SiteContext.ItemsOrderModelKey = order; } model.Init(order); } else { model.InitMockData(); } return model; }

cshtmlビューをレンダリングするには、以下のメールオーダーヘッダービューが必要です。

@using System.Web.Mvc.Ajax @using System.Web.Mvc.Html @using Sitecore.XA.Foundation.SitecoreExtensions.Extensions @using Sitecore.Commerce.XA.Foundation.Common.ExtensionMethods @using Sitecore.Mvc @using Sitecore.Commerce.XA.Feature.Emails @using Sitecore.Commerce.XA.Feature.Emails.Models @using System.Linq @model EmailOrderModel @{ var orderInformationLabel = Html.Sitecore().Field(Constants.Templates.EmailOrderHeader.FieldNames.OrderInformationLabel, Html.Sitecore().CurrentItem);

// This code retrieves the labels from the item data source. These are the values retrieved // from the template.

var orderDateLabel = Html.Sitecore().Field(Constants.Templates.EmailOrderHeader.FieldNames.OrderDateLabel, Html.Sitecore().CurrentItem); var orderIdLabel = Html.Sitecore().Field(Constants.Templates.EmailOrderHeader.FieldNames.OrderIdLabel, Html.Sitecore().CurrentItem); var orderStatusLabel = Html.Sitecore().Field(Constants.Templates.EmailOrderHeader.FieldNames.OrderStatusLabel, Html.Sitecore().CurrentItem); var deliveryAddressLabel = Html.Sitecore().Field(Constants.Templates.EmailOrderHeader.FieldNames.OrderDeliveryAddressLabel, Html.Sitecore().CurrentItem); var billingAddressLabel = Html.Sitecore().Field(Constants.Templates.EmailOrderHeader.FieldNames.OrderBillingAddressLabel, Html.Sitecore().CurrentItem); }

// This code specifies the CSS for this view.  Each view must define its own embedded // CSS unlike standard web pages. The rest of the view (.cshtml file) retrieves the data from // the EmailOrderModel.

メールブランチテンプレートのレンダリングを作成します

各メールタイプには分岐テンプレートがあります。新たに注文されたメールには以下の分岐があります:

以下の手順は、既存のオーダーヘッダーがブランチテンプレートに新たに配置されたブランチに追加された方法を説明します。この手順はどのブランチテンプレートでも同じです。

新しいレンダリングを「新しい順序の配置」分岐テンプレートに追加するには:

1. コンテンツエディターで、sitecore/テンプレート/branch/feature/Commerce Experience Accelerator/Commerce Emails/新規注文の順に行ってください。

2. メッセージルートを右クリックし、「Insert」→「Insert」→「Insert from Template」をクリックします。

3. テンプレート/機能/コマース体験アクセラレーター/メール/注文/メールオーダーヘッダーに行き、アイテム名欄にメールオーダーヘッダーを入力して挿入をクリックします。

4. コンテンツツリーで「新しい注文された」ブランチの 「メッセージルート 」をクリックしてください。

5. リボンの上で「 プレゼンテーション 」タブをクリックし、「 レイアウト 」セクションで 「詳細」をクリックしてください。

6. デフォルトセクションで編集をクリックし、デバイスエディターのダイアログボックスでコントロールタブをクリックします。

7. 追加をクリックして、レンダリング/フィーチャー/コマース体験アクセラレーター/コマースメール/メールオーダー/メールオーダーヘッダーに行き、「選択」をクリックします。

   

8. メールオーダーヘッダーを選択し、編集をクリックします。

9. コントロールプロパティのダイアログボックスの**「一般**」セクションで、「データソースの下の**ブラウズ」**をクリックし、メッセージのルートへ移動します。メール注文ヘッダー項目を選択し、OKをクリックします。

10. コントロールプロパティのダイアログボックスでOKをクリックし、デバイスエディターのダイアログボックスでOKをクリックします。

    メールオーダーヘッダーコントローラーとそのデータソースはメールメッセージの一部となります。新たに注文したメールメッセージが作成されると、レンダリングも含まれます。