Conversion Procedure

Applies To: Microsoft Dynamics AX 2012 R2, Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012

The following procedure is the basic process that you can follow to convert an Enterprise Portal application from an earlier version of Microsoft Dynamics AX to work on Enterprise Portal for Microsoft Dynamics AX 2012.

Converting an Enterprise Portal Application

Before you begin this procedure, make sure that Microsoft Dynamics AX 2012 and Enterprise Portal are set up and working correctly.

To convert an Enterprise Portal application

  1. Import the Enterprise Portal resources for your application into the Microsoft Dynamics AX 2012 installation. Typically, you will do this using a .xpo file.

    You may have better results by choosing not to import some resources. Instead, you should re-create them in the new version of Enterprise Portal. Examples include the MainMenu and Web Module resources. They can potentially break the navigation in Microsoft Dynamics AX 2012 when you import them. Other examples include Cues and X++ reports, because these will not work in the new version of Enterprise Portal.

  2. Make modifications to the application resources to account for database changes in Microsoft Dynamics AX 2012. See Database Changes for detailed information about doing this.

  3. Make modifications to the application resources to account for framework changes in Microsoft Dynamics AX 2012. See Framework Changes for detailed information about doing this.

  4. Make changes to the data sets used for your Enterprise Portal application to accommodate the database changes.

  5. Verify the functionality for each web page in your Enterprise Portal application. You may find easier to work with one page at a time. For each page, do the following:

    1. Verify the web parts on the page. See Page Changes for information about specific issues to address.

    2. Verify the User Controls on the page. See User Control Changes for information about specific issues to address.

  6. Verify the navigation for your application.

  7. Implement new features for your application.

  8. Test your converted Enterprise Portal application thoroughly.