Using local environment variables with Salesforce nodes (no discovery)

The SalesforceRequest (no discovery) node supports a number of local environment message tree variables, which you can use to dynamically alter the values that are set in the node properties.

Note: SalesforceRequest (no discovery) is the new name for the node that was called SalesforceRequest in previous versions of IBM® App Connect Enterprise (up to and including V12.0.4), and it continues to operate in the same way as in previous versions.

In IBM App Connect Enterprise 12.0.5 (and later versions), a new Salesforce Request node is provided, which you configure by using a Connector Discovery wizard to discover and set properties for the Salesforce connector. For information about using this feature, see Using Salesforce with IBM App Connect Enterprise and Salesforce Request node.

The following table shows the environment variables that can be set to control the behavior of the SalesforceRequest (no discovery) node:
Local environment variable Type Description
LocalEnvironment.Destination.Salesforce.Request.url string The URL of the external Salesforce system.

Overrides the Salesforce URL property on the SalesforceRequest (no discovery) node.
LocalEnvironment.Destination.Salesforce.Request.operation string The operation to be requested on the Salesforce system:
  • Create
  • Update
  • Retrieve
  • Delete

This environment variable overrides the Operation property on the SalesforceRequest (no discovery) node.
LocalEnvironment.Destination.Salesforce.Request.object string The Salesforce object type for the request.

This environment variable overrides the Salesforce object property on the SalesforceRequest (no discovery) node.
LocalEnvironment.Destination.Salesforce.Request.id string The Salesforce ID of a Salesforce record. This value is used for the following operations:
  • Retrieve (optional)
  • Update (optional)
  • Delete (required)

This Salesforce Id is assigned to a record when it is created on the Salesforce system.
LocalEnvironment.Destination.Salesforce.Request.externalIdName string The name of an external ID field of a Salesforce record. This value is used for the following operations:
  • Retrieve (optional)
  • Update (optional)
LocalEnvironment.Destination.Salesforce.Request.externalId string The external ID of a Salesforce record. This value is used for the following operations:
  • Retrieve (optional)
  • Update (optional)
LocalEnvironment.Destination.Salesforce.Request.filter structure The filter to be used for restricting the records returned by a Retrieve operation. For more information, see Retrieving Salesforce records (no discovery).
LocalEnvironment.Destination.Salesforce.Request.timeoutMilliseconds integer The time (in milliseconds) that the node waits for Salesforce to process the operation.

This environment variable overrides the Timeout (milliseconds) property on the SalesforceRequest (no discovery) node.