Changes to External Suitelet URLs...

Starting in NetSuite 2024.2, the external URLs for Suitelets that are accessible without login have been updated. The new format incorporates an &ns-at= parameter, which followed a new value. This modification, effective from May 9, 2024, necessitates that administrators and developers update any hard-coded links to maintain functionality.

What Changed

The following changes are significant:

The external URLs now utilize the &ns-at= format instead of the previous &h= parameter, which is important for ensuring continued access to Suitelets.
This new URL format is displayed in the External URL field on the script deployment record.

Implications of the Change

It is essential to recognize that:

All hard-coded URLs are affected. Any existing hard-coded links must be identified and updated to the new format to avoid broken links within the system and external websites.
Automated URLs that utilize methods like url.resolveScript(options) are not impacted, as these will adapt to the new format automatically.

Where to Find Hard-Coded URLs

Hard-coded URLs may exist in various locations:

Scripts and HTML files within your account.
Script parameters and settings.
External systems that may be retrieving information or triggering Suitelets.
Website links that direct users to specific Suitelets.
Search engines may also list Suitelets that are used as public-facing web pages.

Example of URL Change

The previous format that could lead to broken links is:

/app/site/hosting/scriptlet.nl?script=123&deploy=123&h=ABCDFEFGHIJKLMNOPRSTUV

This should be updated to the new format:

/app/site/hosting/scriptlet.nl?script=123&deploy=123&ns-at=KLMNOPRSTUVABCDFEFGHIJ

By making these adjustments, you will ensure that all link integrations function correctly and continue to direct users to the appropriate Suitelet.

Who This Affects

These changes primarily impact:

Administrators responsible for managing Suitelet configurations.
Developers who have embedded Suitelet links within their applications or scripts.
Webmasters maintaining external websites that reference Suitelets.

Key Takeaways

Suitelet URLs have been updated as of May 9, 2024, in NetSuite 2024.2.
Existing hard-coded URLs must be updated to the new format to prevent access issues.
Automated URL resolutions do not require changes, ensuring smoother transitions for developers.
Review all scripts, HTML files, and external references to identify and correct outdated links.

Frequently Asked Questions (4)

Do I need to enable a feature flag for the new Suitelet URL format?

There is no indication in the article that a feature flag needs to be enabled for the new Suitelet URL format. The changes are effective automatically starting with NetSuite 2024.2.

What permissions are required to update hard-coded Suitelet URLs?

The article does not specify specific permissions required to update hard-coded Suitelet URLs. However, administrators and developers will likely need relevant access to script deployments and possibly edit scripts or HTML files.

How does this change affect existing external systems that reference Suitelets?

External systems retrieving information or triggering Suitelets will require updates to their hard-coded URLs to avoid broken links. Any existing integrations must be reviewed to ensure updates to the new URL format are implemented.

Is the new Suitelet URL format applicable to both standard NetSuite and WMS?

The article does not mention any differences in applicability between standard NetSuite and WMS. The changes apply generally to all Suitelets accessible without login in NetSuite 2024.2.

Changes to External Suitelet URLs in NetSuite 2024.2