Use the dual-write wizard to link your environments


Effective November 2020:

  • Common Data Service has been renamed to Microsoft Dataverse. For more information, see Power Automate Blog.
  • Some terminology in Microsoft Dataverse has been updated. For example, entity is now table and field is now column. For more information, see Terminology updates.

This topic will be updated soon to reflect the latest terminology.

  1. Sign in to the Finance and Operations app environment that you want to link to your Common Data Service environment.

  2. Go to Workspaces > Data management, and select the Dual Write tile.

    Dual Write tile

  3. Select New link to environment to open the Setup link to Common Data Service wizard.

  4. The Choose environment page lists all the Common Data Service environments where the signed-in user is an environment admin. Select the Common Data Service environment to link to, and then select Next.

    Choose environment page

  5. Select your legal entities, and then select Next.

    Select legal entities step

    A health check is run to verify that your system meets the requirements for enabling dual-write. The health check also verifies that all the prerequisites have been completed. If any health check test fails, make that you've completed all the prerequisites before you move on to the next step.

    In the following example, the test about whether access was granted to connect the apps failed. In this case, you must first grant access to connect the apps by the creating the appropriate application IDs. You must then rerun the wizard.

    Health check page

  6. Review the summary, privacy notice, and consent, and then select Create.

You've now linked your Finance and Operations app to the Common Data Service environment.


If you don't see your entity maps, or if you see a blank page, be sure to Apply the Dual-write application orchestration solution that you installed as part of the system requirements and prerequisities.

  1. Apply the dual-write application orchestration solution.

    In the Finance and Operations app, on the Dual-write page, select Apply Solution to apply the entity maps that you just downloaded and installed. After you apply the solution, you should see that the default entity maps are published.

    Applying the entity maps

You've now successfully imported and applied a Microsoft-published dual-write entity map solution to your environment.

Entity maps successfully linked

Next steps

Enable entity maps for dual-write