Data Migration Observations for Microsoft Dynamics 365 for Operations (AX7)

by | Updated January 3, 2018 | Dynamics 365 for Finance and Operations

This post is based on some of my initial findings with the Data Migration functionality and Data Entity platform in Microsoft Dynamics 365 for Operations (AX7).

In Microsoft Dynamics AX 2012 R3 I preferred to override the insertUpdate method of the DIEF entity class to gain access into the values of the staging and target tables to make business logic decisions. Now that Microsoft Dynamics 365 for Operations uses the Data Entity platform for integration scenarios, there is a new group of objects to use for insight into the data values at integration runtime.

Data Entities are SQL Views

First I think it is helpful to know that when you run the Data Entity wizard to create the data entity, a SQL view is created once the project in Visual Studio is synchronized with the database. For this example, I created a new data entity called CPRCustomersEntity. This entity is based on the CustTable table for the primary data source and I selected only two fields I care about (AccountNum and CreditRating) from that table. Later I will show how the custom entity will not allow new customer records to be inserted so it only supports updates through the added code.

The SQL view is created with the following select statement:

data-migration_chris

The joins are in the select statement of the view because of the data source relations to the DirpartyTable and DimensionSetEntity tables in the data entity. Those could be removed but I wanted to leave them in to illustrate how the SQL joins are created based on the data source relations of the entity.

Here is the entity in the designer view of Visual Studio:

data-migration_chris-2

Using Data Entity methods to add custom code

The two methods that I found available to use for my scenario are postLoad and persistEntity. I tried some others there were available from the Override context menu and it looks like there could be other methods to use like insertEntityDataSource and mapEntityToDataSource. But for now these two provide a means to add code or at least look at values at different times of the import.

I determined that the postLoad method runs prior to persistEntity. It could be used at a time when you need to know what the current data in the entity is and act on it if needed. Below the entity is returning a credit rating of ‘U\A’ for customer account ‘DE-001’.

data-migration_chris3

The persistEntity method can be used to view what the target data will be after the staging data has been loaded.

The value for the credit rating will be ‘Poor’ as this was the value I had in my import file. The debugger can be used to view the values:

data-migration_chris4

I also added the if statement to run the super method if there is an existing RecId. If there is no RecId, then we know this is a new record and this custom entity does not write new records to the CustTable table. An error message is then raised that the Customer Account does not exist.

Lastly, if the Customer Account is ‘US-002’, we will set the Credit Rating to ‘Excellent’. The import file had the value set to ‘Poor’ but this is an example of changing the target data via code:

data-migration_chris5

Finally, the custom error message can be found by going into the Execution details of the job and clicking on the ‘View staging data’ link to click on the record with the error:

data-migration_chris6

data-migration_chris7

data-migration_chris8

I hope this post was helpful in showing one way to add code to manipulate data and integration processing for the new Data Migration functionality in Microsoft 365 for Operations.

Related Posts

0 Comments

Submit a Comment

Your email address will not be published. Required fields are marked *

Upcoming Events

september

02sep10:00 am10:30 amThe Modern Manufacturer - Cycle Count Management

02sep12:00 pm12:30 pmBest Practices for Work Order Planning and Routing for Field Service Companies

09sep10:00 am11:00 amWhat is Levridge? An Overview of the Ultimate Ag Solution

09sep12:00 pm12:30 pmOverview of Microsoft Promotion for NAV and GP Clients

10sep11:00 am12:00 pmConfab with Stoneridge - Livestream - Field Service Comparisons

16sep10:00 am10:30 amThe Modern Manufacturer - Product Lifecycle Management

16sep12:00 pm12:30 pmHow to Upgrade to Dynamics 365 Finance and Operations: Examining Custom Code and ISV Implications

16sep2:00 pm2:30 pmScheduling and Dispatching for the Modern Field Service Company

23sep12:00 pm1:00 pmDynamics 365 Business Central Wave 2 Release Preview - An Overview of the Most Exciting New Features Coming in October

24sep11:00 am12:00 pmConfab with Stoneridge - Livestream - The Modern Workplace: Teams, Sharepoint, Outlook, Office, and AI Integration

30sep10:00 am10:30 amThe Modern Manufacturer - Return Management

30sep12:00 pm12:30 pmEmpowering Your Field Service Technicians with a Mobile Solution

october

07oct12:00 pm1:00 pmThe Three Paths to Business Central from Dynamics GP

08oct11:00 am12:00 pmConfab with Stoneridge - Livestream - The Vision and Strategy of Microsoft Business Systems

14oct10:00 am10:30 amThe Modern Manufacturer - Complex Cost Modeling

14oct12:00 pm12:30 pmGenerating Custom Inspection or Process Forms

19octAll Day22Stoneridge Connect Fall 2020

22oct11:00 am12:00 pmConfab with Stoneridge - Livestream - Stoneridge Connect Recap

28oct10:00 am10:30 amThe Modern Manufacturer - Engineering Change Orders

About Stoneridge
Stoneridge Software is a unique Microsoft Gold Partner, with emphasis on partner. With specialties in Microsoft Dynamics 365, Microsoft Dynamics AX, Microsoft Dynamics NAV, Microsoft Dynamics GP and Microsoft Dynamics CRM, we focus on attracting the most knowledgeable experts in the field to our team, and prioritize delivering stellar solutions with maximum impact for your business. At Stoneridge, we are deeply committed to your results. Each engagement is met with a dedicated team, ready to provide thorough, tailored, and expert service. Based in Minnesota, we intentionally “step into your shoes,” wherever you are. We focus on what you care about, and develop trusting, long-term relationships with our clients.

Subscribe To Our Blog

Sign up to get periodic updates on the latest posts.

Thank you for subscribing!

X