Data Quality user documentation
home/Integrations/Microsoft D365 CE PCF/Get started/Install or upgrade

Install or upgrade

There are two ways you can install the Experian Data Validation Microsoft Dynamics 365 PCF Control solution:

1. AppSource

  1. Go to Microsoft AppSource.
  2. Click Get it Now.
  3. Sign in.
  4. Fill out the mandatory information on the Experian Data Validation for Dynamics 365 CRM pop up, and agree to the Microsoft Permissions.
  5. Click Continue which will take you through to the Power Platform admin center.
  6. On the right hand side you should see an install window. Select the environment you want to install the solution into, and agree to both Microsoft's legal and privacy statement.
  7. Click Install.

You should then be taken to your environment and see the Experian Data Validation for Dynamics 365 CRM solution in the app list and its status.

This will install into the environment you have selected, but also at the tenant level. This means you then can activate the solution in other environments. To do this, view this Microsoft Dynamics 365 guide.

Our Sales team will then be in touch to get you set up with licenses and provide you with authentication tokens. They will contact you via the details you entered while installing the solution.

2. Uploading file directly

  1. Contact Support.
  2. Open the email you will have received from Experian.
  3. Follow the instructions in this email to access and download the Experian Data Validation for Microsoft Dynamics 365 solution files onto your local drive.

To import the solution files:

  1. Select Solutions from the left hand menu of the main Power Apps interface.
  2. Click Import solution in the top panel.
  3. Click Browse and select the Experian Data Validation for Microsoft Dynamics 365 zip file on your computer.
  4. Click Next.
  5. Click Import.

  1. Select Advanced settings in the settings dropdown menu to the top right.

  2. Click the arrow to the right of Settings in the main header and then click Solutions under the Customization sub-menu.

    Main dashboard drop-down menu

  3. Click Import in the top bar of the All Solutions window.

  4. Click Choose file in the Import Solution pop-up window and select the Experian Data Validation for Microsoft Dynamics 365 zip file on your computer.

  5. Click Open.

  6. Click Next and then click Import to begin the import process.

  7. Click Close once this is complete.

3. Assign security role

From v4.1 onwards the Experian Data Validation for Microsoft Dynamics 365 solution has a built-in security role named ExperianDataValidationRole that should be assigned to users or teams (other than system administrators) that require access to the solution. The security role grants the following access to entities.

Custom Entity Access Level for user with security role
Address validation token Read
Email validation token Read
LookupMap Read
Mapping Read
OptionSetMap Read
Phone validation setting Read
TextMap Read
Customization Entity Access Level for user with security role
Solution Read

If the user does not have the access levels shown above then the solution will fail with "insufficient permission" errors reported.

Follow the steps below to add the security role to a team (similar steps can be used to assign the role to a user):

  1. From the Power Platform admin center home page, click the Environments link on the left navigation bar to open the Environments list page.
  2. Select the link for the environment to which the solution has been installed to open the Environment's page.
  3. On the right side of the page there is a panel titled Access with links to view all Security roles, Users and Teams.
  4. Click the See all link for Teams to be taken to the page that lists all the teams on that environment.
  5. Select the team which you would like to assign the ExperianDataValidationRole security role to and click the Manage Security roles menu option at the top of the page.
  6. In the list that opens find the ExperianDataValidationRole security role and select it.
  7. Click the Save button to assign the role to the team.
  1. On the Settings Security page (in the Classic UI) under the title "Which feature would you like to work with?" select Teams.
  2. Select the team which you would like to assign the ExperianDataValidationRole security role to and click the MANAGE ROLES menu option at the top of the page.
  3. In the Manage Team Roles dialog that appears select the checkbox for the ExperianDataValidationRole item from the list of security roles displayed.
  4. Click the OK button to assign the role to the team.

You can follow the same steps as found under the Installing tab above if you are upgrading a previous version. Note that if you are uploading the file directly, the only difference is that it will notify you: "This solution package contains an update for a solution that is already installed".

  • If you are upgrading from version 4.0.163 delete the security role that was created manually in that version as the security role is now built into the solution. Follow the steps below to delete the v4.0.163 security role:

    1. From the Classic view, go to Settings > Customizations > Customize the System.

    2. Expand the Security Roles in the left panel and locate the role ExperianDataValidationRole and delete it.

    3. If you are doing this after the import, there will be two security roles with the same name. In this case delete the one that is of State Unmanaged as shown below.

  • Visit the Products page of the Experian Data Validation Configuration Power App in order for any final upgrade actions to be initiated. If final upgrade actions are required they will be automatically initiated when you visit the page and upon successful completion you will see the notification "Data migrations successfully applied" displayed in the header of the page. If the message does not appear then no final upgrade actions were required. The solution is now ready to use.

Microsoft D365 CE PCF

Get started

Related Services