Salesforce Bulk Update

Owned by Lakshmi Manda
Last updated: Mar 27, 2024 by Lakshmi Manda
4 min read

In this article

Overview

You can use this Snap to uupdate object records in Salesforce object records using Salesforce using Bulk API 2.0.

  • The ID field is required. This Snap will update records only by record ID and not by its external ID.
  • To use newer Salesforce objects, use the latest API versions where those objects are available.

Prerequisites

None.

Support for Ultra Pipelines

Works in Ultra Pipelines.

In Ultra Pipelines, set the Batch Size as 1 for the Snap to process one document/record at a time.

Limitations

  • This Snap performs batch processing, that is, a batch of input documents are processed for each HTTP request sent to Salesforce. Values of all the expression-enabled fields must remain constant during the Snap execution or validation. Hence, all expression fields can support Pipeline parameters only when they are expression-enabled. The input data parameters are not supported for expression fields, for example, $serviceVersion.

Snap Views

TypeFormatNumber of ViewsExamples of Upstream and Downstream SnapsDescription
Input Document
  • Min: 1
  • Max: 1

Mapper

Each document contains Map data for an object ID, a record ID and key-value pairs for fields to be updated
OutputDocument
  • Min: 0
  • Max: 1

JSON Formatter + File Writer

Produces documents in the view.

Error

Error handling is a generic way to handle errors without losing data or failing the Snap execution. You can handle the errors that the Snap might encounter when running the Pipeline by choosing one of the following options from the When errors occur list under the Views tab:

  • Stop Pipeline Execution: Stops the current Pipeline execution when the Snap encounters an error.

  • Discard Error Data and Continue: Ignores the error, discards that record, and continues with the remaining records.

  • Route Error Data to Error View: Routes the error data to an error view without stopping the Snap execution.

Learn more about Error handling in Pipelines.

Because of the potentially large size of the error messages, the Reason for the Salesforce error message in the error document field may be truncated.
The complete error is available in the field full_error under the original object containing copies of the failed input records or in the logs.

Snap Settings

Field NameField TypeDescription

Label*


Default Value: Salesforce Bulk Update
Example: Salesforce Bulk Update

String

Specify a unique name for the Snap. 


Service Version*


Default Value: 52.0 



Example: 41.0

String/Expression/Suggestion

Specify the version number associated with the Salesforce service you want to connect to. Alternatively, click the Suggestion  icon to fetch the