Salesforce

Application configuration is an integral activity prior to the process of integration. If your chosen application is Salesforce, credentials need to be provided for validating the agent. Here you will find the detailed description on how to configure the agents for the application of Salesforce, Troubleshooting issues and the attributes and action.

Salesforce is a REST Application which supports OAUTH 2.0 authentication. The Adapter of the application Salesforce provides the leverage to communicate and adapt with the AEC Portal. This section provides you the detailed process of validating the credential of the application Salesforce.

Pre-requisites for Salesforce Configuration

• Valid APPSeCONNECT Portal credentials.
• Select the Application Salesforce in the APP section.
• Create connection for Salesforce.
• Publish any Touchpoint, Update Adapters and Update Configuration in the agent.

Configure the Agent

To Know about Agent Configuration, Click here

Configure the Salesforce Application in the Agent

1. In the App Configuration panel of the agent, click on the + button, beside the app Salesforce.
2. Click the + button, the credential panel opens for the application Salesforce.
   
3. To Validate the adapter for Salesforce you will need the Consumer Secret and Consumer Key.
4. To generate these credentials, login to the Salesforce Application. This will take you to the default home page.
5. In the Home page of Salesforce, navigate to Setup Module.
   
6. Click the Setup icon from the drop-down list.
7. Navigate to Apps > App Manager. Now, you can view the APP Manager page.
8. Click New Connected App button.
   
9. Enter name of your application, API Name, Contact email information, as well as any other information appropriate for your application and click on the checkbox to enable the Oauth Settings.
10. Enable the checkbox, enter the callback URL and select the OAuth scope as Full Access for complete access.
    Note: User can select the desired scopes as these scopes refer to permissions given by the user running the connected app.

Note: Callback URL is the URL that a user browser is redirected to after successful authentication. As this URL is used for some OAuth flows to pass an access token, the URL must use secure HTTP (HTTPS) or a custom URI scheme.

• Provide the details, click SAVE button. Now you will get the following window with the Consumer Key and Consumer Secret generated. To view the Consumer Secret, press Click to Reveal button. Note:It takes 15-20 mins to reflect the Oauth2.0 settings in the Salesforce portal. Once it reflects, you can copy the generated credentials for validation process.

• On the Profile icon, click settings button to generate the Security Token.
  

• From the My Personal Information dropdown, Click on Reset My Security Token.
  
  Note: The Security Token would be sent to the Email that was provided while creating the Salesforce Account.

• Enter all the generated credentials in the OP Agent for the validation process. Click SAVE followed by the Validate Button.
  
  Following this process, the Salesforce application can be configured in the agent.

Troubleshooting

ISSUE 1:Source Application Data Not Found

Source Application Data Not Found even if Data is present is the Source Application.

Some of the basic troubleshooting issue happens due to improper validations or even if it is accurately validated and if touchpoints do not sync. This basic issue resolves after removing the Temp and Cache files from the portal and from your system. Therefore, after clearing all this, you need to publish the touchpoints again along with Update Configuration on the agent.

For E.g. If the Source Application Data Not Found in the log file appears, the probable cause is due to the presence of the Temp and Cache Files.

Note: Integration between SAP B1 and Salesforce requires UDT & UDF creations

Attributes and Actions

While defining a connect to an API endpoint in Salesforce, you require clear understanding about the data requirements and endpoint configurations. You can refer to this document to find all the endpoint details of your Salesforce installation. To define the endpoint in APPSeCONNECT, you need to define Actions and Entities. Actions are specifically targeted for an endpoint while schema is the data needed to execute the API. Here is the list of some of the pre-packaged API actions defined for you which you can easily plug and play while doing your integration.

Endpoint	Action	Action Type	Schema	UI Help	API Path
/query	/query	GET	Contact	Fetching Contacts from Salesforce and posting into Destination Application	-
/query	/query	GET	order	Fetching sales orders from Salesforce and posting to destination application	API for fetching sales orders from Salesforce
/query	/query	GET	Accounts	Fetching customer Account from Salesforce and posting to destination application	-
POST	POST	Post	Product2	Posting product from source application to Salesforce	-
POST	POST	Post	Contact	Posting Contact from Source application to Salesforce	-
PATCH	PATCH	Patch	Account	Updating Accounts from Source Application to Salesforce	-