Managing scripts for tenant and analytics administrators
If you are a tenant admin or analytics admin, you can move scripts between managed spaces or between self-managed (personal or shared) spaces, change owner of scripts, delete scripts, and manage reload schedules.
Administrator access levels for managing scripts
Tenant and analytics administrators have different levels of access to scripts:
-
Tenant administrators: Can manage all scripts in managed, shared, and personal spaces.
-
Analytics administrators: Can manage scripts in managed and shared spaces. Cannot manage scripts in other users' personal spaces.
Scripts overview
To manage scripts, go to the Content page in the Administration activity center and open the Scripts tab. The tab displays a table with information about the owner of the script and the space where it is located. You can also see when the script was last updated and find details about scheduled data reloads. You can sort by the columns Name or Last updated, and filter by Name, ID, Owner or Space.
Select Source or Published in the dropdown list above the table:
-
Source shows scripts that are in personal or shared spaces. As a tenant admin or analytics admin, you can perform the following actions on these scripts:
- Manage the script reload schedule
- Change the owner of the script
- Move the script to another space
- Delete the script
-
Published shows scripts that are in managed spaces. As a tenant admin or analytics admin, you can perform the following actions on these scripts:
- Manage the script reload schedule
- Move the script to another space
- Delete the script
Changing owner of scripts
As a tenant or analytics admin, you can change owner of a script.
Do the following:
- In the Administration activity center, go to Content > Scripts.
- Select Source.
- Select one or more scripts and click Change owner.
- In the Change owner dialog, select the user you want to make the new owner, and then click Apply.
Changing space of scripts
As a tenant or analytics admin, you can move a script to another space.
Do the following:
- In the Administration activity center, go to Content > Scripts.
- Select Source or Published.
- Select one or more scripts and click Move.
-
In the Move dialog, select the space where you'd like to move the scripts, and then click Confirm.
Information noteWhen changing the space of a script, you might need higher permissions. If required, select the Get elevated privileges checkbox before confirming.
Elevated privileges are required if you're not the owner of the script or don’t have Can manage permission for either the current or new space. These privileges are temporary and will be reverted after the space change is complete.
Managing scheduled reloads of script data
Reloading a script loads the latest data from the script data sources and then exports it. Scripts can be reloaded manually from activity centers or automatically based on a schedule.
As a tenant admin or analytics admin, you can view and delete reload schedules from the Administration activity center. You can see the time of the last reload and the next planned reload. With proper permissions in the spaces where the scripts and data sources are stored, you can also create and edit reload schedules.
For detailed information on reload schedules, including limitations and considerations when working with schedules, see Reloading scripts. For information about the permissions required to reload data, see Managing permissions in shared spaces and Managing permissions in managed spaces.
Viewing status of script reload schedules
The Scheduling column in the scripts table displays the status of a script's reload schedule. An empty column means the script has no reload schedule. The schedule statuses are:
-
Scheduled: The script has an enabled reload schedule. Hover over this status to view the timestamp of the last reload and the next scheduled reload.
-
Schedule disabled: The script has a schedule that is currently disabled. Hover over this status to check the timestamp of the last failed reload attempt. A reload schedule is disabled after failing to execute five times in a row.
Statuses for reload schedules in the scripts table.
Creating or editing reload schedules
Tenant admins and analytics admins with the appropriate space permissions for a script and its data content can create a new reload schedule or edit an existing one. The schedule can be based on frequency, date, time, or when a dataset in the script is refreshed.
Do the following:
-
In the Administration activity center, go to Content > Scripts.
-
Select Source or Published and locate the script for which you want to add or edit a reload schedule.
-
Click
, and then select Reload schedule. -
If you are adding a new schedule, click Add schedule in the Reload schedule dialog.
-
Configure a new reload schedule or edit the existing schedule.
For detailed information on how to configure reload schedules, see Reloading scripts.
-
Click Save.
Ownership of reload schedules
A time-based scheduled reload runs on behalf of the user that is assigned to the reload schedule (the reload schedule owner), rather than the script owner. Certain actions will result in changes to who is assigned to the reload schedule. The user assigned to the reload schedule is determined by the following rules:
-
When you create a reload schedule for a script that did not previously have one, you become the owner of that reload schedule. In other words, it is assigned to you.
-
If another user edits or saves an existing reload schedule, ownership is transferred to them. In other words, the reload schedule is now assigned to them.
-
If another user modifies the script's load script by making edits in Data load editor (or by loading data in Data manager), ownership is transferred to them in most cases (it will be assigned to them). However, if this user is already the most recent user to edit the load script, the ownership of the schedule will not transfer to them.
Deleting reload schedules
Tenant admins and analytics admins can delete existing reload schedules from the Administration activity center.
Do the following:
-
In the Administration activity center, go to Content > Scripts.
-
Find the script that you want to delete the reload schedule from.
-
Click
, and then select Reload schedule. -
In the Reload schedule dialog, click Delete.
Deleting scripts
As a tenant or analytics admin, you can delete scripts.
Do the following:
- In the Administration activity center, go to Content > Scripts.
- Select Source or Published.
- Select one or more scripts and click Delete.
-
In the Delete scripts dialog, select the checkbox to confirm the deletion, and then click Delete.