Install optional upgrade XPO files

  • Article

Important

This content is archived and is not being updated. For the latest documentation, see Microsoft Dynamics 365 product documentation. For the latest release plans, see Dynamics 365 and Microsoft Power Platform release plans.

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

Note

This topic has been updated to include information about features that were added or changed in Microsoft Dynamics AX 2012 Feature Pack, Microsoft Dynamics AX 2012 R2, and Microsoft Dynamics AX 2012 R3.

Some optional features of Microsoft Dynamics AX require that additional XPO files be installed before preprocessing for a data upgrade can start. We recommend that you import these files only if the associated feature is installed on your source Microsoft Dynamics AX system, and you want to migrate the data for the feature to AX 2012. The XPO files contain upgrade scripts and forms that are required to prepare the data in your source system for upgrade. These optional XPO files must be installed after the XPO files for the upgrade framework have been installed.

This topic describes the XPO files for optional features of Microsoft Dynamics AX. The topic also describes the XPO files that are related to batch processing. These files are used to roll back any customizations that you have made to your batch processing class.

XPO files for optional features

The XPO files for optional features, just like the XPO files for the upgrade framework, are specific to an earlier version of Microsoft Dynamics AX. The correct version is indicated in the file name as follows:

  • AX 4.0: “AX4” or “AX40”

  • AX 2009: “AX5” or “AX50”

All these files are located in the DatabaseUpgrade\XPO folder on the installation media.

Feature

Minimum requirements

XPO files

Components that are provided

Payroll

Payroll for AX 2009

Provided in AX 2012 R2 and AX 2012 R3

UpgradeAX5_Payroll.xpo

  1. Additional tasks on the Preprocessing upgrade checklist for Payroll

  2. Preprocessing upgrade scripts for Payroll

Retail

AX 2009 for Retail

Provided in AX 2012 Feature Pack:

SharedProject_AX50PreUpgrade_Retail.xpo

Provided in AX 2012 R2 and AX 2012 R3:

UpgradeAX5_Retail.xpo

  • Additional tasks on the Preprocessing upgrade checklist for Retail

  • User input forms that are opened by the new checklist tasks.

  • Preprocessing upgrade scripts for Retail.

Lean manufacturing

Lean manufacturing for AX 2009

Provided in AX 2012 Feature Pack, AX 2012 R2, and AX 2012 R3:

SharedProject_AX50PreUpgrade_Lean.xpo

  • Additional tasks on the Preprocessing upgrade checklist for lean manufacturing.

  • User input forms that are opened by the new checklist tasks.

  • Preprocessing upgrade scripts for lean manufacturing.

Process manufacturing production and logistics

Process Industries for AX 4.0 SP2 or Process Industries for AX 2009

Provided inAX 2012 Feature Pack, AX 2012 R2, and AX 2012 R3:

PI_UpgradeAX4.xpo

PI_UpgradeAX5.xpo

  • An additional task on the Preprocessing upgrade checklist for process manufacturing.

  • A user input form that is opened by the new checklist task.

  • Preprocessing upgrade scripts for process manufacturing.

Project Management and Accounting add-in

Professional Services Automation for AX 4.0 SP2 or Professional Services Automation 2009 RU4 for AX 2009

Provided in AX 2012 Feature Pack, AX 2012 R2, and AX 2012 R3:

UpgradeAX4_SI.xpo

UpgradeAX5_SI.xpo

  • For AX 4.0, a modified upgrade script.

  • For AX 2009, an additional upgrade readiness script.

Country/region-specific Brazil)

AX 4.0 SP2 + Brazil FP + 362 DIS + latest DIP

Provided in AX 2012 R2 and AX 2012 R3:

UpgradeAX4_GBR.xpo

Additional or modified upgrade preprocessing tasks, forms, and scripts that support functionality that is specific to Brazil:

  • Upgrade support for fiscal operation (CFOP) codes in purchase and sales orders.

  • Location type “Outside Brazil” changed to “Outside country.”

  • Addition of transaction type “Tax fiscal document.”

  • Validation of legal text IDs in fiscal documents.

  • Validation of tax registration (I.E.) numbers.

Country/region-specific (China)

AXC 4.0 SP2 + CN GLS

Provided in AX 2012 R2 and AX 2012 R3:

UpgradeAX4_GCN.xpo

Additional or modified upgrade preprocessing tasks, forms, and scripts that support functionality that is specific to China:

  • Upgrade support for VAT registration numbers.

  • Enhancements of tax integration feature to reduce AIF setup workload.

Country/region-specific (India)

AX 4.0 SP2 + IN GLS

Provided in AX 2012 R2 and AX 2012 R3:

UpgradeAX4_GIN.xpo

Additional or modified upgrade preprocessing scripts that support functionality that is specific to India.

Country/region-specific (Russia and Eastern Europe)

AX 4.0 SP2 FP1 EE + REGFs

Provided in AX 2012 R2 and AX 2012 R3:

UpgradeAX4_GLS_EE.xpo

UpgradeAX5_GLS_EE.xpo

Additional or modified upgrade preprocessing tasks, forms, and scripts that support functionality that is specific to Russia and Eastern Europe:

  • Configuration macro task added to reconcile RU and EE Upgrade preprocessing scripts.

  • Upgrade support for number sequences.

  • Enhanced upgrade support for financial dimension framework.

  • Support for increasing the string size of extended data types during upgrade.

Country/region-specific (Japan)

AX 4.0 SP2 + JP GLS

Provided in AX 2012 R2 and AX 2012 R3:

UpgradeAX4_GJP.xpo

Note

This package corresponds to the Japan functionality contained in UpgradeAX5_GLS_Cons.xpo, below.

Additional or modified upgrade preprocessing tasks, forms, and scripts that support functionality that is specific to Japan:

  • Enhancements to bill-of-exchange support.

Country/region-specific (China, Japan, Brazil, and India)

  • China: AX 2009 SP1 + GLS_Cons + RUx

    –or–

    AX 2009 SP1 + GLS_Cons + RU7 or latest + China TR-1

  • Japan: AX 2009 SP1 + GLS_Cons + RUx

  • Brazil: AX 2009 SP1 + GLS_Cons + RUx

  • India: AX 2009 SP1 + GLS_Cons + RUx

Provided in AX 2012 R2 and AX 2012 R3:

UpgradeAX5_GLS_Cons.xpo

Note

Functionality for Japan delivered in this package corresponds to UpgradeAX4_GJP.xpo, above.

Additional or modified upgrade preprocessing tasks, forms, and scripts that support functionality that is specific to China, Japan, Brazil, and India.

The package includes the following functionality for Japan:

  • Enhancements to bill-of-exchange support.

Country/region-specific (Russia)

AX 4.0 SP2 FP1 EE + RUHRP

Provided in AX 2012 R2 only:

SharedProject_AX40PreUpgrade_CISPayroll.xpo

SharedProject_AX50PreUpgrade_CISPayroll.xpo

Additional or modified upgrade preprocessing form elements and scripts that support functionality that is specific to Russia.

The package includes the following functionality for Russia:

  • Payroll support

Important

Before installing the XPO for this feature, install either UpgradeAX4_GLS_EE.xpo or UpgradeAX5_GLS_EE.xpo as appropriate.

XPO files for batch processing

XPO files that are related to batch processing are included in the DatabaseUpgrade\XPO folder in AX 2012 Feature Pack, AX 2012 R2, and AX 2012 R3. One file is included for each upgrade path that is supported:

  • PrivateProject_Ax40PreUpgradeFramework_Batch.xpo

  • PrivateProject_Ax50PreUpgradeFramework_Batch.xpo

These XPO files roll back any customizations that you have made to the batch processing class on your source Microsoft Dynamics AX system. To minimize downtime during data preprocessing, we recommend that you import the appropriate XPO file for your system.