Upgrade Procedure: Customizations and Integrations

Multiple changes have been made since MYOB Acumatica 2023 R2 U2 (Build 23.206.0006) that may affect reports, customizations, and integrations that have been implemented by developers for prior versions of MYOB Acumatica. The complete list of these changes is provided in Reference List of Changes. The following sections describe additional recommendations about the possible approaches that a developer can use to prevent issues with the implemented solutions.

To prevent breaking changes in the customization projects, the developer should do the following:

  1. Analyze the customization projects.
  2. Carefully read the list of breaking changes in Reference List of Changes.
  3. Replace the changed objects with their alternatives.
  4. If the objects used in the customization projects have been removed and no alternatives have been provided, consider creating new customization projects.
Before an upgrade to MYOB Acumatica 2024.2.1, to detect the changes that break existing customization projects, the developer can check the compatibility of the code included in all published customization projects with the new code of MYOB Acumatica. For details, see To Validate the Compatibility of the Published Customization with a New Version Before an Upgrade.
Note:
The validation that detects breaking changes is turned on by default in MYOB Acumatica 2024.2.1. If any errors occur during the validation, the developer can refer to To Resolve an Issue Discovered During the Validation in the Customization Guide.

Update of the Search Index

During the upgrade, the search index may become outdated. To update the search index, a system administrator needs to rebuild the entity index after the database upgrade by doing the following:

  1. Opening the Rebuild Full-Text Entity Index (SM209500) form.
  2. On the form toolbar, clicking Process All.

This process rebuilds the content of the DACs available for search and stores this content in the specific form prepared for search queries in the SearchIndex database table.

Update of Access Rights

In MYOB Acumatica 2024.2.1, the logic of setting restriction levels for system objects has been reworked. Developers should now include access rights in the customization projects as described in Platform: Changes to the Management of Access Rights.

Update of DAC Declarations

In MYOB Acumatica 2024.2.1, DAC extensions are now stored within the instance of the corresponding DAC class. Developers must update all of their existing DAC declarations by extending the PXBqlTable class, as described in Platform API: Introduction of the PXBqlTable Class.