Migrate code for a Microsoft Dynamics 365 for Finance and Operations solution

To complete your solution package, the first step is to upgrade your code by using the best practices in Migrate and Create Finance and Operations Solutions in Microsoft Dynamics Lifecycle Services (LCS). After that step is completed, you must run the Customization Analysis Report (CAR). This report analyzes your customization and extension models, and runs a predefined set of best practice rules.

To generate the CAR, run the following command on a Microsoft Dynamics 365 for Finance and Operations development environment.

xppbp.exe -metadata=<local packages folder> -all -model=<ModelName> -xmlLog=C:\BPCheckLogcd.xml -module=<PackageName> -car=<reportlocation>

Here is an example of this command.

xppbp.exe -metadata=C:\Packages -all -model=MyAppSuiteCustomizations -xmlLog=C:\temp\BPCheckLogcd.xml -module=ApplicationSuite -car=c:\temp\CAReport.xlsx

The xppbp.exe file is located in c:\packages\bin or I:\AosService\Packages\LocalDirectory\bin. You must resolve any warnings or errors that appear on the Issues tab of the report. You must then submit a copy of the CAR to Microsoft before your validation meeting. For more information, see Customization Analysis Report. For information about issues and exceptions, see the Customization Analysis Report: Exceptions and known issues post on the Dynamics 365 Community blog.

Extensibility

In Microsoft Dynamics 365 for Finance and Operations version 8.0 (April 2018), all product models are sealed. Therefore, only extension-based customizations are currently supported. For more information about extensibility, see Extensibility.

The first step in completing your solution package is to upgrade your code using the best practices in Migrate and Create Finance and Operations Solutions in LCS. After this step is complete, you must run the Customization Analysis report. This report analyzes your customization and extension models, and runs a predefined set of best practice rules.

To generate the Customization Analysis report (CAR), run the following command on a Microsoft Dynamics 365 for Finance and Operations development environment.

xppbp.exe -metadata=<local packages folder> -all -model=<ModelName> -xmlLog=C:\BPCheckLogcd.xml -module=<PackageName> -car=<reportlocation>

Here's an example of how this command might look.

xppbp.exe -metadata=C:\Packages -all -model=MyAppSuiteCustomizations -xmlLog=C:\temp\BPCheckLogcd.xml -module=ApplicationSuite -car=c:\temp\CAReport.xlsx

The xppbp.exe file is located in c:\packages\bin or I:\AosService\Packages\LocalDirectory\bin). Any warnings or errors that appear on the Issues tab of the report must be resolved. A copy of the CAR report must be submitted to Microsoft prior to your validation meeting. For more information, see the Finance and Operations Help topic, Customization Analysis Report or refer to the Dynamics Community blog for issues and exceptions.

Additional resources

Publishing an App for Dynamics 365 for Finance and Operations in AppSource

Technical Concepts Guide for code migration