Configuring Utility Operation Adapter Services
Use the Utility Operation template to configure an adapter service that invokes one of the following Salesforce.com utilities:
getServerTimestamp to retrieve the current Salesforce.com system timestamp.
getSessionId to obtain a session ID or an access token that you use to implement custom Salesforce.com operations that the adapter does not support. If you use a normal Salesforce.com connection, getSessionId will return a session ID. If you use an OAuth Salesforce.com connection, getSessionId will return an access token.
getUserInfo to obtain personal information about the currently logged-in user, that is, the user account used for the adapter connection. Your adapter service might obtain this information to use for display purposes.
resetPassword to change a user's password to a temporary, system-generated value.
sendEmail to send a single e-mail message.
sendMassEmail to send multiple e-mail messages.
setPassword to change the password of a user's password to a specified value.
You select the utility that you want the adapter service to execute. The input and output signatures of the adapter service are based on the inputs and outputs of the selected utility. For more information about utilities and parameters that a utility expects as input or returns as output, see the Force.com Web Services API Developer's Guide.
To configure an adapter service that uses the Utility Operation template
2. Start Designer.
3. Right-click the package in which the service should be contained and select New > Adapter Service.
4. Select the parent namespace, type a name for the adapter service, and click Next.
5. Select Adapter for Salesforce as the adapter type and click Next.
6. Select the appropriate Adapter Connection Name and click Next.
Important:
Ensure the Salesforce.com user account identified by the connection has all the required permissions to execute the utility that you will select later in the procedure.
7. From the list of available templates, select the Utility Operation template and click Finish.
The adapter service editor for the adapter service appears. You can select the Adapter Settings tab at any time to confirm adapter service properties such as the Adapter Name, Adapter Connection Name, and Adapter Service Template, as necessary.
8. Identify the utility that you want the adapter service to invoke.
a. Select the Utility Operation tab.
b. From the Utility Call list, select the utility you want to use.
9. View the Input Fields tab to see the inputs for the utility and the Output Fields tab to see the outputs that the utility returns. For a description of the input and output fields, see the Force.com Web Services API Developer's Guide.
10. Select File > Save to save the adapter service.