Visualforce 開発者ガイド
jVisualforce メールテンプレートの作成
-
次のいずれかの操作を実行します。
- 公開テンプレートの編集権限がある場合は、[設定] から [クイック検索] ボックスに「メールテンプレート」と入力し、[Classic メールテンプレート] を選択します。
- 公開テンプレートを編集する権限がない場合は、個人設定に移動します。[クイック検索] ボックスに「テンプレート」と入力し、[メールテンプレート] または [私のテンプレート] の表示された方を選択します。
- [新規テンプレート] をクリックします。
-
[Visualforce] を選択し、[次へ] をクリックします。
Visualforce メールテンプレートを使用して一括メールを送信することはできません。
- テンプレートを保存するフォルダを選択します。
- テンプレートを使用できるようにするには、[有効] チェックボックスをオンにします。
- [メールテンプレート名] に名前を入力します。
- 必要に応じて、[テンプレートの一意の名前] を変更します。この一意の名前は、Lightning プラットフォーム API の使用時にコンポーネントを参照します。管理パッケージでは、この一意の名前により、パッケージのインストール時に名前が競合することを防ぎます。この名前は、アンダースコアと英数字のみを使用でき、組織内で一意にする必要があります。最初は文字であること、空白は使用しない、最後にアンダースコアを使用しない、2 つ続けてアンダースコアを使用しないという制約があります。[テンプレートの一意の名前] 項目を使用すると、管理パッケージで特定のコンポーネント名を変更できます。この変更は、登録者の組織に反映されます。
- 必要に応じて、[文字コード] ドロップダウンリストから別の文字セットを選択します。
- テンプレートの説明を入力します。テンプレートの名前と説明は、内部的にのみ使用されます。
- [メール件名] にテンプレートの件名を入力します。
- [受信者種別] ドロップダウンリストで、テンプレートから作成されたメールを受け取る受信者の種別を選択します。
- 必要に応じて、[関連先種別] ドロップダウンリストで、どのオブジェクトからテンプレートが差し込み項目データを取得するかを選択します。
- [保存] をクリックします
- [Salesforce Classic でのメールテンプレートの表示および編集] ページで、[テンプレートを編集] をクリックします。
- [テンプレートの編集] をクリックし、Visualforce メールテンプレートのマークアップテキストを入力します。
- このメールテンプレートで使用する Visualforce および API のバージョンを指定するには、[バージョン設定] をクリックします。AppExchange の管理パッケージをインストールしている場合は、このメールテンプレートで使用する各管理パッケージのバージョンも指定できます。通常、すべてのバージョンにデフォルト値を使用します。デフォルトでは、メールテンプレートは Visualforce、API、および各管理パッケージの最新のバージョンに関連付けられます。特定の動作を維持するには、Visualforce および API の古いバージョンを指定できます。最新のパッケージバージョンと異なるコンポーネントや機能にアクセスするために、管理パッケージの古いバージョンを指定できます。
- テンプレートの詳細を表示するには、[保存] をクリックします。テンプレートの編集を続行するには、[適用] をクリックします。テンプレートを保存するには、Visualforce マークアップが有効になっている必要があります。
次の例は、取引先責任者に関連付けられたすべてのケースを表示する Visualforce メールテンプレートの定義方法を示します。この例では、<apex:repeat> タグを使用して取引先責任者に関連するすべてのケースを反復処理し、テンプレートの本文に取り込みます。
このマークアップでは、次の点に留意してください。
- 属性 recipientType と relatedToType は、メールテンプレートのコントローラとして機能します。これらを使用して、他の標準コントローラで使用できるものと同じ差し込み項目にアクセスできます。recipientType 属性は、メールの受信者を表します。relatedToType 属性は、メールに関連付けるレコードを表します。
- <messaging:htmlEmailBody> コンポーネントには、Visualforce マークアップと HTML を両方とも含めることができます。<messaging:plainTextEmailBody> コンポーネントには、Visualforce マークアップとプレーンテキストのみを含めることができます。
- 受信者または関連オブジェクトの言語に基づいて Visualforce メールテンプレートを翻訳するには、<messaging:emailTemplate> タグの language 属性を使用します (有効な値は、「en-US」などの Salesforce でサポートされている言語キー)。言語属性は、メールテンプレートの recipientType および relatedToType 属性の差し込み項目を受け取ります。差し込み項目で使用するカスタム言語項目を作成します。メールテンプレートの翻訳には、トランスレーションワークベンチが必要です。この例では、差し込み項目を使用して、メールを受信する取引先責任者の language 属性を取得します。