In this article
The Salesforce Subscriber Snap is a Read-type Snap that provides the functionality to subscribe to Salesforce Platform and CDC events for a given standard and custom Salesforce object.
Refer the Salesforce Platform Event Allocations and Subscribe to change events documents before configuring this Snap. |
From 4.30 release, the Snap stops and reports the error immediately when it encounters the daily limit exceeded
error. Earlier, the Snap reported an error and stopped only at the next resubscribe attempt when it encountered the daily limit exceeded
error
Works in Ultra Pipelines.
Type | Format | Number of Views | Examples of Upstream and Downstream Snaps | Description |
---|---|---|---|---|
Input | Document | Min:0 |
| This Snap at the most can have only one input document that contains data to be published on a Salesforce object. |
Output | Document | Min:1 Max:1 |
| A document with Map data that contain the individual records published on the given Salesforce object and/or original fields. |
Field | Field Type | Description | |
---|---|---|---|
Label* | String | Specify the 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 Subscriber | |
Service Version* | String/Expression | Specify the version number of the Salesforce service that you want to connect to.
Default value: 44.0 | |
Events* | String/Expression | The Salesforce Platform Event or CDC Event. This is a suggestible field that lists the Platform Events and CDC events available to you. Example:
Default value: None | |
Replay ID* | Integer/Expression | Specify the position of an event in the event stream. The Snap supports the following IDs:
If you stop a Pipeline execution, the Replay ID is lost and the Snap restarts from the position you input here.
Default Value: -2 | |
Message Count* | Integer/Expression | Specify the number of messages required to read and complete the Pipeline execution.
Default Value: -1 | |
Pass Through | Checkbox | Select this checkbox to pass the input document the output view under the key 'original'. If you deselect this checkbox, the input document will not be passed and there is no "original" key in the output document. Default Value: Selected | |
Advanced Properties | Use this fieldset to configure Http Long Polling. | ||
Properties | String | Enter the property or select from the suggestion list. Default Value: N/A | |
Values | String | Enter the value for the property. Default Value: N/A | |
Snap Execution | Dropdown list |
This example Pipeline demonstrates how the Salesforce Subscriber Snap processes platform events.
The following Salesforce Subscriber Snap shows how the Snap is configured and how the Salesforce object's records are read.
You can see that the Replay ID is -2. So the Snaps reads messages from the beginning. And the Snap reads only 3 messages as the Message count is set to 3.The Snap processes the events and the output preview is as follows:
Download this Pipeline.