To Resolve an Issue Discovered During the Validation
If you need to upgrade an MYOB Acumatica instance in the production environment, if the validation of the compatibility of the code
included in all currently published customization projects with the code of the new product
version fails, do the following:
- If the customization was developed by a third-party, please contact their support department directly.
- If you are a developer of this customization:
- Learn what the error message means. (See Messages for Validation Errors for details.)
- Find the customization code fragment related to the error, and try to resolve the issue you have discovered yourself by using the error description.
- Check the technical release notes for the selected product version to ensure that the reason of the error is a change in the product code, and find the recommendation to solve the issue. (See To Use the Technical Release Notes to Find the Breaking Changes for details.)
- In your development environment:
- Install the needed version of MYOB Acumatica and deploy the new application instance. (See Installing MYOB Acumatica Locally for details.)
- Import all customization projects. (See Project Publication: To Deploy a Customization Project for details.)
- Validate and fix the customization code in each project.Note: If you are unable to resolve an issue yourself, please contact MYOB support. You can create a support case for the issue on the Support page of the Acumatica Partner Portal.
If you are sure that a discovered error is not really an error, you can force the validation process to ignore the error. See To Use an Ignore List for the Validation Errors for details.
- In the production environment:
- Unpublish all customization projects. (See Unpublishing Customization Projects for details.)
- Upgrade the MYOB Acumatica instance. (See Updating MYOB Acumatica by Using the Web Interface for details.)
- Update the customization projects. (See To Replace the Content of a Project from a Package for details.)
- Publish the fixed customization projects. (See Publishing Customization Projects for details.)
Note: The validation that detects breaking changes is by default turned on in an instance
of MYOB Acumatica. If you need to temporarily omit this validation, you can turn off the
CheckCustomizationCompatibility key by including the following string
in the <appSettings> section of the web.config
file located in the website
folder:
<add key="CheckCustomizationCompatibility" value="False" />
We
do not recommend that you turn off the validation permanently.