Salesforce Poller
In this article
Overview
This Snap provides the functionality to poll the status of the batch job submitted to Salesforce by the preceding Salesforce Snaps (Create/Delete/Update/Upsert) in Bulk API mode. This Snap uses the Salesforce Bulk API to check the batch job status and retrieve the result for each record. The Snap sends the successful record writes to the output view and the failed record writes to the error view.
Support for Ultra Pipelines
Works in Ultra Task Pipelines.
Snap Views
View Type | View Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
|---|---|---|---|---|
Input | Document |
|
| This Snap has exactly one input view and receives documents in the view. Each document contains a Map data for the job ID (key: "jobId"), batch ID (key: "batchId") and URL (key: "url"), and records of field-value pairs. |
Output | Document |
|
| This Snap has exactly one output view and produces documents in the view. Each document contains Map data that includes an object ID and records of the field-value pairs for the successful record write. |
Error | Document |
| N/A | This Snap has one optional error view and produces documents in the view. Each document contains Map data that includes an object ID, records of the field-value pairs for the failed record write, and an error message. |
Snap Settings
Field | Field Type | Description |
|
|---|---|---|---|
Label*
| String | Specify a unique name for the Snap. You can modify this to be more specific, especially if you have more than one of the same Snap in your pipeline. Default Value:Salesforce Poller | |
Polling interval*
| String | Specify the polling interval in seconds for the Bulk API batch job execution. At each polling interval, the Snap checks the status of the Bulk API batch processing. Default Value:5 Maximum value: 60 | |
Polling timeout*
| String | Specify the polling timeout in seconds for the Bulk API batch job execution. If the timeout occurs while waiting to complete the batch job execution, the Snap displays an exception. Default Value: 3000 The polling timer starts at the beginning of the pipeline execution, and NOT when the first document passes into the Salesforce Poller snap. The Polling Timeout includes waiting for the first document to pass into the Salesforce Poller Snap. | |
Number Of Retries | String/Expression | Specify the maximum number of retry attempts in case of connection failures (401/403 and 500 errors). Default Value: 1 Minimum value: 0 | |
Retry Interval (seconds) | String/Expression | Specify the minimum number of seconds for which the Snap must wait before attempting recovery from a network failure. Default Value: 1 Minimum value: 0 | |
Pass through
| Checkbox | Select this checkbox to display input data fields as the top-level flatmap data merged with the response from SFDC in the output document. If you deselect this checkbox, the output document contains only the SFDC response. Default Value: Selected | |
Snap Execution
| Dropdown list | Select one of the following three modes in which the Snap executes:
Default Value: Execute only | |
Examples
Pipeline: Salesforce.com Data to a File: This pipeline reads data using a Salesforce read and writes it to a file.