チュートリアル: カスタム メッセージ テンプレートの作成

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

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

コンテンツ エディターでは、Email Experience Manager (EXM) のメール キャンペーンに使用できるカスタム メッセージ テンプレートを作成できます。これらのメッセージ テンプレートは、Sitecoreの通常のアイテム テンプレートとは異なります。カスタム メッセージ テンプレートを作成するには、ブランチ テンプレート、メッセージ テンプレート、レイアウト、およびビューを作成し、これらをバインドしてEXMで使用できるようにします。

メモ

このチュートリアルでは、HTMLの例を提供します。メッセージテンプレートの作成を開始する前に、最終的なカスタムテンプレートのレイアウトに使用するHTMLコードが必要です。カスタム テンプレートに含める内容については、「標準のEXMメール メッセージ テンプレート」を参照してください。

このチュートリアルでは、次の方法について説明します。

ブランチ テンプレートを作成する

カスタムメッセージテンプレートを作成するには、ブランチテンプレートが必要です。これらの1つは、既存のEXMメッセージ テンプレートに基づいて作成できます。カスタム メッセージ テンプレートは、ブランチ テンプレート定義アイテムと$nameアイテムで構成されるBranch dataテンプレートに基づいています。

既存のEXMメッセージ テンプレートからブランチ テンプレートを作成するには:

  1. コンテンツ エディタを開き、/sitecore/templates/Branches/System/Email/Messagesに移動します。 Optionsウィンドウで、「 New Branch」をクリックします。

    Folder tab showing the New Branch button to create a new branch.

  2. メール キャンペーンがABテスト可能であることを確認するには、開いたCreate a new branchダイアログ ボックスでSystem/Email/Messagesに移動し、AB Testable Messageをクリックして、Createをクリックします。

    The Create a new branch dialog box showing where to select the AB Testable Message.

  3. ブランチの名前を変更します。これを行うには、右クリックしてRenameを選択するか、F2キーを押します。次の例では、名前を付けています Simple Email.

  4. ブランチのContentタブで、Appearanceタブに移動し、サイズが180x249ピクセルの新しいサムネイルをアップロードします。サムネイルは、ユーザーがEXMで新しいメール キャンペーンを作成するときに、メッセージ テンプレートに使用されます。また、Contentタブで、Helpセクションまでスクロールし、Long Descriptionを追加します。長い説明は、ユーザーがテンプレートを使用して新しいメッセージを作成するときにサムネイルの下に表示されるテキストです。

    手記

    サムネイルと説明のオプションがContentタブに表示されない場合は、上部のナビゲーション バーのViewタブでStandard Fieldsチェック ボックスをオンにします。

  5. メッセージ・テンプレートをコンテンツ・レイアウトにバインドするには、$name ・アイテムの下にメッセージ・ルートを挿入する必要があります。 $nameアイテムを右クリックし、Insert、Insert from templateの順にクリックします。

  6. Insert from Templateダイアログボックスで /Templates/System/Email/Messages/ Inner Content/Message Rootに移動し、Item nameフィールドに名前(Message rootなど)を入力してInsertをクリックします。

  7. メッセージ ルートを $name アイテムに接続するには、$nameアイテムをクリックし、MessageセクションのBodyフィールドでドロップダウン矢印をクリックして、メッセージ ルートに移動します。

新しいブランチテンプレートは次のようになります。

Content Editor Templates node showing your branch template, including a $name, message root, and content file.

メッセージデータテンプレートの作成

新しいテンプレートを作成して、デフォルトのメッセージコンテンツとして使用する標準値 (ヘッダーとフッターのテキストなど) を指定します。

メッセージ・データ・テンプレートを作成するには、次のようにします。

  1. コンテンツ エディターで、sitecore/Templates/System/Email/Messages/Inner Contentに移動します。

  2. Folder TabのOptionsで、New Templateをクリックします。開いたSelect Nameウィンドウで、テンプレートに名前を付けて、「 Next」をクリックします。

    The Select name dialog box where you can enter a name for your template.

  3. 新しいテンプレートの場合は、BuilderタブのAdd a new sectionフィールドに、関連するデータ テンプレート フィールド (ヘッダー テキストやフッター テキストなど) を追加します。

    The builder tab showing where to add the relevant template fields.

  4. 変更を保存します。

  5. ツリー ナビゲーションで、カスタム テンプレートのMessage Rootに移動し、Content子アイテムを作成します。これは、メールメッセージにコンテンツを追加できるようになったことを意味します。

レイアウトとビューの作成

レイアウトの場合、SitecoreはASP.NET MVCフレームワークを使用します。詳細については、「 MVCとレンダリング」を参照してください。

MVCを使用してメッセージテンプレートのレイアウトを作成するには:

  1. コンピュータで \sitecore modules\Web\EXM\layoutsに移動し、次の内容の <Your custom template>.cshtmlファイルを作成します。

    RequestResponse
    @using Sitecore.Mvc 
@using Sitecore.Mvc.Presentation   

<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> 
<html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"> 
<head>
@Html.Sitecore().Placeholder("msg-html-title")  
</head>  

<body class="em_body" style="margin: 0px auto; padding: 0px;" bgcolor="#ffffff">
@Html.Sitecore().Placeholder("msg-html-body") 
</body> 
</html> 

  2. Sitecoreのコンテンツ エディターで、/sitecore/Layout/Layouts/System/Email/ に移動します。 FolderタブのOptions 、Layoutに、レイアウトの新しい名前 ( Simple Email Layoutなど) を入力し、OKをクリックします。

    The Folder tab showing where to enter a name for your layout.

  3. コンテンツ ツリーで新しいレイアウトを選択し、ContentタブのDataセクションでPathフィールドをクリックして、レイアウト ファイルが保存されている場所 ( /sitecore modules/Web/EXM/Layouts/SimpleEmailLayout.cshtmlなど) に移動します。

  4. コンピューターで \Viewsに移動し、次の内容で別の <Your custom template>.cshtmlファイルを作成します。

    RequestResponse
    @using Sitecore.Mvc.Presentation
@using Sitecore.Mvc
@model RenderingModel

<h1>@Html.Sitecore().Field("Header", Model.Item)</h1>

@Html.Sitecore().Field("Body", Model.Item)

  5. Sitecoreのコンテンツ エディターで、/sitecore/layout/Renderings/System/Emailに移動します。 FolderタブのOptionsで、View renderingをクリックして、テンプレートの新しいビューレンダリングを作成します。 Pathを ~/Views/<Your custom template>.cshtmlに設定します。

レイアウトとメッセージテンプレートをバインドする

レイアウトとビューをメッセージテンプレートにバインドするには:

  1. 作成したブランチ テンプレートのメッセージ ルート ( /sitecore/Templates/Branches/System/Email/Messages/<YourCustomTemplate>/Name/Message rootなど) に移動します。

  2. PresentationタブのLayoutグループで、Detailsをクリックします。

  3. Layout Detailsダイアログボックスで、DefaultデバイスのEditをクリックします。

    The Layout Details dialog box showing where to edit the settings for Default device.

  4. Device Editorダイアログ ボックスのLayoutタブで、ドロップダウン メニューをクリックし、作成したレイアウトに移動します。この例では、Simple Email Layoutを作成しました。

    The Device Editor showing where to select the layout you created in the drop-down menu on the Layout tab.

  5. ControlsでAddをクリックし、Renderings、System、Emailに移動します。カスタムテンプレートのメニューを展開します。MVCコード スニペットのコンテンツをプレースホルダーにマップする必要があります。少なくとも、次のコントロールを追加してマップします。

    • Set Page Title - Add to Placeholderで、これをmsg-html-titleにマッピングします。

    • <YourCustomTeplate> Content - Add to Placeholderで、これをmsg-html-bodyにマッピングします。 Data Sourceの下に、カスタムテンプレートのメッセージルートのパス ( /sitecore/Templates/Branches/System/Email/Messages/<YourCustomTemplate>/Name/Message root/<Your Content>) を書き込みます。

    The Device Editor dialog box showing how to map the controls to your MVC code.

  6. 「 Control Properties」の下の「 Caching 」セクションで、次のチェックボックスをオンにします。

    • Cacheable

    • Vary by Data

    • Vary by Parameters

    • Vary by Query String

  7. 「 OK」をクリックします。

テンプレートをEXMで利用可能にする

EXMでユーザーがテンプレートを利用できるようにするには、次の手順を実行します。

  1. コンテンツ エディターで、sitecore/Content/Email/Message Typesに移動します。

  2. 新しいメッセージ テンプレートを追加するメッセージ タイプを展開し、Defaultアイテムをクリックします。

  3. ConfigureタブのInsert Optionグループで、Assignをクリックします。

  4. Insert Optionsダイアログボックスで、メッセージテンプレート(/templates/Branches/System/Email/Messages/Simple Emailなど)に移動し、カスタムテンプレートを見つけて、Selectedペインに追加します。

  5. OKをクリックして、変更を保存します。

EXMでは、ユーザーが新しいメッセージを作成するときに、テンプレートのリストからメッセージ テンプレートを選択できるようになりました。ブランチテンプレートの作成時にサムネイルをアップロードし、長い説明を追加した場合、これらはテンプレートとともに表示されます。次の例では、Simple Emailテンプレートを作成しました。

A visual example of the templates, including your new custom template.

何かフィードバックはありますか?

この記事を改善するための提案がある場合は、