Managing Single Page Applications Included in SuiteApps

You can install Single Page Applications (SPAs) in your account as part of a SuiteApp from the SuiteApp Marketplace.

You can manage some settings for these SPAs on the SPA management page, if you have Edit or Full level SuiteScript permission.

To access the SPA management page and change the settings:

Go to Customization > Scripting > Single Page Applications. The system shows a list of all of the SPAs in your account with these columns:
- Name – Name of the SPA and link to the access the SPA URL.
- Description – Description for the SPA.
- SuiteApp – The name of the SuiteApp that the SPA is part of.
- SPA ID – The ID of the SPA.
- Last Updated – Date the SPA was last updated (not yet in use).
In the list, click the SPA Name to open its management page.
On the Basic Info tab, you can view basic information for the SPA (such as Name, ID, Description, SuiteApp name, and URL).

On the Configuration tab, you can change your SPA's settings. Here are the fields you'll find:

Field	Description	How to Configure
Execute As	Sets the permissions and restrictions applied when executing the SPA based on the selected role. By default, this field is set to Current Role. For more information, see Executing Scripts Using a Specific Role.	To change the role, click the edit icon, pick a role from the list, and click Save.
Log Level	Filters the log entries shown on the Logs tab. The default log level is Debug. Other log level options include Audit, Error, and Emergency. For more information, see Setting Script Execution Log Levels.	To change the log level, click the edit icon, pick a value, and click Save.
Release Audience	Determines who can run the SPA. When the SPA is created, it runs only in the accounts of the roles selected in this field. If no role is specified, the SPA is accessible only to the script owner.	To change the audience, click Set Up Audience to see the current roles selected and other possible options. You can filter by role name. Audience roles are shown in two separate multiselect fields: Internal Roles and External Roles. To make the SPA available to all internal roles, check the All Internal Roles box. To add roles, check the boxes for each role on the left, then click the right arrow. To remove roles, check the boxes for each role on the right, then click the left arrow. Click Save to save your selection.
Center Links	Lets you create, edit, or delete center links for the SPA. Center links are used to specify a menu path that lets users access the SPA directly from that location.	To create a center link, click Add Link. In the Center Link window: In the Menu Location, pick the center and tab where you want to add the SPA link. By default, the new link is added at the bottom of the list. If you want it before an existing element, pick a value in Insert Before. In Label, enter the label for the SPA link. Click Save. Reload the page to see the new link in the menu. You can only add one link per menu location. To edit a center link, click the edit icon, update the fields, and click Save. To delete a center link, click the delete icon, then click Delete Link.
Error Notification	Indicates who is notified about errors. By default, the script owner is selected.	To set up the list of users who receive notifications, click Set Up Notifications and pick from these options: Current User – Notifies the user running the SPA. Script Owner – Notifies the script owner. Notify All Admins – Notifies all users with the Administrator role. Groups – Notifies all users in the selected group. To define new groups, go to Lists > Relationships > Groups > New. In the Specific Email Addresses field, enter a comma-separated list of email addresses for other users who should be notified.

Field

Description

How to Configure

Execute As

Sets the permissions and restrictions applied when executing the SPA based on the selected role. By default, this field is set to Current Role. For more information, see Executing Scripts Using a Specific Role.

To change the role, click the edit icon, pick a role from the list, and click Save.

Log Level

Filters the log entries shown on the Logs tab. The default log level is Debug. Other log level options include Audit, Error, and Emergency. For more information, see Setting Script Execution Log Levels.

To change the log level, click the edit icon, pick a value, and click Save.

Release Audience

Determines who can run the SPA. When the SPA is created, it runs only in the accounts of the roles selected in this field. If no role is specified, the SPA is accessible only to the script owner.

To change the audience, click Set Up Audience to see the current roles selected and other possible options. You can filter by role name.

Audience roles are shown in two separate multiselect fields: Internal Roles and External Roles.

To make the SPA available to all internal roles, check the All Internal Roles box.
To add roles, check the boxes for each role on the left, then click the right arrow.
To remove roles, check the boxes for each role on the right, then click the left arrow.

Click Save to save your selection.

Center Links

Lets you create, edit, or delete center links for the SPA. Center links are used to specify a menu path that lets users access the SPA directly from that location.

To create a center link, click Add Link. In the Center Link window:
- In the Menu Location, pick the center and tab where you want to add the SPA link. By default, the new link is added at the bottom of the list. If you want it before an existing element, pick a value in Insert Before.
- In Label, enter the label for the SPA link.
Click Save. Reload the page to see the new link in the menu. You can only add one link per menu location.
To edit a center link, click the edit icon, update the fields, and click Save.
To delete a center link, click the delete icon, then click Delete Link.

Error Notification

Indicates who is notified about errors. By default, the script owner is selected.

To set up the list of users who receive notifications, click Set Up Notifications and pick from these options:

Current User – Notifies the user running the SPA.
Script Owner – Notifies the script owner.
Notify All Admins – Notifies all users with the Administrator role.
Groups – Notifies all users in the selected group. To define new groups, go to Lists > Relationships > Groups > New.

In the Specific Email Addresses field, enter a comma-separated list of email addresses for other users who should be notified.

On the Logs tab, you can view the logs for the SPA. Click Refresh to reload the list and see new logs after running the SPA.
On the System Notes tab, you can view the changes to the SPA (creation and updates), including date/time, user, role of the user, type of action, object changed, and old and new values. The information about deletion actions is also kept. For more information, see System Notes v2 Overview.

Note:
Updates to Audience, Center Links, and Error Notifications aren't tracked yet.

To access the SPA management page and change the settings:

Related Topics