The following steps explain how to migrate from ActiveReports 3 to ActiveReports 12. The assembly version of DLLs included in ActiveReports 3 is 5.xxx.

1. From the Visual Studio Tools menu, select Convert to ActiveReports 12.
   • If the reference files do not automatically change to ActiveReport 12 after running the converter, you need to update them manually. For more details, see Reference Migration.
   • If the license information does not convert, you need to update it manually. For more details, see License Migration.
2. If you use any of the following in your project, perform changes as indicated. 
   • If you are using the ActiveReport3 class in your project, you need to change ActiveReport3 class to SectionReport class.
     

     Before migration: DataDynamics.ActiveReports.ActiveReport3
     After migration: GrapeCity.ActiveReports.SectionReport

   • If you are migrating from an initial version of ActiveReports 3 and use the Barcode control's Style and BackColor properties, then the size of the Barcode control may change on migration. You can set the BackColor property of the Barcode control to White, or manually change the size.

     Property	Value
     Style	QRCode, Code49, JapanesePostal, Pdf417, EAN128FNC1 (Any of these)
     BackColor	System.Drawing.Color.Transparent

   • If you are using the public variable 'ds' within the report, see ds Variable.
   • If you are using the WebViewer control, see WebViewer Migration.
   • If you are using the ActiveX viewer (ARVIEW2.CAB file) in a Web application, see ActiveX Viewer Migration.
3. Check the Compatibility Guidelines.
4. From the Build menu, select Rebuild Solution to rebuild the entire solution.
    
   Note: Between versions 1 and 12, we have updated several class names. This may cause syntax errors on migration. To resolve these errors, see the Breaking Changes topic.