Apex 開発者ガイド
jMessaging クラス
名前空間
メッセージメソッド
Messaging のメソッドは次のとおりです。すべてインスタンスメソッドです。
reserveMassEmailCapacity(amountReserved)
署名
public Void reserveMassEmailCapacity(Integer amountReserved)
パラメータ
- amountReserved
- 型: Integer
戻り値
型: Void
使用方法
トランザクションの結果として送信するメールの数を事前に把握している場合は、このメソッドをコールできます。このトランザクションで組織の 1 日あたりのメール送信量の制限を超える場合、このメソッドを使用すると、System.HandledException: The daily limit for the org would be exceeded by this request. というエラーになります。組織に API の送信または一括メール送信の権限がない場合、このメソッドを使用すると、System.NoAccessException: The organization is not permitted to send email. というエラーが発生します。
reserveSingleEmailCapacity(amountReserved)
署名
public Void reserveSingleEmailCapacity(Integer amountReserved)
パラメータ
- amountReserved
- 型: Integer
戻り値
型: Void
使用方法
トランザクションの結果として送信するメールの数を事前に把握している場合は、このメソッドをコールできます。このトランザクションで組織の 1 日あたりのメール送信量の制限を超える場合、このメソッドを使用すると、System.HandledException: The daily limit for the org would be exceeded by this request. というエラーになります。組織に API の送信または一括メール送信の権限がない場合、このメソッドを使用すると、System.NoAccessException: The organization is not permitted to send email. というエラーが発生します。
sendEmail(emails, allOrNothing)
署名
public Messaging.SendEmailResult[] sendEmail(Messaging.Email[] emails, Boolean allOrNothing)
パラメータ
- emails
- 型: Messaging.Email[]
- allOrNothing
- 型: Boolean
-
(省略可能) opt_allOrNone パラメータでは、任意のメッセージがエラーで失敗した場合、sendEmail でその他すべてのメッセージの配信を行わない (true) か、エラーのないメッセージの配信を行う (false) かを指定します。デフォルトは、true です。
戻り値
sendEmailMessage(emailMessageIds, allOrNothing)
署名
public Messaging.SendEmailResult[] sendEmailMessage(List <ID> emailMessageIds, Boolean allOrNothing)
戻り値
使用方法
sendEmailMessage メソッドは、opt_allOrNone パラメータ (省略可能) は常に false であるとみなし、設定した値を無視します。��の省略可能なパラメータでは、任意のメッセージがエラーで失敗した場合、sendEmailMessage でその他すべてのメッセージの配信を行わない (true) か、エラーのないメッセージの配信を行う (false) かを指定します。
例
この例では、ドラフトメールメッセージを送信する方法を示します。ケースとそのケースに関連付けられた新しいメールメッセージを作成します。次に、ドラフトメールメッセージを送信し、結果を確認します。この例を実行する前に、メールアドレスを有効なアドレスに置き換えていることを確認してください。
1Case c = new Case();
2insert c;
3
4EmailMessage e = new EmailMessage();
5e.parentid = c.id;
6// Set to draft status.
7// This status is required
8// for sendEmailMessage().
9e.Status = '5';
10e.TextBody =
11 'Sample email message.';
12e.Subject = 'Apex sample';
13e.ToAddress = 'customer@email.com';
14insert e;
15
16List<Messaging.SendEmailResult>
17 results =
18 Messaging.sendEmailMessage(new ID[]
19 { e.id });
20
21System.assertEquals(1, results.size());
22System.assertEquals(true,
23 results[0].success);renderEmailTemplate(whoId, whatId, bodies)
署名
public static List<Messaging.RenderEmailTemplateBodyResult> renderEmailTemplate(String whoId, String whatId, List<String> bodies)
パラメータ
戻り値
型: List<Messaging.RenderEmailTemplateBodyResult>
使用方法
このメソッドは、テキストブロックを動的に作成し、データベースからのデータで強化する場合に使用できます。表示されたテキストブロックは、メールの作成と送信や、別のデータベースレコードのテキスト値の更新などに使用できます。