Skip to content

DML_Builder.TransactionResult ​

Class · Group: DML

Learn it: Fast Start - DML and DML guide

apex
global class DML_Builder.TransactionResult

Result object returned by execute() containing the outcome of all DML operations in the transaction. Provides methods to inspect success/failure status, retrieve generated IDs, and access errors.


Methods ​

MethodDescription
global List<Database.Error> getErrors()Returns all errors from failed DML operations across all operation types.
global Integer getFailureCount()Returns the count of failed DML operations across all operation types.
global String getFailureMessage()Returns why a save failed when no exception reached your code.
global List<Id> getInsertedIds()Returns the IDs of all successfully inserted records.
global Integer getSuccessCount()Returns the count of successful DML operations across all operation types.
global Boolean isSuccess()Returns true if all DML operations completed successfully.

getErrors ​

apex
global List<Database.Error> getErrors()

Returns all errors from failed DML operations across all operation types.

Returns Database.Error — List of Database.Error objects from all failed operations.

Example

apex
List<Database.Error> errors = result.getErrors();

getFailureCount ​

apex
global Integer getFailureCount()

Returns the count of failed DML operations across all operation types. For a save that suppressExceptions() turned into a failed result, every record counts as failed when the exception holds no row details. For a partial save stopped by an exception, the count is an estimate, and it is at least 1. It adds the failed rows to the records with no result. It can be too low when a child has the same object type as its parent, because the save then updates that child a second time, and the extra result hides a record that has none.

Returns Integer — Number of failed operations.

Example

apex
Integer failureCount = result.getFailureCount();

getFailureMessage ​

apex
global String getFailureMessage()

Returns why a save failed when no exception reached your code. There are two such cases: a failure that suppressExceptions() caught, and an exception that stopped a partial save. Neither one gives row results, so getErrors() does not show it. When a partial save only refuses some rows, this returns null: read each row's reason from getErrors(). When Salesforce refused the save, this returns the message for the first failed row, without the status code.

Returns String — The reason, or null when the save has no such failure.

Example

apex
DML_Builder.TransactionResult result = DML_Builder.newTransaction()
    .doInsert(record)
    .suppressExceptions()
    .execute();
String reason = result.getFailureMessage();

getInsertedIds ​

apex
global List<Id> getInsertedIds()

Returns the IDs of all successfully inserted records.

Returns Id — List of inserted record IDs.

Example

apex
List<Id> newIds = result.getInsertedIds();

getSuccessCount ​

apex
global Integer getSuccessCount()

Returns the count of successful DML operations across all operation types.

Returns Integer — Number of successful operations.

Example

apex
Integer successCount = result.getSuccessCount();

isSuccess ​

apex
global Boolean isSuccess()

Returns true if all DML operations completed successfully.

Returns Boolean — True if no failures occurred.

Example

apex
DML_Builder.TransactionResult result = DML_Builder.newTransaction()
    .doInsert(record)
    .execute();
Assert.isTrue(result.isSuccess(), 'Should succeed');