Page Content

1 References
2 Scripting Feature Overview
3 Adding a new script
4 Editing a script
5 Running a script
- 5.1 Demonstration
- 5.2 Triggering a script from a Button widget
6 Limitations

References

This page explains the Scripting Feature

For technical information about the Python API capabilities, refer to the documentation: [Py] Class reference
For useful script examples to get started, refer to the documentation: [Py] Usage

Scripting Feature Overview

Scripts serve as powerful tools within Dashboards, providing users with the capability to leverage Python scripts directly within the platform. Dashboards offer a Python API and a dedicated environment for executing Python scripts seamlessly.

The Scripts Panel is accessible in the Navigation pane, and is composed of the Script list, the Script Editor, and the Logs.

Adding a new script

To add a new script, click on the button of the Script list.

The generated template script will show you how to access the current project, which is the entry point of the API. For more information about the Python API capabilities, refer to the documentation: [Py] Class reference

Editing a script

You may edit a script in Dashboards directly, or in an external environment.

Autosave: When editing your scripts from Dashboards, your changes will be saved automatically.

Running a script

To run a script, you may either:

Click on the button in the Script list.
Click on the Run Script button in the Script editor.

Logs: The logs displayed in the Logs pane are contextualized for the selected Script in the Script list. Only the most recent Log of each Script is saved.

Demonstration

In a panel, the Button widget can be used to trigger a script. Once in operate mode, the script will run on button press whether the simulation is running or not.

While many scripts may be ran at once, only one instance of the same script can run at the same time.

Scripting