Before you design the data migration, install an XPO in AX2012 to manage the enum migration.


Activities

Name Responsible Description

Install XPO on AX2012

Application Consultant

In D365 FO, enums can be extendable. For extendable enums, the enum value numbering is not fixed. Therefore, an enum value number in AX2012 can be different from the number of the related enum value in D365 FO.

To prevent a mismatch of enum values when migrating data, migrate enums based on the enum value name instead of the enum value number. To do so, on the AX2012 environment:
  1. Download and extract the SharedProject_Ax2012PrepMigrateD365FO ZIP file.
  2. Install the SharedProject_Ax2012PrepMigrateD365FO.xpo file. As a result, these enum transformation tables are installed in AX2012:
    • BisDmMigrationtableFieldEnum
    • BisDmMigrationenumValue
  3. Run the BisDmMigrationCreateEnumValues job.
As a result, you can migrate the enum values based on the names instead of the numbers.

Provide feedback