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) かを指定します。

例

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

署名

public static List<Messaging.RenderEmailTemplateBodyResult> renderEmailTemplate(String whoId, String whatId, List<String> bodies)

パラメータ

whoId

型: String

データベース内のオブジェクト (通常は取引先責任者、リード、またはユーザ) の識別子。そのオブジェクトのデータベースレコードが参照され、差し込み項目処理で使用されます。

whatId

型: String

取引先や商談など、データベース内のオブジェクトを識別します。そのオブジェクトのレコードが参照され、差し込み項目処理で使用されます。

bodies

型: List<String>

差し込み項目の参照のために調べられる文字列の配列。whoId または whatId で参照されるオブジェクトからの対応するデータで、差し込み項目の参照が置き換えられます。

戻り値

型: List<Messaging.RenderEmailTemplateBodyResult>

使用方法

このメソッドは、テキストブロックを動的に作成し、データベースからのデータで強化する場合に使用できます。表示されたテキストブロックは、メールの作成と送信や、別のデータベースレコードのテキスト値の更新などに使用できます。

署名

public static Messaging.SingleEmailMessage renderStoredEmailTemplate(String templateId, String whoId, String whatId)

パラメータ

templateId

型: String

データベースに存在するメールテンプレート。テキスト、HTML、カスタム、および Visualforce テンプレートなどです。

whoId

型: String

データベース内のオブジェクト (通常は取引先責任者、リード、またはユーザ) の識別子。そのオブジェクトのデータベースレコードが参照され、差し込み項目処理で使用されます。

whatId

型: String

取引先や商談など、データベース内のオブジェクトを識別します。そのオブジェクトのレコードが参照され、差し込み項目処理で使用されます。

戻り値

型: Messaging.SingleEmailMessage