User Tools

Site Tools


dq_phone_authentication

DQ Phone Authentication

What is DQ Phone Authentication?

DQ Phone Authentication works across all entities and allows users to identify whether or not a phone number is authentic.

Installation Guide

This is a step-by-step user guide to help you download, install, and configure the latest DQ Phone Authentication solution for Microsoft Dynamics CRM.

Solution Download

1. Firstly, download the following:

DQ Phone Authentication

DQ Additional Info*

*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.


Form Setup

2. Go to Dynamics 365 Settings > Solutions > Import and select the DQ_Phone_Authentication.zip file.

If you have already installed the DQ 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 Phone Authentication control in the relevant entity. In this example we will apply the DQ Phone 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 Phone 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 Phone field which you would like to add the DQ Phone Authentication functionality.


Add Control

7. In our example we have selected the telephone1 (Business Phone) field. Double click on field to open control properties.

8. Head to the Controls tab and select Add Control…

9. Select DQ Phone Authentication and select Add.

10. Select the platforms in which you would like to utilise the control. (If unsure, select all 3).


Configure Control

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.

Enter Password.

13. Update Endpoint URL if it’s different than the default one provided.

14. Update the Default Country ISO 2 if applicable.

15. Map Authentication Date to an existing field if desired. If unmapped, Authentication Date can be found within Additional Info.

16. Map Authentication Result to an existing field if desired. If unmapped, Authentication Result can be found within Additional Info.

17. Make sure Initiate Request is set to Button.

18. Enable Additional Info to True if you would like to return additional information from your selected Third-Party provider.

19. All remaining fields are optional and can be mapped if desired. If left unmapped, they will populate the Additional Info table.


DQ Additional Info Setup

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.

20. Select One Column (1 Tab) from the Insert section.

Update the Tab label to ‘DQ Additional Info’.

21. 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.

22. 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.

23. 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.

24. Once you have completed your configurations, Save and Publish the form.


Control Testing

25. 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).

26. Go to New.

Note: If you have enabled Additional Info then you must save the record before DQ Email Authentication will work.

The DQ Phone Authentication control should look like this:

27. Enter a phone number to test the DQ Email Authentication solution.

An authentic phone number return a green tick as seen below:

An inauthentic phone number however, will return a red cross as seen below:

After authenticating a phone number, the tool will populate the Additional Info table if Additional Info was set to 'True' within configuration.


dq_phone_authentication.txt · Last modified: 2022/05/25 10:58 by hayden.law