Configuring DataSource with Salesforce in AEM Forms 6.3 and 6.4 configuring-datasource-with-salesforce-in-aem-forms-and
Prerequisites prerequisites
In this article, we walk through the process of creating Data Source with Salesforce
Prerequisites for this tutorial:
-
Scroll to the bottom of this page and download the swagger file and save it your hard drive.
-
AEM Forms with SSL enabled
-
You need to have Salesforce Account
-
You need to create a Connected App. The official documentation form Salesforce for creating the app is listed here.
-
Provide appropriate OAuth Scopes for the App(I have selected all the available OAuth Scopes for the purpose of testing)
-
Provide the callback URL. The callback URL in my case was
-
If you are using AEM Forms 6.3, the callback URL is https://gbedekar-w7-1:6443/etc/cloudservices/fdm/createlead.html. In this URL createlead is the name of my form data model.
-
If you are using** AEM Forms 6.4**, the callback URL is https://gbedekar-w7-:6443/libs/fd/fdm/gui/components/admin/fdmcloudservice/createcloudconfigwizard/cloudservices.html
-
In this example gbedekar -w7-1:6443 is the name of my server and the port on which AEM is running.
Once you have created the Connected App note the Consumer Key and Secret Key. You need these when creating the data source in AEM Forms.
Now that you have created your connected app, you need to create a swagger file for the operations that you need to perform in salesforce. A sample swagger file is included as part of the downloadable assets. This swagger file allows you to create “Lead” object on Adaptive Form submission. Please explore this swagger file.
The next step is to create Data Source in AEM Forms. Please follow the following steps according to your AEM Forms version
AEM Forms 6.3 aem-forms
-
Login to AEM Forms using the https protocol
-
Navigate to cloud services by typing in https://<servername>:<serverport> /etc/cloudservices.html, For example, https://gbedekar-w7-1:6443/etc/cloudservices.html
-
Scroll down to “Form Data Model”.
-
Click on “Show Configurations”.
-
Click “+” to add new configuration
-
Select “Rest Full Service”. Provide meaningful Title and Name to the configuration. For instance,
- Name: CreateLeadInSalesForce
- Title: CreateLeadInSalesForce
-
Click “Create”
**In the next screen **
- Select “File” as the option for your swagger source file. Browse to the file you downloaded earlier
- Select Authentication Type as OAuth2.0
- Provide the ClientID and Client Secret values
- OAuth Url is - https://login.salesforce.com/services/oauth2/authorize
- Refresh Token Url - https://na5.salesforce.com/services/oauth2/token
- Access Toke Url - https://na5.salesforce.com/services/oauth2/token
- Authorization Scope: ** api chatter_api full id openid refresh_token visualforce web**
- Authentication Handler: Authorization Bearer
- Click on "Connect To OAUTH ".If everything goes well, you should not see any errors
Once you have created your Form Data Model using Salesforce, you can then create Form Data Integration using the Data Source that you have just created. The official documentation for creating Form Data Integration is here.
Make sure you configure the Form Data Model to include the POST service to create a Lead object in SFDC.
You will also have to configure Read and Write Service for the Lead object. Please refer to the screenshots at the bottom of this page.
After creating the Form Data Model, you can create Adaptive Forms based on this model and use the Form Data Model submission methods to create Lead in SFDC.
AEM Forms 6.4 aem-forms-1
-
Create Data Source
-
Click the “Create” button
-
Provide some meaningful values
- Name: CreateLeadInSalesForce
- Title: CreateLeadInSalesForce
- Service Type: RESTful service
-
Click Next
-
Swagger Source: File
-
Browse and select the swagger file that you have downloaded in the previous step
-
Authentication Type: OAuth 2.0. Specify the following values
-
Provide the ClientID and Client Secret values
-
OAuth Url is - https://login.salesforce.com/services/oauth2/authorize
-
Refresh Token Url - https://na5.salesforce.com/services/oauth2/token
-
Access Token Ur l - https://na5.salesforce.com/services/oauth2/token
-
Authorization Scope: ** api chatter_api full id openid refresh_token visualforce web**
-
Authentication Handler: Authorization Bearer
-
Click on “Connect to OAuth” button. Should you see any errors, please review the preceding steps to ensure all of the information was entered accurately.
Once you have created your Data Source using SalesForce, you can then create Form Data Integration using the Data Source that you have just created. The documentation link for that is here
Make sure you configure the Form Data Model to include the POST service to create a Lead object in SFDC.
You will also have to configure Read and Write Service for the Lead object. Please refer to the screenshots at the bottom of this page.
After creating the Form Data Model, you can create Adaptive Forms based on this model and use the Form Data Model submission methods to create Lead in SFDC.
