Managing Single Page Applications Included in SuiteApps

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

You can manage some configuration settings for these SPAs in the SPA management page, if you have the required permission level (Edit or Full level of the SuiteScript permission).

To access the SPA management page and change the settings:

Go to Customization > Scripting > Single Page Applications. The system displays a list of all of the SPAs in your account with the following 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).
On the list, click the SPA Name to open the management page for that SPA.
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 modify the settings of your SPA. The following table shows the fields available on this tab.

Field	Description	How to Configure
Execute As	Determines 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 selected in this field, click the edit icon to display the list of available roles. Select a role, 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 to display the log level options. Select a value, and click Save.
Release Audience	Determines who can execute the SPA. When the SPA is created, it runs only in the accounts of the roles selected in this field. If no roles are specified, the SPA is accessible only for the script owner.	To change the audience, click the Set Up Audience button to see the current roles selected and other possible options. You can filter the list by entering the name of the role. To make the SPA available to any role, check the All Roles box. To add roles, check the boxes for each role on the left pane, and click the right arrow to add it to your selection. To remove roles, check the boxes for each role on the right pane, and click the left arrow to remove it from your selection. 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 the Add Link button. On the Center Link window: In the Menu Location field, select 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 in the location you specify. If you want your link to be inserted before an existing element, select a value in the Insert Before field. In the Label field, enter the label for the SPA link. Click Save. You need to reload the page to see the new link from the menu location you specified. You can add only one link per menu location. To edit an existing center link, click the edit icon and edit the fields that you want to update. Click Save. To delete an existing center link, click the delete icon, then click the Delete Link button.
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. Select from the following options: Current User – Notifies the user running the SPA. Script Owner – Notifies the user who owns the script. Notify All Admins – Notifies all users with the Administrator role. Groups – Notifies all users who are part of the selected group. To define new groups, go to Lists > Relationships > Groups > New. In the Specific Email Addresses field, you can enter a comma-separated list of email addresses of other users who should be notified.

Field

Description

How to Configure

Execute As

Determines 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 selected in this field, click the edit icon to display the list of available roles. Select a role, 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 to display the log level options. Select a value, and click Save.

Release Audience

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

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

To make the SPA available to any role, check the All Roles box.
To add roles, check the boxes for each role on the left pane, and click the right arrow to add it to your selection.
To remove roles, check the boxes for each role on the right pane, and click the left arrow to remove it from your selection.

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 the Add Link button. On the Center Link window:
- In the Menu Location field, select 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 in the location you specify. If you want your link to be inserted before an existing element, select a value in the Insert Before field.
- In the Label field, enter the label for the SPA link.
Click Save. You need to reload the page to see the new link from the menu location you specified. You can add only one link per menu location.
To edit an existing center link, click the edit icon and edit the fields that you want to update. Click Save.
To delete an existing center link, click the delete icon, then click the Delete Link button.

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. Select from the following options:

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

In the Specific Email Addresses field, you can enter a comma-separated list of email addresses of 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 any new logs after running the SPA.
On the System Notes tab, you can view the changes on the SPA (creation and updates), including the following information: date/time, user, role of the user, type of action, object changed, and old and new values. The information about deletion actions is also retained. For more information, see System Notes v2 Overview.

Note:
Updates on the values of following fields: Audience, Center Links, and Error Notifications are not yet tracked.

To access the SPA management page and change the settings:

Related Topics