The Salesforce Connector will allow to connect to the Salesforce application using regular username and password via the SOAP API. Almost every operation that can be done via the Salesforce's API can be done thru this connector. This connector will also work if your Salesforce objects are customized with additional fields or even you are working with custom objects.
Integrating with Salesforce consists of web service calls utilizing XML request/response setup over an HTTPS connection. The technical details of this connection such as request headers, error handling, HTTPS connection, etc. are all abstracted from the user to make implementation quick and easy.
Additional Info
Requires Mule Enterprise License |
Yes |
Requires Entitlement |
No |
Mule Version |
3.5.0 or higher |
Configs
Basic Authentication
<sfdc:cached-basic-config>
Connection Management
Salesforce connector configuration that uses basic authentication for establishing connection with Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
username |
Username used to initialize the session |
x |
||
password |
Password used to authenticate the user |
x |
||
securityToken |
User's security token. It can be omitted if your IP has been whitelisted on Salesforce |
|
||
url |
Web service URL responsible for user authentication. This is the URL for the endpoint that is configured to handle SOAP authentication requests. |
|
||
sessionId |
This value may be used to specify and identify an active Salesforce session |
|
||
serviceEndpoint |
Specifies the service endpoint. This value will only be used if the sessionId configuration property is used. |
|
||
disableSessionInvalidation |
boolean |
If set to true then the session will not be invalidated when the connection pool deems the connection is no longer needed. This could be useful if you use the same username from several applications and get the same session from Salesforce. Default value is false. |
false |
|
useKeepAlive |
boolean |
If set to true then the session will not expire and the connector will execute a simple request to mantain the session. |
false |
|
initialDelay |
long |
Specify the time in seconds the connector will wait before executing the first keep-alive request |
0 |
|
keepAliveRequestFrequency |
long |
Specifies the time in seconds the connector will wait between two successive requests |
320 |
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
OAuth 2.0 Username-Password (Deprecated)
<sfdc:config-oauth-user-pass>
Connection Management
Salesforce configuration object that uses OAuth 2.0 JWT bearer in order to establish a connection with the Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
consumerKey |
Consumer key for Salesforce-connected app |
x |
||
consumerSecret |
Your application's client secret (consumer secret in Remote Access Detail). |
x |
||
username |
Username used to initialize the session. |
x |
||
password |
Password used to authenticate the user. |
x |
||
securityToken |
User's security token. It can be omitted if your IP has been whitelisted on Salesforce. |
|
||
tokenEndpoint |
URL pointing to the server responsible for providing the authentication token. According to Salesforce it should be https://login.salesforce.com/services/oauth2/token, or, if implementing for a community, https://acme.force.com/customers/services/oauth2/token (where acme.force.com/customers is your community URL). |
|
||
disableSessionInvalidation |
boolean |
If true then the session will NOT be invalidated when the connection pool deems the connection is no longer needed. This could be useful when you use the same username from more applications and get the same session from Salesforce. Default value is false. |
false |
|
apiVersion |
Salesforce API version. The default value is the latest version supported by the connector. |
48.0 |
|
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
OAuth 2.0 SAML Bearer
<sfdc:cached-config-oauth-saml-bearer>
Connection Management
Salesforce configuration object that uses OAuth 2.0 SAML bearer in order to establish connection with Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
consumerKey |
Consumer key for Salesforce connected app |
x |
||
keyStore |
Path to key store used to sign data during authentication |
x |
||
storePassword |
Password of key store |
x |
||
principal |
Username of desired Salesforce user to take action on behalf of. |
x |
||
tokenEndpoint |
URL pointing to the server responsible for providing the authentication token. According to Salesforce it should be https://login.salesforce.com/services/oauth2/token, or, if implementing for a community, https://acme.force.com/customers/services/oauth2/token (where acme.force.com/customers is your community URL). |
|
||
disableSessionInvalidation |
boolean |
If true then the session will NOT be invalidated when the connection pool deems the connection is no longer needed. This could be useful when you use the same username from * more applications and get the same session from Salesforce. Default value is false. |
false |
|
useKeepAlive |
boolean |
If set to true then the session will not expire and the connector will execute a simple request to mantain the session. |
false |
|
initialDelay |
long |
Specify the time in seconds the connector will wait before executing the first keep-alive request |
0 |
|
keepAliveRequestFrequency |
long |
Specifies the time in seconds the connector will wait between two successive requests |
320 |
|
apiVersion |
Salesforce API version. The default value is the latest version supported by the connector. |
48.0 |
|
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
OAuth 2.0 Username-Password
<sfdc:cached-config-oauth-user-pass>
Connection Management
Salesforce configuration object that uses OAuth 2.0 JWT bearer in order to establish a connection with the Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
consumerKey |
Consumer key for Salesforce-connected app |
x |
||
consumerSecret |
Your application's client secret (consumer secret in Remote Access Detail). |
x |
||
username |
Username used to initialize the session. |
x |
||
password |
Password used to authenticate the user. |
x |
||
securityToken |
User's security token. It can be omitted if your IP has been whitelisted on Salesforce. |
|
||
tokenEndpoint |
URL pointing to the server responsible for providing the authentication token. According to Salesforce it should be https://login.salesforce.com/services/oauth2/token, or, if implementing for a community, https://acme.force.com/customers/services/oauth2/token (where acme.force.com/customers is your community URL). |
|
||
disableSessionInvalidation |
boolean |
If true then the session will NOT be invalidated when the connection pool deems the connection is no longer needed. This could be useful when you use the same username from more applications and get the same session from Salesforce. Default value is false. |
false |
|
useKeepAlive |
boolean |
If set to true then the session will not expire and the connector will execute a simple request to mantain the session. |
false |
|
initialDelay |
long |
Specify the time in seconds the connector will wait before executing the first keep-alive request |
0 |
|
keepAliveRequestFrequency |
long |
Specifies the time in seconds the connector will wait between two successive requests |
320 |
|
apiVersion |
Salesforce API version. The default value is the latest version supported by the connector. |
48.0 |
|
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
Basic Authentication (Deprecated)
<sfdc:config>
Connection Management
Salesforce connector configuration that uses basic authentication for establishing connection with Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
username |
Username used to initialize the session |
x |
||
password |
Password used to authenticate the user |
x |
||
securityToken |
User's security token. It can be omitted if your IP has been whitelisted on Salesforce |
|
||
url |
Web service URL responsible for user authentication. This is the URL for the endpoint that is configured to handle SOAP authentication requests. |
|
||
sessionId |
This value may be used to specify and identify an active Salesforce session |
|
||
serviceEndpoint |
Specifies the service endpoint. This value will only be used if the sessionId configuration property is used. |
|
||
disableSessionInvalidation |
boolean |
If set to true then the session will not be invalidated when the connection pool deems the connection is no longer needed. This could be useful if you use the same username from several applications and get the same session from Salesforce. Default value is false. |
false |
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
OAuth 2.0 JWT Bearer
<sfdc:cached-config-oauth-jwt-bearer>
Connection Management
Salesforce configuration object that uses OAuth 2.0 JWT bearer in order to establish a connection with the Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
consumerKey |
Consumer key for Salesforce connected app |
x |
||
keyStore |
Path to key store used to sign data during authentication |
x |
||
storePassword |
Password of key store |
x |
||
principal |
Username of desired Salesforce user to take action on behalf of. |
x |
||
tokenEndpoint |
URL pointing to the server responsible for providing the authentication token. According to Salesforce it should be https://login.salesforce.com/services/oauth2/token, or, if implementing for a community, https://acme.force.com/customers/services/oauth2/token (where acme.force.com/customers is your community URL). |
|
||
disableSessionInvalidation |
boolean |
If true then the session will NOT be invalidated when the connection pool deems the connection is no longer needed. This could be useful when you use the same username from * more applications and get the same session from Salesforce. Default value is false. |
false |
|
useKeepAlive |
boolean |
If set to true then the session will not expire and the connector will execute a simple request to mantain the session. |
false |
|
initialDelay |
long |
Specify the time in seconds the connector will wait before executing the first keep-alive request |
0 |
|
keepAliveRequestFrequency |
long |
Specifies the time in seconds the connector will wait between two successive requests |
320 |
|
apiVersion |
Salesforce API version. The default value is the latest version supported by the connector. |
48.0 |
|
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
OAuth 2.0 JWT Bearer (Deprecated)
<sfdc:config-oauth-jwt-bearer>
Connection Management
Salesforce configuration object that uses OAuth 2.0 JWT bearer in order to establish a connection with the Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
consumerKey |
Consumer key for Salesforce connected app |
x |
||
keyStore |
Path to key store used to sign data during authentication |
x |
||
storePassword |
Password of key store |
x |
||
principal |
Username of desired Salesforce user to take action on behalf of. |
x |
||
tokenEndpoint |
URL pointing to the server responsible for providing the authentication token. According to Salesforce it should be https://login.salesforce.com/services/oauth2/token, or, if implementing for a community, https://acme.force.com/customers/services/oauth2/token (where acme.force.com/customers is your community URL). |
|
||
disableSessionInvalidation |
boolean |
If true then the session will NOT be invalidated when the connection pool deems the connection is no longer needed. This could be useful when you use the same username from * more applications and get the same session from Salesforce. Default value is false. |
false |
|
apiVersion |
Salesforce API version. The default value is the latest version supported by the connector. |
48.0 |
|
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
OAuth 2.0 SAML Bearer (Deprecated)
<sfdc:config-oauth-saml-bearer>
Connection Management
Salesforce configuration object that uses OAuth 2.0 SAML bearer in order to establish connection with Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
consumerKey |
Consumer key for Salesforce connected app |
x |
||
keyStore |
Path to key store used to sign data during authentication |
x |
||
storePassword |
Password of key store |
x |
||
principal |
Username of desired Salesforce user to take action on behalf of. |
x |
||
tokenEndpoint |
URL pointing to the server responsible for providing the authentication token. According to Salesforce it should be https://login.salesforce.com/services/oauth2/token, or, if implementing for a community, https://acme.force.com/customers/services/oauth2/token (where acme.force.com/customers is your community URL). |
|
||
disableSessionInvalidation |
boolean |
If true then the session will NOT be invalidated when the connection pool deems the connection is no longer needed. This could be useful when you use the same username from * more applications and get the same session from Salesforce. Default value is false. |
false |
|
apiVersion |
Salesforce API version. The default value is the latest version supported by the connector. |
48.0 |
|
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
OAuth v2.0
<sfdc:config-with-oauth>
OAuth2
Using OAuth2 as authentication method will add the authorize and unauthorize operations. You must authorize before using any operation with OAuth2.
Salesforce connector configuration that uses the OAuth2 dance for establishing a connection with the Salesforce system.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
name |
The name of this configuration. With this name can be later referenced. |
x |
||
consumerKey |
Your application's client identifier (consumer key in Remote Access Detail). |
x |
||
consumerSecret |
Your application's client secret (consumer secret in Remote Access Detail). |
x |
||
apiVersion |
Salesforce API version. The default value is the latest version supported by the connector. |
48.0 |
|
|
clientId |
Client ID for partners |
|
||
assignmentRuleId |
The ID of a specific assignment rule to run for the Case or Lead. The assignment rule is either set to active or inactive. The ID can be retrieved by querying the AssignmentRule object. If specified, do not specify useDefaultRule. This element is ignored for accounts, because all territory assignment rules are applied. If the value is not in correct ID format (15-character or 18-character Salesforce ID), the call fails and a MALFORMED_ID exception is returned. Default value is false. |
|
||
useDefaultRule |
If true, the default (active) assignment rule for a Case or Lead is used. If specified, do not specify an assignmentRuleId. If true for an Account, all territory assignment rules are applied, and if false, no territory assignment rules are applied. Default value is false. |
false |
|
|
allowFieldTruncationSupport |
If true, truncates field values that are too long, which is the behavior in API versions 14.0 and earlier. Default is false: no change in behavior. If a string or text area value is too large, the operation fails and the fault code STRING_TOO_LONG is returned. |
false |
|
|
fetchAllApexSoapMetadata |
boolean |
If checked then Datasense is performed for all Apex classes in the organization, otherwise it is performed only for the classes in Apex class names. If the organization contains a lot of Apex classes this might cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
fetchAllApexRestMetadata |
boolean |
If checked then Datasense will be performed for all Apex classes in the organization else Datasense will be performed only for the classes in Apex class names. If the organization contains many Apex classes this could cause ConnectionTimeout during Datasense. Default value is false. |
false |
|
apexClassNames |
List of Apex class names involved in metadata retrieval via Datasense. |
|
||
clearNullFields |
boolean |
If false, then in order to clear a field its name must be provided in an update request in the 'fieldsToNull' field, otherwise, for clearing a field it can also be simply added to the request with the value 'null'. Default value is false. |
false |
|
readTimeout |
Specifies the amount of time, in milliseconds, that the consumer will wait for a response before it times out. Default value is 0, which means infinite. |
0 |
|
|
connectionTimeout |
Specifies the amount of time, in milliseconds, that the consumer will attempt to establish a connection before it times out. Default value is 0, which means infinite. |
0 |
|
|
proxyHost |
Hostname of the proxy. If this property is not set then no proxy will be used, otherwise a proxy will be used, but a proxy host must be specified. |
|
||
proxyPort |
Port of the proxy. If host is set then this property must be set and cannot be a negative number. |
|
||
proxyUsername |
Username used to authenticate against the proxy. If this property is not set then no authentication is going to be used against the proxy, otherwise this value must be specified. |
|
||
proxyPassword |
Password used to authenticate against the proxy. |
|
||
timeObjectStore |
ObjectStore |
An ObjectStore instance to use in SalesforceConnector#getUpdatedObjects |
|
|
batchSobjectMaxDepth |
Creating a batch will create SObjects using this value for the MAX_DEPTH check. |
5 |
|
Processors
Create
<sfdc:create>
DataSense enabled
Adds one or more new records to your organization's data.
IMPORTANT: When you map your objects to the input of this message processor keep in mind that they need to match the expected type of the object at Salesforce.
Take the CloseDate of an Opportunity as an example, if you set that field to a string of value "2011-12-13" it will be sent to Salesforce as a string and operation will be rejected on the basis that CloseDate is not of the expected type.
The proper way to actually map it is to generate a Java Date object, you can do so using Groovy expression evaluator as #[groovy:Date.parse("yyyy-MM-dd", "2011-12-13")].
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Type of object to create |
x |
||
objects |
An array of one or more sObject objects. |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Create job
<sfdc:create-job>
DataSense enabled
Creates a Job in order to perform one or more batches through Bulk API Operations.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
operation |
OperationEnum |
The com.sforce.async.OperationEnum that will be executed by the job. |
x |
|
type |
The type of Salesforce object that the job will process. |
x |
||
externalIdFieldName |
Contains the name of the field on this object with the external ID field attribute for custom objects or the idLookup field property for standard objects (only required for Upsert Operations). |
|
||
contentType |
ContentType |
The Content Type for this Job results. When specifying a content type different from XML for a query type use queryResultStream(BatchInfo) method to retrieve results. |
|
|
concurrencyMode |
ConcurrencyMode |
The concurrency mode of the job, either Parallel or Serial. |
|
|
headers |
These headers are sent as HTTP headers with the request to Bulk API |
|
Close job
<sfdc:close-job>
Closes an open Job given its ID.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
jobId |
The Job ID identifying the Job to be closed. |
x |
Abort job
<sfdc:abort-job>
Aborts an open Job given its ID.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
jobId |
The Job ID identifying the Job to be aborted. |
x |
Job info
<sfdc:job-info>
Access latest JobInfo of a submitted JobInfo. Allows to track execution status.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
jobId |
the Job ID of the Job being monitored |
x |
||
contentType |
ContentType |
specifies the content type of the message |
|
Returns
Return Java Type | Description |
---|---|
JobInfo |
Latest JobInfo representing the status of the job result. |
Create batch
<sfdc:create-batch>
Creates a Batch using the given objects within the specified Job. The Job can be of XML or CSV type.
This call uses the Bulk API. The operation will be done in asynchronous fashion.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
jobInfo |
JobInfo |
The com.sforce.async.JobInfo in which the batch will be created. The Job can be of XML, JSON or CSV type. |
x |
|
objects |
A list of one or more sObject objects. This parameter defaults to payload content. |
#[payload] |
|
Create batch stream
<sfdc:create-batch-stream>
Creates a Batch using the given stream within the specified Job. The stream can have a CSV,XML, ZIP_CSV or ZIP_XML format.
This call uses the Bulk API. The operation will be done in asynchronous fashion.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
jobInfo |
JobInfo |
The com.sforce.async.JobInfo in which the batch will be created. This parameter defaults to payload content. |
#[payload] |
|
stream |
A stream containing the data. The stream can have a CSV,XML, ZIP_CSV or ZIP_XML format. |
x |
Create batch for query
<sfdc:create-batch-for-query>
Creates a Batch using the given query.
This call uses the Bulk API. The operation will be done in asynchronous fashion.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
jobInfo |
JobInfo |
The com.sforce.async.JobInfo in which the batch will be created. |
#[payload] |
|
query |
The query to be executed. |
x |
Create bulk
<sfdc:create-bulk>
DataSense enabled
Adds one or more new records to your organization's data.
This call uses the Bulk API. The creation will be done in asynchronous fashion.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Type of object to create |
x |
||
objects |
An array of one or more sObject objects. |
#[payload] |
|
Create single
<sfdc:create-single>
DataSense enabled
Adds one new record to your organization's data.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Type of object to create |
x |
||
object |
SObject to create |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
SaveResult |
An array of { SaveResult} |
Update
<sfdc:update>
DataSense enabled
Updates one or more existing records in your organization's data.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Type of object to update |
x |
||
objects |
An array of one or more sObject objects. |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Update single
<sfdc:update-single>
DataSense enabled
Updates one record in your organization's data.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Type of object to update |
x |
||
object |
The object to be updated. |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
SaveResult |
A { SaveResult} |
Update bulk
<sfdc:update-bulk>
DataSense enabled
Updates one or more existing records in your organization's data.
This call uses the Bulk API. The creation will be done in asynchronous fashion.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Type of object to update |
x |
||
objects |
An array of one or more sObject objects. |
#[payload] |
|
Merge
<sfdc:merge>
DataSense enabled
Merge up to three records into one.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Type of object to merge |
x |
||
object |
The Master object used for the merge |
#[payload] |
|
|
ids |
A list of ids of the objects to be merged |
|
||
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
MergeResult |
instance of {see MergeResult} containing the result of the Merge |
Upsert
<sfdc:upsert>
DataSense enabled
Upserts a homogeneous list of objects: creates new records and updates existing records, using a custom field to determine the presence of existing records. In most cases, prefer { #upsert(String, String, List, Map)} over { #create(String, List, Map)}, to avoid creating unwanted duplicate records.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
externalIdFieldName |
Contains the name of the field on this object with the external ID field attribute for custom objects or the idLookup field property for standard objects. |
x |
||
type |
The type of the given objects. The list of objects to upsert must be homogeneous. |
x |
||
objects |
The objects to upsert. |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Upsert bulk
<sfdc:upsert-bulk>
DataSense enabled
Upserts a homogeneous list of objects: creates new records and updates existing records, using a custom field to determine the presence of existing records. In most cases, prefer { #upsert(String, String, List, Map)} over { #create(String, List, Map)}, to avoid creating unwanted duplicate records.
This call uses the Bulk API. The creation will be done in asynchronous fashion.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
The type of the given objects. The list of objects to upsert must be homogeneous. |
x |
||
externalIdFieldName |
Contains the name of the field on this object with the external ID field attribute for custom objects or the idLookup field property for standard objects. |
x |
||
objects |
The objects to upsert |
#[payload] |
|
Batch info
<sfdc:batch-info>
Access latest { BatchInfo} of a submitted { BatchInfo}. Allows tracking of the execution status.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
batchInfo |
BatchInfo |
The com.sforce.async.BatchInfo being monitored |
#[payload] |
|
contentType |
ContentType |
- content type used at job creation. If not provided default value used is ContentType.XML. |
|
Returns
Return Java Type | Description |
---|---|
BatchInfo |
Latest BatchInfo representing status of the batch job result. |
Batch result
<sfdc:batch-result>
Access BatchResult of a submitted BatchInfo.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
batchInfo |
BatchInfo |
The com.sforce.async.BatchInfo being monitored |
#[payload] |
|
Returns
Return Java Type | Description |
---|---|
BatchResult |
BatchResult representing result of the batch job result. |
Batch result stream
<sfdc:batch-result-stream>
Access BatchResult of a submitted BatchInfo.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
batchInfo |
BatchInfo |
The com.sforce.async.BatchInfo being monitored |
#[payload] |
|
headers |
Optional parameter specifying the headers for the operation |
|
Returns
Return Java Type | Description |
---|---|
InputStream representing result of the batch job result. |
Query result stream
<sfdc:query-result-stream>
Returns an InputStream with the query results of a submitted BatchInfo
Internally the InputStreams contained in the sequence will be requested on-demand (lazy-loading). They should be used only with query jobs.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
batchInfo |
BatchInfo |
The com.sforce.async.BatchInfo being monitored |
#[payload] |
|
headers |
Optional parameter specifying the headers for the operation |
|
Describe global
<sfdc:describe-global>
Retrieves a list of available objects for your organization's data.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
headers |
Salesforce Headers More Info |
|
Retrieve
<sfdc:retrieve>
DataSense enabled
Retrieves one or more records based on the specified IDs.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Object type. The specified value must be a valid object for your organization. |
x |
||
ids |
The ids of the objects to retrieve |
#[payload] |
|
|
fields |
The fields to return for the matching objects |
x |
||
headers |
Salesforce Headers More Info |
|
Query
<sfdc:query>
Paged Operation
Executes a query against the specified object and returns data that matches the specified criteria. The returned fields are String and, if necessary, you can convert them to the apropiate type using for example Weave and Transform Message
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
query |
Query string that specifies the object to query, the fields to return, and any conditions for including a specific object in the query. For more information, see Salesforce Object Query Language (SOQL). |
x |
||
pagingConfiguration |
PagingConfiguration |
the paging configuration |
x |
|
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
ProviderAwarePagingDelegate<Map<String,Object>,SalesforceConnector> |
An array of SObjects query() |
Non paginated query
<sfdc:non-paginated-query>
Executes a query against the specified object and returns data that matches the specified criteria.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
query |
Query string that specifies the object to query, the fields to return, and any conditions for including a specific object in the query. For more information, see Salesforce Object Query Language (SOQL). |
x |
||
headers |
Salesforce Headers More Info |
|
Query all
<sfdc:query-all>
Paged Operation
Retrieves data from specified objects, whether or not they have been deleted.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
query |
Query string that specifies the object to query, the fields to return, and any conditions for including a specific object in the query. For more information, see Salesforce Object Query Language (SOQL). |
x |
||
pagingConfiguration |
PagingConfiguration |
the paging configuration |
x |
|
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
ProviderAwarePagingDelegate<Map<String,Object>,SalesforceConnector> |
An array of { SObject}s query() |
Search
<sfdc:search>
Search for objects using Salesforce Object Search Language. Mimics using the search box inside the Salesforce UI.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
query |
Query string that specifies the object to query, the fields to return, and any conditions for including a specific object in the query. For more information, see Salesforce Object Search Language (SOSL). |
x |
||
headers |
Salesforce Headers More Info |
|
Query single
<sfdc:query-single>
Executes a query against the specified object and returns the first record that matches the specified criteria.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
query |
Query string that specifies the object to query, the fields to return, and any conditions for including a specific object in the query. For more information, see Salesforce Object Query Language (SOQL). |
x |
||
headers |
Salesforce Headers More Info |
|
Convert lead
<sfdc:convert-lead>
Converts a Lead into an Account, Contact, or (optionally) an Opportunity.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
leadId |
ID of the Lead to convert. Required. For information on IDs, see ID Field Type. |
x |
||
contactId |
ID of the Contact into which the lead will be merged (this contact must be associated with the specified accountId, and an accountId must be specified). Required only when updating an existing contact.IMPORTANT if you are converting a lead into a person account, do not specify the contactId or an error will result. Specify only the accountId of the person account. If no contactID is specified, then the API creates a new contact that is implicitly associated with the Account. To create a new contact, the client application must be logged in with sufficient access rights. To merge a lead into an existing contact, the client application must be logged in with read/write access to the specified contact. The contact name and other existing data are not overwritten (unless overwriteLeadSource is set to true, in which case only the LeadSource field is overwritten). For information on IDs, see ID Field Type. |
|
||
accountId |
ID of the Account into which the lead will be merged. Required only when updating an existing account, including person accounts. If no accountID is specified, then the API creates a new account. To create a new account, the client application must be logged in with sufficient access rights. To merge a lead into an existing account, the client application must be logged in with read/write access to the specified account. The account name and other existing data are not overwritten. For information on IDs, see ID Field Type. |
|
||
opportunityId |
The ID of an existing opportunity to relate to a lead during lead conversion. |
|
||
overWriteLeadSource |
Specifies whether to overwrite the LeadSource field on the target Contact object with the contents of the LeadSource field in the source Lead object (true), or not (false, the default). To set this field to true, the client application must specify a contactId for the target contact. |
false |
|
|
doNotCreateOpportunity |
Specifies whether to create an Opportunity during lead conversion (false, the default) or not (true). Set this flag to true only if you do not want to create an opportunity from the lead. An opportunity is created by default. |
false |
|
|
opportunityName |
Name of the opportunity to create. If no name is specified, then this value defaults to the company name of the lead. The maximum length of this field is 80 characters. If doNotCreateOpportunity argument is true, then no Opportunity is created and this field must be left blank; otherwise, an error is returned. |
|
||
convertedStatus |
Valid LeadStatus value for a converted lead. Required. To obtain the list of possible values, the client application queries the LeadStatus object, as in: Select Id, MasterLabel from LeadStatus where IsConverted=true |
x |
||
sendEmailToOwner |
Specifies whether to send a notification email to the owner specified in the ownerId (true) or not (false, the default). |
false |
|
|
headers |
Salesforce Headers More Info |
|
Empty recycle bin
<sfdc:empty-recycle-bin>
The recycle bin lets you view and restore recently deleted records for 30 days before they are permanently deleted. Your organization can have up to 5000 records per license in the Recycle Bin at any one time. For example, if your organization has five user licenses, 25,000 records can be stored in the Recycle Bin. If your organization reaches its Recycle Bin limit, Salesforce.com automatically removes the oldest records, as long as they have been in the recycle bin for at least two hours.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
ids |
Array of one or more IDs associated with the records to delete from the recycle bin. Maximum number of records is 200. |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
A list of { com.sforce.soap.partner.EmptyRecycleBinResult} |
Get server timestamp
<sfdc:get-server-timestamp>
Retrieves the current system timestamp (Coordinated Universal Time (UTC) time zone) from the API.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
Delete
<sfdc:delete>
Deletes one or more records from your organization's data.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
ids |
Array of one or more IDs associated with the objects to delete. |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Hard delete bulk
<sfdc:hard-delete-bulk>
DataSense enabled
Deletes one or more records from your organization's data. The deleted records are not stored in the Recycle Bin. Instead, they become immediately eligible for deletion.
This call uses the Bulk API. The creation will be done in asynchronous fashion.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Type of object to update |
x |
||
objects |
An array of one or more sObject objects. |
#[payload] |
|
Get updated range
<sfdc:get-updated-range>
DataSense enabled
Retrieves the list of individual records that have been created/updated within the given time frame for the specified object.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Object type. The specified value must be a valid object for your organization. |
x |
||
startTime |
Starting date/time (Coordinated Universal Time (UTC) not local timezone) of the time frame for which to retrieve the data. The API ignores the value for seconds in the specified dateTime value (for example, 12:30:15 is interpreted as 12:30:00 UTC). |
x |
||
endTime |
Ending date/time (Coordinated Universal Time (UTC) not local timezone) of the time frame for which to retrieve the data. The API ignores the value for seconds in the specified dateTime value (for example, 12:35:15 is interpreted as 12:35:00 UTC). If it is not provided, the current server time will be used. |
|
||
headers |
Salesforce Headers More Info |
|
Get deleted range
<sfdc:get-deleted-range>
DataSense enabled
Retrieves the list of individual records that have been deleted within the given time frame for the specified object.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Object type. The specified value must be a valid object for your organization. |
x |
||
startTime |
Starting date/time (Coordinated Universal Time (UTC) not local timezone) of the time frame to retrieve the data from. The API ignores the value for seconds in the specified dateTime value (for example, 12:30:15 is interpreted as 12:30:00 UTC). |
x |
||
endTime |
Ending date/time (Coordinated Universal Time (UTC) not local timezone) of the time frame to retrieve the data from. The API ignores the value for seconds in the specified dateTime value (for example, 12:35:15 is interpreted as 12:35:00 UTC). If the time is not specified, the current server time will be used. |
|
||
headers |
Salesforce Headers More Info |
|
Describe sObject
<sfdc:describe-sobject>
DataSense enabled
Describes metadata (field list and object properties) for the specified object.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Standard Object. The specified value must be a valid object for your organization. For a complete list of objects |
x |
||
headers |
Salesforce Headers More Info |
|
Get deleted
<sfdc:get-deleted>
DataSense enabled
Retrieves the list of individual records that have been deleted since a time in the past specified in minutes before now.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Object type. The specified value must be a valid object for your organization. |
x |
||
duration |
int |
The amount of time, counted from now to some point in the past, for which to return records. |
x |
|
headers |
Salesforce Headers More Info |
|
Get updated
<sfdc:get-updated>
DataSense enabled
Retrieves the list of individual records that have been updated within a time range, specified in minutes, counting from the current time to some point in the past.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Object type. The specified value must be a valid object for your organization. |
x |
||
duration |
int |
The amount of time in minutes, counted from now to some point in the past, to specify the range you want updated records from. |
x |
|
headers |
Salesforce Headers More Info |
|
Get updated objects
<sfdc:get-updated-objects>
DataSense enabled
Retrieves the list of records that have been updated between the last time this method was called and now. This method will save the timestamp of the latest date covered by Salesforce represented by GetUpdatedResult#latestDateCovered. IMPORTANT: In order to use this method in a reliable way user must ensure that right after this method returns the result is stored in a persistent way since the timestamp of the latest . In order to reset the latest update time use resetUpdatedObjectsTimestamp(String)
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
Object type. The specified value must be a valid object for your organization. |
x |
||
initialTimeWindow |
int |
Time window (in minutes) used to calculate the start time (in time range) the first time this operation is called. E.g: if initialTimeWindow equals 2, the start time will be the current time (now) minus 2 minutes, then the range to retrieve the updated object will be (now - 2 minutes; now). After first call the start time will be calculated from the object store getting the last time this operation was exec |
x |
|
fields |
The fields to retrieve for the updated objects |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Reset updated objects timestamp
<sfdc:reset-updated-objects-timestamp>
DataSense enabled
Resets the timestamp of the last updated object. After resetting this, a call to getUpdatedObjects will use the initialTimeWindow to get the updated objects. If no timeObjectStore has been explicitly specified and getUpdatedObjects has not been called then calling this method has no effect.
Set password
<sfdc:set-password>
Change the password of a User or SelfServiceUser to a value that you specify.
Publish topic
<sfdc:publish-topic>
Creates a topic representing a query, which is used to notify listeners when changes are made to records in an organization.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
topicName |
Descriptive name of the push topic, such as MyNewCases or TeamUpdatedContacts. The maximum length is 25 characters. This value identifies the channel. |
x |
||
query |
The SOQL query statement that determines which records' changes trigger events to be sent to the channel. Maximum length: 1200 characters |
x |
||
description |
Description of what kinds of records are returned by the query. Limit: 400 characters |
|
Publish streaming channel
<sfdc:publish-streaming-channel>
Creates a streaming channel on which generic, custom messages can be pushed.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
channelName |
Descriptive name of the StreamingChannel. Limit: 80 characters, must start with "/u/". This value identifies the channel and must be unique. |
x |
||
ownerId |
Identifier fir the channel owner. |
|
||
description |
Description of what kinds of records are returned by the query. Limit: 255 characters |
|
Returns
Return Java Type | Description |
---|---|
A POJO list containing data about the outcome of the request. |
Get user info
<sfdc:get-user-info>
Retrieves personal information for the user associated with the current session.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
Create metadata
<sfdc:create-metadata>
DataSense enabled
Create metadata: Adds one or more new metadata components to your organization
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
The Metadata Type to be created |
x |
||
objects |
a List of Map<String, Object> representing the metadatas to be created |
#[payload] |
|
Update metadata
<sfdc:update-metadata>
DataSense enabled
Updates one or more metadata components in your organization.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
The metadata type of the components updated |
x |
||
objects |
a List of Map<String, Object> representing the metadata to be updated |
#[payload] |
|
Upsert metadata
<sfdc:upsert-metadata>
DataSense enabled
Creates or updates one or more metadata components in your organization
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
The metadata type of the components to create/update |
x |
||
objects |
A List of Map<String, Object> representing the metadatas to be upserted |
#[payload] |
|
Delete metadata
<sfdc:delete-metadata>
DataSense enabled
Deletes one or more metadata components from your organization, given the object(s) API Name(s)
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
The metadata type of the components to delete |
x |
||
fullNames |
Full names of the components to delete |
#[payload] |
|
Rename metadata
<sfdc:rename-metadata>
DataSense enabled
Renames a Metadata component in your organization, given its old API Name and the new name
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
The metadata type of the components to rename |
x |
||
oldFullName |
The current component full name |
#[payload] |
|
|
newFullName |
The new component full name |
x |
Read metadata
<sfdc:read-metadata>
DataSense enabled
Returns one or more metadata components from your organization, given the object(s) API Name(s)
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
The metadata type of the components to read |
x |
||
fullNames |
List of full names of the components to read |
#[payload] |
|
List metadata
<sfdc:list-metadata>
DataSense enabled
Retrieves property information about metadata components in your organization
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
The metadata type used as criteria when querying for information |
x |
Describe metadata
<sfdc:describe-metadata>
Describe metadata: This call retrieves the metadata which describes your organization. This information includes Apex classes and triggers, custom objects, custom fields on standard objects, tab sets that define an app, and many other components
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
Returns
Return Java Type | Description |
---|---|
DescribeMetadataResult |
DescribeMetadataResult Contains information about |
Deploy metadata
<sfdc:deploy-metadata>
Deploy. File-based call to deploy XML components. Use this call to take file representations of components and deploy them into an organization by creating, updating, or deleting the components they represent.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
stream |
A stream containing the data. This parameter defaults to payload content. |
#[payload] |
|
|
ignoreWarnings |
boolean |
Indicates whether a warning should allow a deployment to complete successfully (true) or not (false). |
false |
|
purgeOnDelete |
boolean |
If true, the deleted components in the destructiveChanges.xml manifest file aren't stored in the Recycle Bin. This option only works in Developer Edition or sandbox organizations; it doesn't work in production organizations. |
false |
|
rollbackOnError |
boolean |
Indicates whether any failure causes a complete rollback (true) or not (false). |
true |
|
Retrieve metadata
<sfdc:retrieve-metadata>
Retrieve. This call retrieves XML file representations of components in an organization.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
packageNames |
A list of package names to be retrieved. If you are retrieving only unpackaged components, do not specify a name. You can retrieve packaged and unpackaged components in the same retrieval operation. |
|
||
specificFiles |
A list of file names to be retrieved. If a value is specified for this property, packageNames must be set to null. |
|
||
unpackaged |
A stream containing a list of components to retrieve that are not in a package. |
|
Returns
Return Java Type | Description |
---|---|
InputStream representing result of the retrieve job. |
Get session id
<sfdc:get-session-id>
Retrieves the Session Id of the current session.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
validateSession |
boolean |
The session will be validated; if the session is invalid, reconnection will be triggered (if the strategy is enabled), and the new session id will be returned |
false |
|
Get server url
<sfdc:get-server-url>
Retrieves the Partner Server Url of the Salesforce instance.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
Invoke apex soap method
<sfdc:invoke-apex-soap-method>
DataSense enabled
Invokes any operation from an Apex class that is exposed as SOAP web service
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
soapMethodName |
the Apex class method name that will be invoked using SOAP |
x |
||
input |
XMLStreamReader |
XML containing information about the method to be invoked and its parameters. The XML must adhere to the WSDL standards. |
#[payload] |
|
Returns
Return Java Type | Description |
---|---|
XMLStreamReader |
XML containing the result of invoking the Apex method |
Invoke apex rest method
<sfdc:invoke-apex-rest-method>
DataSense enabled
Invokes any operation from an Apex class that is exposed as REST web service
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
restMethodName |
The Apex class method name that will be invoked using REST |
x |
||
input |
A Map containing the URLParameters if necessary and the request body information (if the http method allows input) |
#[payload] |
|
|
requestHeaders |
The reference to an ApexRequestHeaders object containing request headers and cookies |
|
||
queryParameters |
The query parameters that will be added to the request URL |
|
Push generic event
<sfdc:push-generic-event>
Pushes generic streaming custom events to the specified streaming channel.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
events |
The event list |
#[payload] |
|
|
channelId |
The streaming channel name |
x |
Returns
Return Java Type | Description |
---|---|
A list containing information about each messages push result |
Reset password
<sfdc:reset-password>
Resets the password of the user linked to the connector's configuration.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
Returns
Return Java Type | Description |
---|---|
ResetPasswordResult |
instance of ResetPasswordResult containing generated password |
Change own password
<sfdc:change-own-password>
Changes the password of the user linked to the connector's configuration.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
oldPassword |
Old password of the account |
x |
||
newPassword |
New password of the account |
x |
Returns
Return Java Type | Description |
---|---|
ChangeOwnPasswordResult |
instance of ChangeOwnPasswordResult containing the result of the operation |
Find duplicates by ids
<sfdc:find-duplicates-by-ids>
DataSense enabled
Performs id-based searches for duplicate records. The input is an array of ids to be used to detect the duplicates. The output identifies the detected duplicates for each id.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
- type of sobjects to find duplicates for |
x |
||
ids |
- list of object ids used when searching for duplicates |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
list of found duplicate results containing information about the objects found as duplicates, one for each id specified |
Find duplicates
<sfdc:find-duplicates>
DataSense enabled
Performs rule-based searches for duplicate records. The input is an array of sObject, each of which specifies the values to search for and the type of object that supplies the duplicate rules. The output identifies the detected duplicates for each object that supplies the duplicate rules. findDuplicates() applies the rules to the values to do the search. The output identifies the detected duplicates for each sObject.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
type |
- type of sobjects to find duplicates for |
x |
||
criterion |
- list of SObject used as a criterion when searching for duplicates |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
list of found duplicate results containing information about the objects found as duplicates, one for each SObject in criterion list |
Batch info list
<sfdc:batch-info-list>
Get information about all batches in a job.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
jobId |
- id of the job that you want to reatrieve batch information for |
x |
||
contentType |
ContentType |
- content type used at job creation. If not provided default value used is ContentType.XML. |
|
Returns
Return Java Type | Description |
---|---|
BatchInfoList |
BatchInfoList associated to given job |
Publish platform event message
<sfdc:publish-platform-event-message>
DataSense enabled
Adds one new platform event to your organization's data.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
platformEventName |
name of platform event to create |
x |
||
platformEventMessage |
PlatformEventMessage to create |
#[payload] |
|
|
headers |
Salesforce Headers More Info |
|
Returns
Return Java Type | Description |
---|---|
An array of { SaveResult} |
Sources
Subscribe topic
<sfdc:subscribe-topic>
Subscribe to a topic. First the topic must be published and after that a subscription to that topic created. Attention: Salesforce lets you subscribe to an nonexistent topic but won't send you notifications after the topic is created.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
topic |
The name of the topic to subscribe to |
x |
||
callback |
SourceCallback |
The callback to call when a message is received |
x |
Returns
Return Java Type | Description |
---|---|
StopSourceCallback |
org.mule.api.callback.StopSourceCallback |
Subscribe streaming channel
<sfdc:subscribe-streaming-channel>
Subscribe to a streaming channel. First the streaming channel must be published and after that a subscription to that channel created. Attention: Salesforce lets you subscribe to an inexistent streaming channel but won't send you notifications after the topic is created.
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
streamingChannel |
The name of the streaming channel to subscribe to |
x |
||
callback |
SourceCallback |
The callback to call when a message is received |
x |
Returns
Return Java Type | Description |
---|---|
StopSourceCallback |
org.mule.api.callback.StopSourceCallback |
Replay topic
<sfdc:replay-topic>
Salesforce stores events for 24 hours and allows you to retrieve stored and new events. Subscribers can choose which events to receive by using replay options:
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
topic |
The name of the topic to subscribe to. |
x |
||
replayOption |
Enum with the following values: ONLY_NEW: -1 Subscriber receives new events that are broadcast after the client subscribes. ALL: -2 Subscriber receives all events, including past events that are within the 24-hour retention window and new events sent after subscription. FROM_REPLAY_ID: Subscriber will receive only events with replay id value greater than specified replayId. |
x |
||
replayId |
Subscriber receives all events after the event specified by its replayId value. The value is ignored if replay option is set on ALL or ONLY_NEW. |
x |
||
autoReplay |
boolean |
If true, when source is started it will start to consume data from when it was left last time. |
false |
|
callback |
SourceCallback |
The callback to call when a message is received. |
x |
Returns
Return Java Type | Description |
---|---|
StopSourceCallback |
org.mule.api.callback.StopSourceCallback |
Replay streaming channel
<sfdc:replay-streaming-channel>
Salesforce stores events for 24 hours and allows you to retrieve stored and new events. Subscribers can choose which events to receive by using replay options:
Attributes
Name | Java Type | Description | Default Value | Required |
---|---|---|---|---|
config-ref |
Specify which config to use |
x |
||
streamingChannel |
The name of the streaming channel to subscribe to |
x |
||
replayOption |
Enum with the following values: ONLY_NEW: -1 Subscriber receives new events that are broadcast after the client subscribes. ALL: -2 Subscriber receives all events, including past events that are within the 24-hour retention window and new events sent after subscription. FROM_REPLAY_ID: Subscriber will receive only events with replay id value greater than specified replayId |
x |
||
replayId |
Subscriber receives all events after the event specified by its replayId value. The value is ignored if replay option is set on ALL or ONLY_NEW. |
-2 |
|
|
autoReplay |
boolean |
- if true, when source is started it will start to consume data from when it was left last time |
false |
|
bufferSizeInBytes |
specifies the buffer size |
|
||
callback |
SourceCallback |
The callback to call when a message is received |
x |
Returns
Return Java Type | Description |
---|---|
StopSourceCallback |
org.mule.api.callback.StopSourceCallback |