This notification is to inform you of upcoming changes to how audience roles are defined for Single Page Applications (SPAs).
What is Changing?
For NetSuite 2025.1 accounts, starting March 13, 2025, you will no longer be able to deploy SPAs to both internal and external roles through either of the following actions:
- Checking the All Roles box in the Audience Setup window in the UI, or
- Setting the audienceallroles field to T in the singlepageapp SDF custom object.
The update will include the following changes:
- In the Audience Setup window of the SPA configuration page:
- Audience roles will be shown in two separate multiselect fields: Internal Roles and External Roles.
- The All Roles box will be renamed to All Internal Roles. Checking this box will select all internal roles only. External roles will have to be selected individually.
- For the singlepageapp SDF custom object, the following changes will apply:
- Setting the audienceallroles field to T will select all internal roles only.
- It will still be possible to use the audienceroles field to individually specify both internal and external roles. If audienceallroles is set to T, all internal roles will be included in the audience along with any specific external roles listed in audienceroles.
- For existing SPAs, previously selected external roles will be automatically selected in the new External Roles field when your account is upgraded to 2025.1. For SPAs with the All Roles box checked, all values in the External Roles field will be selected.
Required Action: Update SDF custom object XML files
To ensure that your SPA will continue to function as expected, you must update the SDF custom object XML files in your local project to match the audience configuration from the UI, specifically, the selected external roles. You can do one of the following:
- Before March 13, 2025: To prepare for the upcoming changes, manually update the audienceroles field in the SDF custom object XML file to specify the external roles that require access to the SPA.
- After March 13, 2025: After the update, you can reimport the SDF custom objects from your NetSuite account to your local SuiteCloud project. This import will populate the audienceroles field with the list of roles selected in the External Roles field in the UI.
Important: After your NetSuite account is updated on March 13, 2025, SPAs that previously had the All Roles box checked will have all values in the External Roles field selected. If you fail to specify the same external roles in the audienceroles field in your SDF custom object XML before redeploying your local project, the values set in the External Roles field will be overwritten. We also encourage you to review the list of external roles in the SPA audience and determine whether it is necessary for them to have access to the SPA. For reference, the following is a list of standard external roles:
- Customer Center
- Employee Center
- Vendor Center
- Shopper
- NetSuite Support Center
- Online Form User
- Partner Center
- NetSuite Support Center (Basic)
To view the list of standard roles that you can include in the audienceroles field, see the SDF XML reference for generic_role (SuiteAnswers ID 66104). Additional information about these changes is available in the NetSuite 2025.1 Release Notes. If you have any questions, contact NetSuite Customer Support.