Script Runner

This area requires global administrator access in the global tenant context.

The Script Runner lets you execute administrative scripts from the browser with real-time log output and a history of past executions.


Accessing the Script Runner

From the settings gear in the top navigation bar, select Script Runner. The page opens showing a list of Recent Executions.


Recent Executions

The main Script Runner page shows a table of past script executions with the following columns:

ColumnDescription
ScriptThe name of the script that was run
StatusOutcome: pending, starting, running, completed, failed, or cancelled
Created ByThe user who initiated the execution
StartedWhen the execution began
CompletedWhen the execution finished (empty if still running)

Select any row, or the View (eye icon) in the Actions column, to open that execution’s detail and log view.


Running a New Script

  1. Select New Execution in the upper right corner.
  2. A dialog opens with a Choose a script to execute dropdown. Select the script you want to run — each option shows a name and description to help you identify it.
  3. After selecting a script, the form shows the parameters that script requires. Fill in each field:
    • Text fields — enter a value directly.
    • Number fields — enter a numeric value.
    • Toggle switches — flip on or off.
    • Dropdown fields — select from the provided options.
    • Tenant fields — select a tenant from an autocomplete list.
    • Business unit fields — use the business unit tree selector.
    • File fields — files are uploaded after the job is created (see below).
  4. Select Create Job to create the execution record. The dialog closes and you are taken to the execution detail view.

If you need to choose a different script, select the Back arrow inside the dialog to return to the script selection dropdown.


Uploading Required Files

If the script you selected requires one or more file parameters, you will see a Required File Uploads section on the execution detail screen after creating the job. Use the upload control for each file parameter to attach your file before executing. The section shows a checkmark once each file is successfully uploaded.


Executing the Script

Once the job is created (and any required files are uploaded), select Execute on the execution detail page. The button is available when the execution is in the pending state and all required files are uploaded.


Viewing Live Log Output

As the script runs, the Execution Logs panel streams output in real time. Each line of log output appears as it is produced by the script. The panel scrolls automatically as new lines arrive — if you scroll up to review earlier output, auto-scroll pauses; scroll back to the bottom to resume.

If you navigate away and return to a running execution, select Reconnect to Logs to resume streaming.

You can copy the full log output to the clipboard at any time using the Copy (copy icon) button in the log panel header.


Execution Detail

While viewing an execution, you can expand two collapsible sections to see more information:

  • Execution Details — Shows the script name, who created it, start and end timestamps, and (if applicable) the exit code.
  • Parameters — Lists the parameters that were passed to the script when it was created.

Starting Another Execution

From any execution detail view, select New Execution to return to the main page and run another script.