Edit

Share via

Import Electronic reporting (ER) configurations from Dataverse

  • Article

Important

Regulatory Configuration Service (RCS) will be deprecated. All new RCS provisioning is stopped as of 10.0.39 GA. If provisioning is required, please register a support ticket. We will be providing tools and required support for migration from RCS to the Globalization Studio workspace. We plan to fully shut down RCS by August 1, 2024. For more information about migration to Globalization Studio workspace, see Regulatory Configuration Service merge to the Globalization Studio workspace

This article explains how to import Electronic reporting (ER) configurations from Microsoft Dataverse.

Set up integration with Dataverse

To use this functionality, you should have a Dataverse environment that's connected to your Dynamics 365 Finance environment. For more information, see the following articles:

You should also add a security role to access tables in Dataverse by following these steps:

  1. Create a new security role as described in Create or edit a security role.
  2. In that security role add Create, Read, Write, Delete, Append, Append to, Assign, Share permissions for Organization to the following tables: Electronic Reporting Configuration File, Electronic Reporting Configurations Index File, Globalization Feature File, and Globalization Features Index File.
  3. Assign the created security role to users as described in Assign security roles.

Import the Globalization solution

This functionality uses the Microsoft Dataverse Web API.

You can import the Globalization solution by following these steps.

  1. Go to Globalization Solution for Microsoft Dynamics 365 Finance on AppSource.
  2. Select Get it now.
  3. Fill in the required data.
  4. Select an environment, and then select Install.

Import configurations from Dataverse

A new type of repository for getting ER configurations in Dynamics 365 Finance is added. This repository is known as the Dataverse configuration repository. It enables the same user interface (UI) that the Dataverse enables. Therefore, you can import single and filtered configurations.

Open the Dataverse configuration repository

To open the Dataverse configuration repository, follow these steps.

  1. Sign in to the Dynamics 365 Finance app by using one of the following roles:

    • Electronic reporting developer
    • Electronic reporting functional consultant
    • System administrator

  2. Go to Organization administration > Workspaces > Globalization studio.

  3. In the Configuration providers section, select the Microsoft tile.

  4. On the Microsoft tile, select Repositories.

    Screenshot that shows the tile for the Microsoft configuration provider in the Globalization Studio workspace.

  5. On the Configuration repositories page, in the grid, select the existing repository of the Dataverse type. If this repository doesn't appear in the grid, follow these steps:

    1. Select Add to add a repository.
    2. Select Dataverse as the repository type, and then select Create repository.
    3. If you're prompted for authorization, follow the on-screen instructions.
    4. Enter a name and description for the repository, and then select OK to confirm the new repository entry.
    5. In the grid, select the new repository of the Dataverse type.

  6. Select Open to view the list of ER configurations for the selected repository.

Import a single configuration

Note

It may take up to two weeks for a new ER configuration released by Microsoft or a new version of an ER configuration released by Microsoft to appear in the Dataverse configuration repository. If the configuration update is expected but does not appear in the Dataverse configuration repository, or if auto-updates are disabled in your environment, you can also manually trigger the update of the Globalization solution package in your Power Platform admin center (PPAC) portal. See Manage Dynamics 365 apps for more details on how to update solutions in PPAC.

To import a single configuration, follow these steps.

  1. On the Configuration repository page, in the configurations tree, select the ER configuration that you want.

  2. On the Versions FastTab, select the required version of the selected ER configuration.

  3. Select Import to download the selected version from the Dataverse to the current Dynamics 365 Finance instance.

    Note

    The Import button is unavailable for ER configuration versions that are already present in the current Dynamics 365 Finance instance.

Screenshot of the Configuration repository page, where a version of a configuration is selected for import.

Import filtered configurations

To import filtered configurations, follow these steps.

  1. On the Configuration repository page, on the Filter FastTab, in the Tags grid, add any tags that are needed.
  2. In the Country/region applicability field, select the appropriate country/region codes.
  3. Select Apply filter.
  4. The Configurations FastTab shows all the configurations that satisfy the specified selection conditions. Select Import to download the filtered configurations from Dataverse to the current Dynamics 365 Finance instance.
  5. Select Reset filter to clean up the specified selection conditions.

Screenshot of the Configuration repository page, where a Country/region applicability filter is applied.

Note

Depending on the ER settings, configurations are validated after they're imported. You might be notified about any inconsistency issues that are found. Before you can use the imported configuration version, you must fix the issues. For more information, see the list of related resources for this article.

ER configurations can be configured as dependent on other configurations. Therefore, when you import a selected configuration, other configurations might be automatically imported. For more information about configuration dependencies, see Define the dependency of ER configurations on other components.