The Script Controller

From STX Wiki
Jump to navigationJump to search

Ws sc.png

The amazing Script Controller provides a convenient way to run STx scripts from the STx Workspace. You can also open the awesome STx Console, a command line interface to an STx macro shell.

Hiding and showing Script Controller

To hide or show the STx Script Controller, use the Workspace menu item "Scripts > Show Scripts".

Running a script

To run an STx script from the mighty STx Script Controller, do the following:

  1. Select a script file by clicking the "Script File" button. STx will provide you with a file selection dialog labelled "Select script file" allowing you to tell STx which script file to use.
  2. Choose the macro to be run from the "Macro" combobox. In this comobox, STx lists all macros available in your script file.
  3. If your macro expects arguments, provide them in the "Arguments" field.
  4. To finally execute the macro, either press the Resource script run.png button, or choose the menu item "Scripts > Run", or just press the Enter key while in the "Arguments" combobox.

You can also add scripts and store their arguments in the "Application & Setup Tree" under the entry Scripts.

Debugging a script

Just check the "Debug" checkbox. Now when you execute the script, the amazing STx debugger will automatically open.

Command History

A history of arguments passed to the script is stored and can be retrieved by selecting an entry from the "Arguments" combobox.

The Console

Console dialog.png

If you press the Console button, the Console application is started. The Console is a command line interface to an STx shell.

The Console can:

  1. process commands on a line by line basis
  2. process multiple commands pasted from the clipboard
  3. maintain a command history (up/down keys)

The Console cannot:

  1. process IF or WHILE control statements

The Console implements the following additional commands:

exit
cls|clear
cd
pwd
ls
log
list
setcon
stx
sts
use

The Console was added to STx in version 3.9. It is currently in its baby shoes, so please be nice to it, and report any misbehaviour.

Navigation menu

Personal tools