This page provides a list of published documentation, known issues, solutions, and tips and tricks to help you import, export, or migrate data for Microsoft Dynamics AX 2012.

This page contains the following sections:

Recent news

Data Import/Export Framework

The Cumulative Update 7 version of the Data Import/Export Framework includes the following features:  

  • The ability to compare and copy entities across companies  
  • Additional entities for configuration, Microsoft Project, Fiscal books, Retail  
  • Support for XML data sources
  • Support for Microsoft Excel data sources
  • Role-based security for processing groups  

For more information about Data Import/Export Framework, see the Data import/export framework user guide.

Test Data Transfer Tool

 A new version of the Test Data Transfer Tool was recently released on InformationSource. If you experience any issues, we recommend that you install the new version.

Choose a tool

To learn more about how to import, export, or migrate data into Microsoft Dynamics, review the following resources.



Choose the best tool for your task

Get tools

Read documentation

Common problems and solutions

This section lists common issues encountered when importing, exporting, and migrating data.

Important: If you encounter a problem when importing, exporting, or migrating data, we recommend that you use Issue Search on Microsoft Dynamics Lifecycle Services to research it. Issue Search is a search engine that you can use to quickly search for KB articles, hotfixes, and workarounds for reported issues in Microsoft Dynamics AX 2012 and Microsoft Dynamics AX 2012 R2. You can see which reported issues are in the process of being fixed and see notifications when a hotfix is released for a specific functional area in Microsoft Dynamics AX. You can download released hotfixes, see which code objects are affected, and see the code changes introduced by the hotfix. In order to use Issue Search, you must have a CustomerSource or PartnerSource account, and have created a project. For more information, see the Lifecycle Services User Guide.

Data Import Export Framework

Version: The following issues are found in the version of the Data Import Export Framework for AX 2012 RTM and Feature pack from InformationSource


Issue: Some customers have recently been unable to install some hotfix packages for Microsoft Dynamics AX 2012 R2 if they are running a release before CU7, have a DMF model in the FPK layer, and are installing a hotfix released after CU7. Customers see the error "Violation of PRIMARY KEY constraint 'PK_ModelElementData_ElementHandle'".

Resolution: Follow the instrucitons in the blog post Violation of PRIMARY KEY constraint 'PK_ModelElementData_ElementHandle' error installing some hotfixes on Microsoft Dynamics AX 2012 R2.


Issue: After installing the Data Import/Export Framework you get a number of compile errors related to missing macros.


In the AOT, examine the macros node.  There should be AxdAdvancedLedgerEntryDCT and  AxdCustomerTransactionDCT macros in the node.  If you do not see these macros, then do a compare on the DataContainerTypes macro to make the macros visible.


Issue: When you enter Setup > Data import/export framework parameters you get the error message: "Assembly containing type Microsoft.Dynamics.AX.DMF.ServiceProxy.DmfEntityProxy is not referenced".


Create the structure c:\Windows\Microsoft.NET\Assembly\GAC_MSIL\Microsoft.DynamicsAX.DMF.ServiceProxy\v4.0_1.0.0_31bf3856ad364e35\
and then paste the file Microsoft.Dynamics.AX.DMF.ServiceProxy.DLL, from C:\Program Files\Microsoft Dynamics AX 2012 Data Import Export Framework Server Component\.

Restart the AOS, and compile into CIL.


Issue: Importing Ledger Dimensions in Data Import/Export Framework in AX 2012 R2 does not function. You get the message "Financial Dimension 0 does not exist" when importing ledger dimension values.


Contact support for a workaround.



Unable to select ODBC connections created as System DSNs. You get the message: “System.NullReferenceException: Object reference not set to an instance of an object.”


Create a User DSN instead.


Issue: Creating a custom entity that imports to a table with a primary index that allows duplicates will import only one record.


Contact support for a workaround.


For additional troubleshooting information that is regularly updated, see Lifecycle Services Issue Search.

Suggested alternate search terms:

Data Import Export Framework: DMF, DIEF, DIXF

Featured videos

RapidStart for Retail (InformationSource)

Related blogs

We recommend the following blogs:

Still having trouble?

If you’re still having trouble, you can get assistance in the following ways:

  • Search for your issue on the Lifecycle Services site. You must know your CustomerSource or PartnerSource login, and create a project before you can search for issues.
  • Post your questions on the Ask the Community site and a member of the Microsoft Dynamics AX community might respond.
  • Contact your partner.
  • If enrolled in a support plan directly with Microsoft, enter a new support request with Microsoft Dynamics Technical Support.

You can enter a support request on CustomerSource or PartnerSource by selecting Support > New Technical Support Request.

You can also contact Microsoft Dynamics Technical Support by phone using these links for country/region-specific phone numbers: