Messaging クラス

署名

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. というエラーが発生します。

署名

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. というエラーが発生します。

署名

public Messaging.SendEmailResult[] sendEmail(Messaging.Email[] emails, Boolean allOrNothing)

パラメータ

emails

型: Messaging.Email[]

allOrNothing

型: Boolean

(省略可能) opt_allOrNone パラメータでは、任意のメッセージがエラーで失敗した場合、sendEmail でその他すべてのメッセージの配信を行わない (true) か、エラーのないメッセージの配信を行う (false) かを指定します。デフォルトは、true です。

戻り値

型: Messaging.SendEmailResult[]

署名

public Messaging.SendEmailResult[] sendEmailMessage(List <ID> emailMessageIds, Boolean allOrNothing)

パラメータ

emailMessageIds

型: List<ID>

allOrNothing

型: Boolean

戻り値

型: Messaging.SendEmailResult[]

使用方法

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);