Automated Data Entity Import Using DIXF in Dynamics AX

by | Updated March 29, 2021 | Dynamics 365 for Finance and Operations, Dynamics AX

Data Import Export Framework (DIXF) is available for various versions of Dynamics AX (AX 2012, AX2012 R2, AX 2012 R3 and Dynamics 365 for Operations). Refer to the Microsoft’s DIXF User Guide for instructions on how to install DIXF for your version of Dynamics AX.

Often times, DIXF is used for data migration projects, when the client needs their data migrated from the legacy system to Dynamics AX. Some common examples would be Master data – Custom, Vendor, Addresses etc., Open transactions – GL opening balances, Open customer invoices, Open vendor invoices etc.

But, there are more applications of DIXF than one-time data migration from a legacy system. Recently, I came across a scenario where I used DIXF for an automated integration. I was intrigued by finding that without any customizations, we can use out-of-the-box DIXF functionality to define a folder where new data files are dropped. DIXF can automatically pick up the files on a defined recurrence, process the data and once done processing, move the files to a ‘Completed’ folder.

Steps to setup automated Data Entity import using DIXF:

  1. Setup the ‘Processing group’

The first step is to setup the Processing group. Go to Data import export framework > Common > Processing group

Click ‘New’ to create a new Processing group. For example I created a new ‘Opening balance’ processing group for my scenario.


  1. Define Entities

Once you have defined the processing group, the next step is to define the entities that’ll be used to import the data into Dynamics AX. Click ‘Entities’ button on the ‘Processing group’ form.


Select the entities that’ll be used for importing the data. For example: I selected the opening balance entity.

There are many data entities available out-of-the-box. You can find the complete list here. If you can’t find an entity that you need for your scenario, creating custom DIXF isn’t a cumbersome task.


NOTE: You can either ‘Generate source file’ or ‘Generate source mapping’ by providing a ‘Sample file path’. Ensure your source mappings are completed and click ‘Preview source file’ to validate your data.

  1. Setup ‘Staging data execution’

The next step is to setup the ‘Staging data execution’ process for importing the data. Click ‘Get staging data’ button on the ‘Processing group’ form.


Provide a value for ‘Job ID’ and ‘Description’ and click ‘Ok’.


Set the following in the ‘Overview’ tab

Type: Directory this is used to specify that DIXF will look for new files in this directory to process.

Processing directory: – this is used to specify the directory where files will be moved when are being processed by DIXF.

Completed directory: – this is used to specify the directory where files will be moved after they are processed by DIXF.

Error directory: – this is used to specify the directory where files will be moved if any error(s) occurred during their processing by DIXF.

Execute target step: Checked – this is checked to automatically execute the step to copy the data from staging table to target tables.


  1. Setup batch process for automated import

The final step is to setup the batch process for doing automated import. Click ‘Run’ on ‘Staging data execution’ form.



Select ‘Batch processing:’, define ‘Task description:’ and ‘Batch group:’ and click ‘Recurrence’.


Define your desired recurring pattern. For example: I’m setting the recurring pattern to execute the process every 10 minutes, starting from 10:00AM on July 24th, 2017 and no end date. Click Ok.


This Infolog message will confirm that the batch process has been setup for your automated import process.

To view the execution history, Click ‘Execution history’ button on the ‘Processing group’ form.


Once the DIXF processes the file, the file will be moved to the ‘Completed’ directory and the data will be imported in Dynamics AX.


Now, all you need to do is just drop the new files in the defined folder and DIXF will do the rest to import the data automatically. 

Related Posts


Submit a Comment

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

Upcoming Events


06oct10:00 am10:30 amPreview of D365 Business Central Fall Release Features and Functionality

06oct12:00 pm12:30 pmInsider's Guide to New Features Available in the Fall Release of D365 Finance and Supply Chain

07oct11:00 am12:00 pmConfab LIVE with Stoneridge - Dataverse and Dynamics in Review – Let’s Get Technical

13oct12:00 pm12:30 pmWave 2 Release – What’s Coming for Dynamics 365 Sales and Customer Service

21oct11:00 am12:00 pmConfab LIVE with Stoneridge - Dataverse and Dynamics in Review – Let’s Get Functional

26oct(oct 26)9:00 am28(oct 28)5:00 pmStoneridge Connect Leadership and Community Conference


04nov11:00 am12:00 pmConfab LIVE with Stoneridge - Challenging the Development Paradigm

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!