Suitelets that are available without login have updated External URLs as of May 9, 2024. The new URL is displayed in the External URL field on the script deployment record for Suitelets that are available without login. The old URL will stop working as of NetSuite 2024.2.
Give special consideration to the following:
- All hardcoded URLs are impacted.
- Cases where the URL is resolved automatically, using url.resolveScript() and similar methods, do not require any action
Hardcoded URLs can be found in various places:
- In scripts and HTML files in your account
- Occasionally in other places like script parameters
- In external systems that retrieve information or trigger actions
- Links on your Web site
- In rare cases, where a Suitelet is used as a public Web site, it might be referenced by search engines
What to look for?
- An example of the previous format for external URLs:
- /app/site/hosting/scriptlet.nl?script=123&deploy=123&h=ABCDFEFGHIJKLMNOPRSTUV
- An example of the updated external URL format:
- /app/site/hosting/scriptlet.nl?script=123&deploy=123&ns-at=KLMNOPRSTUVABCDFEFGHIJ
The effective change to the External URL is:
- &h=ABCDEFGHIJKLMONPQRSTUV is replaced by &ns-at=KLMNOPRSTUVABCDFEFGHIJ
References pointing to the old external URL of the Suitelet will result in broken links after upgrade to NetSuite 2024.2.
Recommended actions
Update all existing hard-coded references to external URLs for Suitelets to use the new URL before the upgrade to NetSuite 2024.2. After your account upgrade, all URLs using the old format will result in broken links.
To prepare for this change, use the Release Preview for NetSuite 2024.2 to identify the links to external Suitelets that are not working properly and fix them. For more information on Release Preview, see Accessing Your Release Preview Account, SuiteAnswers ID 39120
Note: We have identified requests to NetSuite URLs in your account coming from external sources. You must identify these hard-coded external URLs directly, as they won’t be reflected as broken links in your account when using Release Preview.
- Locate any existing hard-coded URLs calling the external Suitelet in the old format:
- You can take advantage of the Release Preview account to identify broken links from scripts in your account.
- Search for Scripts Containing Hard-coded URLs with &h= Parameter, SuiteAnswers ID 1016553.
- Get the new URL of your external Suitelet:
- Go to the Script Deployment page of the Suitelet and copy the updated external URL displayed there.
- Update links or references to the old URL with the new copied URL. Review all possible references, including the following situations:
- Requests to external Suitelets from external systems, including requests using HTTP verbs such as POST or PUT
- Links to external Suitelets from Web sites
All requests using the old URL will throw an error after the account is upgraded to 2024.2.
Links to Suitelets using the url.resolveScript(options) method are not affected and do not require update as long as the Suitelet is being accessed in a trusted context for authenticated users. For more information, see Changes to External Suitelet URLs, SuiteAnswers ID 31709.
For more information about External Suitelet URLs, see the Setting Available Without Login section of the Suitelet Script Deployment Page.
Additionally, we recommend reviewing the guidelines for usage of Suitelets marked Available Without Login and changing them to internal Suitelets when possible. See Suitelets and UI Object Best Practices and the Setting Available Without Login section of the Suitelet Script Deployment Page.