UpsertResult Class

The result of an upsert DML operation returned by the Database.upsert method.

Namespace

Database

Usage

An array of Database.UpsertResult objects is returned with the upsert database method. Each element in the UpsertResult array corresponds to the sObject array passed as the sObject[] parameter in the upsert Database method; that is, the first element in the UpsertResult array matches the first element passed in the sObject array, the second element corresponds with the second element, and so on. If only one sObject is passed in, the UpsertResults array contains a single element.

UpsertResult Methods

The following are methods for UpsertResult. All are instance methods.

  • getErrors()
    If an error occurred, returns an array of one or more database error objects providing the error code and description. If no error occurred, returns an empty set.
  • getId()
    Returns the ID of the sObject you were trying to update or insert.
  • isCreated()
    A Boolean value that is set to true if the record was created, false if the record was updated.
  • isSuccess()
    Returns a Boolean value that is set to true if the DML operation was successful for this object, false otherwise.

getErrors()

If an error occurred, returns an array of one or more database error objects providing the error code and description. If no error occurred, returns an empty set.

Signature

public Database.Error[] getErrors()

Return Value

Type: Database.Error []

getId()

Returns the ID of the sObject you were trying to update or insert.

Signature

public ID getId()

Return Value

Type: ID

Usage

If this field contains a value, the object was successfully updated or inserted. If this field is empty, the operation was not successful for that object.

isCreated()

A Boolean value that is set to true if the record was created, false if the record was updated.

Signature

public Boolean isCreated()

Return Value

Type: Boolean

isSuccess()

Returns a Boolean value that is set to true if the DML operation was successful for this object, false otherwise.

Signature

public Boolean isSuccess()

Return Value

Type: Boolean