User Guide > Process Steps and Components > Invoker Step > Salesforce Login Invoker
Was this helpful?
Salesforce Login Invoker
Salesforce Login Invoker uses the Salesforce login API call to log in to salesforce.com with username, password, and endpoint address properties as inputs. It then returns the session ID and server URL as properties in the target message object.
You can use the sessionID and serverURL to construct a session token, which allows you to connect to salesforce.com multiple times without having to log in repeatedly. You can also use the session token with the Salesforce.com connector. For information on how to set up and use session tokens, see the Salesforce connector section.
You should be familiar with Salesforce.com Web services before using this component.
Note:  The Salesforce Login invoker is SHA-256 compliant and it supports Salesforce API version 54.0.
Supported Actions
Action
Description
Execute
Executes the supported parameters and properties.
 
Supported Action Parameters
Action
Parameter
Description
Execute
SourceMessage
Name of the Source message for the invoker
TargetMessage
Name of the Target message for the invoker
Supported Action Properties
Action
Property
Description
Execute
UserName
Username to access salesforce.com.
Password
The password to authenticate the above username.
Endpoint Address
URL for salesforce.com endpoint. The default is https://www.salesforce.com/services/Soap/u/54.0.
If you do not set this option, the invoker uses the default. The default setting is based on the WSDL version. You can change the number in the URL to any supported version, including versions 21.0 to 54.0.
When you call this option, use EndpointAddress as shown in this example:
sourceMsg.properties("EndpointAddress") = "https://www.salesforce.com/services/Soap/u/54.0"
All invoker property values can be specified as properties in the Source Message, and those properties override any invoker property values.
For example, assume you have a Script step before the invoker that contains the following:
sourceMsg.properties("EndpointAddress") = "https://www.salesforce.com/services/Soap/u/10.0"
The sourceMsg in the Script step is used as the endpoint address for the invoker. No matter what value is specified in the EndpointAddress invoker property, the sourceMsg property is used as the endpoint address.
Errors
If the invoker encounters a problem while performing tasks, it displays an error message describing the failure. The following table describes some of the more common errors.
Code
Name
Description
Possible Reason
46
LICENSING
A valid product license is not found.
You must have a valid license tor this component in order to use it.
34
INVALID
The invoker could not log in to Salesforce.com.
The username or password may be incorrect or the server may be unavailable. For more information, see the process log.
50
UNSPECIFIED
An unknown error occurred while loading the component.
For more information, see the process log.
Last modified date: 10/22/2024