UTIL_BulkUpdates

Class · Group: Bulk DML

global inherited sharing class UTIL_BulkUpdates

Utility methods used to initialize adaptive async jobs to update fields on multiple objects. Provides methods for bulk updating Salesforce records, such as invalidating email fields, updating ownership, and deactivating users. Operations are performed using adaptive async processing which automatically selects between Queueable and Batch execution based on data volume and governor limits. All entry points inherit the flag-driven default AccessLevel resolved by DML_SharingProxy.defaultAccessLevel() — under the secure-by-default posture this is USER_MODE, so the invoking user must have CRUD and FLS on the target object and fields for the bulk update to succeed. This is deliberate: UTIL_BulkUpdates is global, and silently elevating to SYSTEM_MODE would let a low-privilege subscriber Apex caller mutate records and fields they have no native right to edit. Integrations that genuinely need admin-mandate semantics should construct a PROC_UpdateFields directly with DTO_Parameters.accessLevel = AccessLevel.SYSTEM_MODE behind a caller-side permission check; the framework declines to make that elevation implicit.

Example

UTIL_BulkUpdates.invalidateEmailFields(Contact.Email);
UTIL_BulkUpdates.updateOwner('Opportunity', 'Sales Rep', 'admin@example.com');
UTIL_BulkUpdates.deactivateUsers(new Set<String>{'Chatter Free User'}, 365);

See Also: PROC_UpdateFields

---

Methods

Method	Description
global static void deactivateUsers(Set<String> profileNames, Integer minimumDaysInactive)	Deactivates users based on their profile names and the number of days since their last login or creation.
global static void deactivateUsers(Set<String> profileNames, Integer minimumDaysInactive, Boolean isAllOrNothing)	Deactivates users based on their profile names and last login or creation date, with transaction control.
global static void deactivateUsers(Set<String> profileNames, Integer minimumDaysInactive, Integer recordsPerBatch, Boolean isAllOrNothing)	Deactivates users based on their profile names and last login or creation date, with custom batch size and transaction control.
global static void invalidateEmailFields(SObjectField emailFieldToInvalidate)	Invalidates all valid email addresses for the specified email field.
global static void invalidateEmailFields(SObjectField emailFieldToInvalidate, Integer recordsPerBatch)	Invalidates all valid email addresses for the specified email field, with a custom batch size.
global static void invalidateEmailFields(SObjectField emailFieldToInvalidate, Integer recordsPerBatch, Boolean isAllOrNothing)	Invalidates all valid email addresses for the specified email field, with batch size and transaction control.
global static void invalidateEmailFields(String sObjectName, String fieldApiName)	Invalidates all valid email addresses for the specified field in a Salesforce object.
global static void invalidateEmailFields(String sObjectName, String fieldApiName, Boolean isAllOrNothing)	Invalidates all valid email addresses for the specified field in a Salesforce object, with transaction control.
global static void invalidateEmailFields(String sObjectName, String fieldApiName, Integer recordsPerBatch, Boolean isAllOrNothing)	Invalidates all valid email addresses for the specified field in a Salesforce object, with custom batch size and transaction control.
global static void updateField(String sObjectName, String fieldApiName, Object fieldValue, QRY_Condition.Evaluable searchConditions, Integer recordsPerBatch, Boolean isAllOrNothing)	Updates a specific field on records in a Salesforce object based on the given search conditions.
global static void updateOwner(String sObjectName, String existingOwnerProfileName, String newOwnerUsername)	Updates the ownership of records based on the existing owner profile name and new owner username.
global static void updateOwner(String sObjectName, String existingOwnerProfileName, String newOwnerUsername, Integer recordsPerBatch, Boolean isAllOrNothing)	Updates the ownership of records based on the current owner profile, new owner username, batch size, and transaction control.

deactivateUsers

global static void deactivateUsers(Set<String> profileNames, Integer minimumDaysInactive)

Deactivates users based on their profile names and the number of days since their last login or creation. Uses the maximum batch size for processing.

Parameters

Parameter	Type	Description
profileNames	Set	The profile names of the users to deactivate.
minimumDaysInactive	String	The minimum number of days since their last login or creation.

Example

Set<String> profiles = new Set<String>{'Sales Rep', 'Support Rep'};
UTIL_BulkUpdates.deactivateUsers(profiles, 365);

global static void deactivateUsers(Set<String> profileNames, Integer minimumDaysInactive, Boolean isAllOrNothing)

Deactivates users based on their profile names and last login or creation date, with transaction control.

Parameters

Parameter	Type	Description
profileNames	Set	The profile names of the users to deactivate.
minimumDaysInactive	String	The minimum number of days since their last login or creation.
isAllOrNothing	Integer	Whether to abort the operation if any record fails.

Example

Set<String> profiles = new Set<String>{'Support Rep'};
UTIL_BulkUpdates.deactivateUsers(profiles, 180, true);

global static void deactivateUsers(Set<String> profileNames, Integer minimumDaysInactive, Integer recordsPerBatch, Boolean isAllOrNothing)

Deactivates users based on their profile names and last login or creation date, with custom batch size and transaction control.

Parameters

Parameter	Type	Description
profileNames	Set	The profile names of the users to deactivate.
minimumDaysInactive	String	The minimum number of days since their last login or creation.
recordsPerBatch	Integer	The number of records to process in each batch.
isAllOrNothing	Integer	Whether to abort the operation if any record fails.

Example

Set<String> profiles = new Set<String>{'Sales Rep'};
UTIL_BulkUpdates.deactivateUsers(profiles, 90, 200, false);

invalidateEmailFields

global static void invalidateEmailFields(SObjectField emailFieldToInvalidate)

Invalidates all valid email addresses for the specified email field. Uses the maximum batch size for efficient processing.

Parameters

Parameter	Type	Description
emailFieldToInvalidate	SObjectField	The email field to query and invalidate in records.

Example

SObjectField emailField = Account.Email;
UTIL_BulkUpdates.invalidateEmailFields(emailField);

global static void invalidateEmailFields(SObjectField emailFieldToInvalidate, Integer recordsPerBatch)

Invalidates all valid email addresses for the specified email field, with a custom batch size.

Parameters

Parameter	Type	Description
emailFieldToInvalidate	SObjectField	The email field to query and invalidate.
recordsPerBatch	Integer	The number of records to process in each batch.

Example

SObjectField emailField = Contact.Email;
UTIL_BulkUpdates.invalidateEmailFields(emailField, 200);

global static void invalidateEmailFields(SObjectField emailFieldToInvalidate, Integer recordsPerBatch, Boolean isAllOrNothing)

Invalidates all valid email addresses for the specified email field, with batch size and transaction control. If isAllOrNothing is true, the entire transaction is rolled back if any record fails.

Parameters

Parameter	Type	Description
emailFieldToInvalidate	SObjectField	The email field to query and invalidate.
recordsPerBatch	Integer	The number of records to process in each batch.
isAllOrNothing	Boolean	Whether to abort the transaction on failure (true = abort on any failure).

Example

SObjectField emailField = Lead.Email;
UTIL_BulkUpdates.invalidateEmailFields(emailField, 100, true);

global static void invalidateEmailFields(String sObjectName, String fieldApiName)

Invalidates all valid email addresses for the specified field in a Salesforce object. Uses the maximum batch size for processing.

Parameters

Parameter	Type	Description
sObjectName	String	The name of the Salesforce object (e.g., 'Account').
fieldApiName	String	The API name of the field (e.g., 'Email') to check and invalidate.

Example

UTIL_BulkUpdates.invalidateEmailFields('Account', 'Email');

global static void invalidateEmailFields(String sObjectName, String fieldApiName, Boolean isAllOrNothing)

Invalidates all valid email addresses for the specified field in a Salesforce object, with transaction control.

Parameters

Parameter	Type	Description
sObjectName	String	The name of the Salesforce object (e.g., 'Opportunity').
fieldApiName	String	The API name of the field (e.g., 'Email') to check and invalidate.
isAllOrNothing	Boolean	Whether to abort the transaction on failure.

Example

UTIL_BulkUpdates.invalidateEmailFields('Opportunity', 'Email', true);

global static void invalidateEmailFields(String sObjectName, String fieldApiName, Integer recordsPerBatch, Boolean isAllOrNothing)

Invalidates all valid email addresses for the specified field in a Salesforce object, with custom batch size and transaction control.

Parameters

Parameter	Type	Description
sObjectName	String	The name of the Salesforce object (e.g., 'Case').
fieldApiName	String	The API name of the field (e.g., 'Email') to check and invalidate.
recordsPerBatch	Integer	The number of records to process in each batch.
isAllOrNothing	Boolean	Whether to abort the transaction on failure.

Example

UTIL_BulkUpdates.invalidateEmailFields('Case', 'Email', 500, false);

updateField

global static void updateField(String sObjectName, String fieldApiName, Object fieldValue, QRY_Condition.Evaluable searchConditions, Integer recordsPerBatch, Boolean isAllOrNothing)

Updates a specific field on records in a Salesforce object based on the given search conditions. Processes updates in batches with control over partial transaction behavior.

Parameters

Parameter	Type	Description
sObjectName	String	The name of the Salesforce object (e.g., 'Opportunity').
fieldApiName	String	The API name of the field to update.
fieldValue	Object	The new value to set for the field.
searchConditions	QRY_Condition.Evaluable	The conditions used to find the records to update.
recordsPerBatch	Integer	The number of records to process in each batch.
isAllOrNothing	Boolean	Whether to abort the transaction on failure.

Example

QRY_Condition.Evaluable condition = new QRY_Condition.AndCondition()
		.add(new QRY_Condition.FieldCondition('Status').equals('Closed'));
UTIL_BulkUpdates.updateField('Opportunity', 'OwnerId', '005D0000001ABCD', condition, 100, false);

updateOwner

global static void updateOwner(String sObjectName, String existingOwnerProfileName, String newOwnerUsername)

Updates the ownership of records based on the existing owner profile name and new owner username. Uses the maximum batch size for processing.

Parameters

Parameter	Type	Description
sObjectName	String	The name of the Salesforce object (e.g., 'Opportunity').
existingOwnerProfileName	String	The profile name of the current record owners.
newOwnerUsername	String	The username of the new owner to assign to the records.

Example

UTIL_BulkUpdates.updateOwner('Opportunity', 'Sales Rep', 'john.doe@example.com');

global static void updateOwner(String sObjectName, String existingOwnerProfileName, String newOwnerUsername, Integer recordsPerBatch, Boolean isAllOrNothing)

Updates the ownership of records based on the current owner profile, new owner username, batch size, and transaction control.

Parameters

Parameter	Type	Description
sObjectName	String	The name of the Salesforce object (e.g., 'Account').
existingOwnerProfileName	String	The profile name of the current record owners.
newOwnerUsername	String	The username of the new owner to assign to the records.
recordsPerBatch	Integer	The number of records to process in each batch.
isAllOrNothing	Boolean	Whether to abort the transaction on failure.

Example

UTIL_BulkUpdates.updateOwner('Account', 'Support Rep', 'jane.smith@example.com', 200, true);