This notice is to inform you that future releases of SuiteCommerce and SuiteCommerce Advanced will not support extensions that do not follow recommended use of the Extensibility API to implement customizations to private core Commerce modules. To assist with compliance going forward, a new Extensibility Layer Safe Mode configuration option has been introduced in SuiteCommerce and SuiteCommerce Advanced 2020.2.1. With this option enabled, you can identify extensions that do not follow recommended practices.
What is Changing?
Future releases of SuiteCommerce and SuiteCommerce Advanced will discontinue support for extensions that directly customize or import private core Commerce modules. These customizations should instead be implemented as recommended using the Extensibility API.
To help you identify disallowed extensions, a new Extensibility Layer Safe Mode configuration option has been introduced in SuiteCommerce and SuiteCommerce Advanced 2020.2.1. When enabled, this option causes a notification to display in the web browser console at runtime when an extension that directly customizes or imports private core modules is being loaded into your site.
- An error is generated when an extension customizes or imports a core module that is disallowed. The error message includes the name of the extension that caused the error and lists the private core modules that the extension should not directly customize or import.
- When an error is generated, the extension that caused the error is not loaded into the site. The functionality provided by the extension will not be available in the site, but otherwise the site is not affected.
- A warning is generated when an extension customizes or imports a core module that is allowed for now, but will be disallowed in the future. The warning message includes the name of the extension that caused the warning and lists the private core modules that the extension should not directly customize or import.
- When a warning is generated, the extension is loaded into the site and the functionality provided by the extension is available. However, be sure to revise these extensions to use the Extensibility API as soon as possible to ensure their continued functionality. All extensions that currently generate warnings will eventually generate errors.
Required Actions – SuiteCommerce
As of release 2020.2.1, the Extensibility Layer Safe Mode configuration option is enabled by default for SuiteCommerce implementations. Monitor the web browser console to take note of extensions that generate errors and warnings and revise those extensions to use the classes and methods available in the Extensibility API to achieve necessary customizations. If needed, work with your vendors and extension developers to ensure the extensions required for your site are updated to use recommended and current customization methods.
Required Actions – SuiteCommerce Advanced
If your current implementation includes extensions that directly customize or import private core Commerce modules and you plan to upgrade to a more recent version of SCA in the near future, you should revise those extensions to use the classes and methods available in the Extensibility API to achieve necessary customizations. If needed, work with your vendors and extension developers to ensure the extensions required for your site are updated to use recommended and current customization methods.
Starting with release 2020.2.1, the Extensibility Layer Safe Mode configuration option is available in SuiteCommerce Advanced, but is disabled by default. When you upgrade to SCA 2020.2.1 or later, we recommend that you enable the Extensibility Layer Safe Mode configuration option to ensure all extensions use the Extensibility API as expected and that no warnings or errors are generated.
For More Information
To learn more about the Commerce Extensibility API, see the SuiteCommerce FrontEnd Extensibility API Reference.
For additional information, see the following topics in the NetSuite Help Center or SuiteAnswers:
If you require assistance or more information, please contact NetSuite Customer Support.