DQ Email Authentication works across all entities and allows users to identify whether or not an email address is authentic.
This is a step-by-step user guide to help you download, install, and configure the latest DQ Email Authentication solution for Microsoft Dynamics CRM.
1. Firstly, download the following:
*The DQ Additional Info solution is used to store additional information retrieved from the DQ Capture Solutions. If you have previously installed this solution you can ignore this step.
2. Go to Dynamics 365 Settings > Solutions > Import and select the DQ_Email_Authentication.zip file.
If you have already installed the Additional Info solution, then you can ignore step 3 and 4 and continue with step 5.
3. Download the DQ Additional Info solution.
4. Go to Dynamics 365 Settings > Solutions > Import and select the DQ_Additional_Info_3_0_0_0_managed.zip
5. Click Next and Publish All Customization.
Once completed, you need to include the DQ Email Authentication control in the relevant entity. In this example we will apply the DQ Email Authentication Control to the Contact Entity. To configure the solution:
Go to Settings > Customization > Customize the System
Expand the Entities section,
Find the Entity you wish to add the DQ Email Authentication functionality to and then select ‘Forms’ on the appropriate entity:
Here we have selected Entities > Account > Forms,
Select the appropriate form layout and select Form Properties.
6. Select the Email field which you would like to add the DQ Email Authentication functionality.
7. In our example, we have selected the emailaddress1 (Email) field. Double click on field to open control properties.
8. Head to the Controls tab and select Add Control…
9. Select DQ Email Authentication and select Add
10. Select the platforms in which you would like to utilise the control. (If unsure, select all 3).
11. Select the third party provider you would like to use from the list provided.
12. Enter the API Key and password provided to you by DQ Global.
Enter API Key.
13. Update Endpoint URL if it’s different than default one provided.
14. Map Authentication Date to an existing field if desired. If unmapped, Authentication Date can be found within Additional Info.
15. Map Authentication Result to an existing field if desired. If unmapped, Authentication Result can be found within Additional Info.
16. Make sure Initiate Request is set to Button.
17. Enable Additional Info to True if you would like to return additional information from your selected Third-Party provider.
18. All remaining fields are optional and can be mapped if desired. If left unmapped, they will populate the Additional Info table.
If you have previously installed and configured the DQ Additional Info Solution, you can ignore this section.
We will now setup the DQ Additional Info grid.
19. Select One Column (1 Tab) from the Insert section.
Update the Tab label to ‘DQ Additional Info’.
20. To add the Sub Grid for Additional Info, select the newly created ‘DQ Additional Info’ tab and click on the Sub-Grid Menu Item from the top menu.
The Set Properties dialog box will appear as shown below, we will need to update the Data Source Section.
21. Using the Data Source section, we can bind the DQ Additional Info entities.
Firstly, give any valid Unique Name in Name field.
After, inside Data Source Section, we will select the ‘DQAccountAdditionalInfos’ Entity and 'DQAdditionalInfoView' as Default View.
22. To show more rows of Additional Info data per page, we will update the Number of Rows field to 10 within the Formatting Tab.
After, select OK to close the dialog box.
23. Once you have completed your configurations, Save and Publish the form.
24. Once your customizations have been published, go to the same form you published the control. (In our example we applied it to the Contact entity).
25. Go to New
Note: If you have enabled Additional Info then you must save the record before DQ Email Authentication will work.
The DQ Email Authentication control should look like this:
26. Enter an email address to test the DQ Email Authentication solution.
An authentic email return a green tick as seen below:
An inauthentic email however, will return a red cross as seen below:
After authenticating an email, the tool will populate the Additional Info table if Additional Info was set to 'True' within configuration.