Labs ER v2
Labs ER v2
Objective:
In this lab, you will set up the basic functionality for Electronic Reporting (ER) and
create a new configuration provider that will be used in subsequent labs.
Why This Matters:
Before you can use ER to generate reports or export/import configurations, you must
configure the system and create a provider. The provider helps manage where the ER
data comes from and how it is used in the system.
Instructions:
1. Open the Electronic Reporting Workspace:
o Navigate to Dynamics 365 Finance and Operations.
o Go to the Electronic Reporting workspace under Organization
administration.
2. Set Up Electronic Reporting Parameters:
o In the App links section, select Electronic reporting parameters.
o On the General tab, turn on Enable design mode. This allows you to use
the ER design tools.
o On the Attachments tab, define the types of documents used for storage,
such as:
Office documents as templates for reports.
File storage for report outputs.
Storage for configuration output baselines and handling files.
o Question: Why do we need to enable design mode before proceeding?
3. Create a New Configuration Provider:
o Go to Related links > Configuration providers.
o Select New.
o In the Name field, type Litware, Inc..
o In the Internet address field, type https://www.litware.com.
o Select Save.
4. Activate the Provider:
o Select the provider Litware, Inc..
o Click Set active to activate the provider.
o Question: What happens if we don’t activate the provider?
Hint: Think about what happens when a provider is inactive.
Follow-up Task:
Repeat this process to create and activate another configuration provider for a
different organization, such as Contoso Ltd. (https://www.contoso.com).
Objective:
You will learn how to export an Electronic Reporting (ER) configuration as an XML file,
which can be used for backups or importing into other environments.
Why This Matters:
Exporting configurations allows you to reuse them in different environments or share
them with other users. This is especially useful for compliance, reporting consistency,
and system migrations.
Instructions:
1. Navigate to the Electronic Reporting Workspace:
o Open Dynamics 365 Finance and Operations.
o Go to the Electronic Reporting workspace.
o Select Configurations, then go to Reporting Configurations.
2. Search for the Configuration:
o In the left pane, use the search bar to find Invoice model.
o Under Invoice model, locate Free text invoice (Excel).
3. Select the Configuration:
o Click on the configuration you want to export, such as Free text invoice
(Excel).
4. Export the Configuration:
o In the Versions tab on the right, find and click the Exchange button.
o From the dropdown, select Export as XML file.
5. Download the XML File:
o The configuration will be downloaded as an XML file to your local
computer.
6. Important:
o Make sure the configuration is in Completed or Shared status before
exporting.
o Question: Why do we need the configuration to be in Completed or
Shared status before exporting?
Follow-up Task:
Export another configuration (e.g., for GST Returns) and ensure it’s saved as
XML. Once done, compare the two XML files and note the differences in their
structure.
Objective:
In this lab, you will create a new data model for Sales Orders, add necessary fields
(nodes), design a format for how this data will be presented in an Excel report, map the
fields, and generate the report to see the final output.
Scenario:
You are a business analyst tasked with creating a custom report for Sales Orders in
Dynamics 365. The report should include information like Customer Name, Order
Amount, Order Date, and Sales Order Number. You will build the report using
Electronic Reporting (ER) by first defining a data model, creating a format, and finally
generating an Excel file for review.
Follow-up Tasks:
1. Customize the Format: Add an Excel template for more control over the layout
of the report, such as custom headers, fonts, or borders.
2. Add New Fields: Extend the data model to include additional fields like Payment
Terms, Shipping Address, or Discounts, and update the format accordingly.
Expected Outcome:
By the end of this lab, you will have successfully created a data model, designed a
report format, and generated an Excel report with Sales Order details. This report will be
ready for use by other departments for reviewing and analyzing sales orders.
Lab 5: Defining ER Model Mappings and Selecting Data
Sources
Objective:
In this lab, you will learn how to define model mappings for an Electronic Reporting (ER)
configuration and select appropriate data sources. The example scenario involves
mapping a payment data model for credit transfers.
Expected Outcome:
You have now successfully created model mappings, defined data sources, and created
calculated fields for the ER configuration. You should be able to use this mapping to
generate reports with credit transfer payment data.
Lab 6: Designing a Domain-Specific ER Data Model for
Payments
Objective:
In this lab, you will design a domain-specific Electronic Reporting (ER) data model for
processing payment documents. You will define structures for parties, banks, and
payment transactions, creating a data model to support credit transfer payments. This
data model will later be used as a data source when formatting payment documents.
Expected Outcome:
You have successfully created a domain-specific data model for handling payment
information, including parties, bank details, and payment transactions. This data model
can now be used to define formats for generating payment documents.
Objective:
Learn how to troubleshoot data mapping issues in an existing ER setup and fix incorrect
or missing mappings between data sources and model components.
Instructions:
1. Access Existing Configuration:
o Go to Organization administration > Workspaces > Electronic
reporting.
o Open an existing configuration, preferably related to sales or payments.
2. Review Data Model Mapping:
o Open the Designer for the selected configuration.
o Navigate to Map model to datasource.
o Inspect the existing mappings and identify where data is missing or
incorrectly mapped.
o Question: What is the difference between ‘map format to model’ and
‘Model to Datasource Mapping’?
o Question: What is the difference between mapping in the Designer and
the model mapping options in the list view?
3. Troubleshoot Mappings:
o Check if there are any red error indicators next to model components.
o Click on each mapping and verify that the correct data source is selected.
4. Fix Mapping Issues:
o For components with incorrect mappings, remap them to the correct data
sources by selecting the appropriate table or field.
o Save the configuration after making the changes.
Expected Outcome:
You will have identified and resolved incorrect or missing data mappings, ensuring that
all required fields are properly linked to their data sources.