This notice is intended for customers who use translated versions of the NetSuite application. These versions will be impacted by some upcoming changes to how NetSuite terms are translated.
NetSuite 2021.2 will introduce a significant number of changes to how terms in the NetSuite application are translated. These changes will represent a large improvement in translation quality.
SuiteAnswers articles containing the list of changes will be available for all affected languages. For all affected languages, review this page in SuiteAnswers, SuiteAnswers ID 100193.
What is changing?
NetSuite 2021.2 will include changes to existing translations in German, French (France), French (Canada), and Portuguese (Brazil).
Further, it will include changes to existing translations in Czech, Finnish, Korean, Thai, Turkish, and Vietnamese released in NetSuite 2021.1.
This release will also include new and updated translations of terms for features that are newly released or changed in this release, in all languages.
After this release, these new translation standards will be applied gradually to translations of existing strings in the remaining languages.
Note that discrepancies among multiple translations of a single term may occur between NetSuite 2021.2 and NetSuite 2022.1, as the new translation standards are applied gradually to strings throughout the NetSuite application.
These translation changes will include changes to the following types of translation strings:
- Field labels
- Button labels
- Record names
- Drop-down values
- Status, info, and error messages
- Menu items
In addition, these translation changes will impact object references that use labels in the following types of customizations:
- SuiteScripts
- Custom reports
- Saved searches
- Web services integrations
- Any other customizations that use labels for references
Based on the significant number of strings that will be changing, cases may occur in which translations will change for terms used in labels. After these changes occur, references that use these labels will no longer work in translated languages.
Affected Customizations
The following types of customizations may be affected by the updated translations. You need to take action as soon as possible to avoid issues with these customizations after your account is upgraded to 2021.2.
Saved Searches
In saved searches, fields can only be referenced by final string values. If a string value changes due to translation changes, the search will not function properly. It will not return an error, but the search results may not be correct.
SuiteScripts
Any decision logic based on a hard-coded string comparison of translatable field values will be impacted by these translation changes. A script containing this type of comparison will fail, and the business logic will not be executed.
External Integrations
Values of translatable fields will change when they are exported through CSV, SOAP, ODBC, or REST, especially if the integration is based on a string value instead of a key. You may also encounter issues with external BI tools.
SuiteFlow
Any workflows that use problematic saved searches may not function properly.
You may encounter other issues with additional types of customizations due to the upcoming translation changes. To prevent issues related to the upcoming translation changes, it is very important that you review the following recommended actions. These actions should be completed before your account is upgraded to 2021.2. Please treat the completion of these recommended actions as a high priority. If you do not complete them before your upgrade to 2021.2, you may experience significant negative impact.
Be sure to review the available SuiteAnswers articles containing the list of translated changes for all included languages. For all affected languages, see this list of changes, SuiteAnswers ID 100193.
Recommended Actions
To limit issues with references in your customizations after your account is upgraded to 2021.2, you should do the following before the upgrade.
- Review the list of changes in SuiteAnswers for any languages that you use. Determine whether any translations will change for terms used in labels that are referenced in any of your customizations.
- Review the references in your customizations. If you find any references that use labels containing terms for which translations will change, replace them with references to IDs.
- It is a best practice to use IDs instead of labels in references, because IDs are static and will not be impacted by translation changes or other changes.
- For information on how to display IDs, see Showing Record and Field IDs in Your Account.
- If an ID cannot be used or found, for a temporary fix, you can replace the old translated term in the label with the new translated term provided in the list of changes. Please note that this should not be considered a permanent solution. You should replace the label with an ID value as soon as possible. Contact NetSuite Customer Support for assistance with a missing or unusable ID.
- To ensure your updated customizations will continue to work after your account is upgraded to 2021.2, test your customizations in a 2021.2 Release Preview account. For information about how to opt in to get access to Release Preview, see Overview of Release Preview. If you encounter issues, contact NetSuite Customer Support for assistance.
To prevent future issues, ensure your employees are familiar with the updated terminology listed in SuiteAnswers.
It is possible you will encounter issues despite completing the recommended actions. In this case, please contact NetSuite Customer Support.
For more information about translation changes, see the following:
If you have additional questions, please contact NetSuite Customer Support.