この文章は Salesforce 機械翻訳システムを使用して翻訳されました。詳細はこちらをご参照ください。
英語に切り替える

Force.com Apex コード開発者ガイド

Clouds with binary code floating aboveCloud with binary code floating above

No Results

Search Tips:

  • Please consider misspellings
  • Try different search keywords
PDF

Messaging クラス

単一メール送信または一括メール送信に使用されるメッセージメソッドが含まれます。

名前空間

System

メッセージメソッド

Messaging のメソッドは次のとおりです。すべてインスタンスメソッドです。

reserveMassEmailCapacity(Integer)

現在のトランザクションがコミットされた後に、指定数のメールアドレスに一括メール送信するためのメール容量を確保します。

署名

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(Integer)

現在のトランザクションがコミットされた後に、指定数のメールアドレスに単一メール送信するためのメール容量を確保します。

署名

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(Messaging.Email[], Boolean)

SingleEmailMessage または MassEmailMessage のいずれかを使用してインスタンス化するメールオブジェクトのリストを送信し、SendEmailResult オブジェクトのリストを返します。

署名

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

パラメータ

emails
型: Messaging.Email[]
allOrNothing
型: Boolean

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

戻り値

型: Messaging.SendEmailResult[]

sendEmailMessage(List<ID>, Boolean)

指定したメールメッセージ ID で定義されているドラフトメールメッセージを最大 10 件送信し、SendEmailResult オブジェクトのリストを返します。

署名

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

パラメータ

emailMessageIds
型: List<ID>
allOrNothing
型: Boolean

戻り値

型: Messaging.SendEmailResult[]

使用方法

sendEmailMessage メソッドは、opt_allOrNone パラメータ (省略可能) は常に false であるとみなし、設定した値を無視します。この省略可能なパラメータでは、任意のメッセージがエラーで失敗した場合、sendEmailMessage でその他すべてのメッセージの配信を行わない (true) か、エラーのないメッセージの配信を行う (false) かを指定します。

例

この例では、ドラフトメールメッセージを送信する方法を示します。ケースとそのケースに関連付けられた新しいメールメッセージを作成します。次に、ドラフトメールメッセージを送信し、結果を確認します。この例を実行する前に、メールアドレスを有効なアドレスに置き換えていることを確認してください。

1swfobject.registerObject("clippy.send_email_message_example", "9");Case 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);
24