UTIL_Email
Class · Group: Email
global inherited sharing class UTIL_EmailUtility class for validating and sending emails within the Salesforce platform. Includes a unicode-aware email validation pattern and a two-step deliverability detection mechanism.
Since: 1.0
Example:
Boolean valid = UTIL_Email.isValidEmailAddress('user@example.com');
UTIL_Email.sendEmail(new List<String>{'admin@example.com'}, 'Alert', 'System notification body', false, null);
UTIL_Email.DeliverabilityAccessLevel level = UTIL_Email.getEmailDeliverabilityAccessLevel();Properties
| Property | Description |
|---|---|
| global enum DeliverabilityAccessLevel | Enum representing the three possible email deliverability settings in a Salesforce org. |
Methods
| Method | Description |
|---|---|
| global static UTIL_Email.DeliverabilityAccessLevel getEmailDeliverabilityAccessLevel() | Determines the org's current email deliverability access level. |
| global static Boolean isNotValidEmailAddress(String address) | Convenience inverse of isValidEmailAddress(String). |
| global static Boolean isValidEmailAddress(String address) | Checks whether the supplied address matches the default email pattern. |
| global static void sendEmail(List<List<Messaging.EmailFileAttachment> fileAttachments) | Internal send method that assembles and dispatches a SingleEmailMessage. |
Method Details
getEmailDeliverabilityAccessLevel
global static UTIL_Email.DeliverabilityAccessLevel getEmailDeliverabilityAccessLevel()Determines the org's current email deliverability access level. First attempts a capacity reservation; if that throws, falls back to parsing the email-admin settings page to extract the selected option.
Returns: UTIL_Email.DeliverabilityAccessLevel - The detected DeliverabilityAccessLevel. Defaults to NO_ACCESS on failure.
Since: 1.0
isNotValidEmailAddress
global static Boolean isNotValidEmailAddress(String address)Convenience inverse of isValidEmailAddress(String) .
Parameters:
address(String) - The address to validate.
Returns: Boolean - True when the address is invalid.
Since: 1.0
isValidEmailAddress
global static Boolean isValidEmailAddress(String address)Checks whether the supplied address matches the default email pattern.
Parameters:
address(String) - The address to validate.
Returns: Boolean - True when the address is syntactically valid.
Since: 1.0
sendEmail
global static void sendEmail(List<String> toAddresses, String subject, String body, Boolean isHtml, List<Messaging.EmailFileAttachment> fileAttachments)Internal send method that assembles and dispatches a SingleEmailMessage.
Parameters:
toAddresses(List) - Recipient addresses. Exits silently when null or empty.subject(String) - Email subject.body(String) - Body content.isHtml(String) - True to set HTML body, false for plain text.fileAttachments(Boolean) - Optional file attachments.
Since: 1.0