User Tools

Site Tools


en:actions

This is an old revision of the document!


Actions

An Actionaz script is made of actions that are sequentially executed.

Every action has:

  • a checkbox allowing you to disable it
  • a line number or a label that allows to to identify it
  • a parameter list
  • a commentary (optional)

You can specify a pause before and after the execution of the action, so as a maximum execution duration.

Line number/Label

The line number or the label allows you to specify the targeted script line of a position change. (goto)

A label allows you to set a fixed position in the script as the line number can vary.

To define a label, double-click on the left part of the action line. Entering no text removes the label. Even if a label exists it is still possible to use the line number to identify an action.

Parameter list

Input parameters

Input parameters (purple background) can be of different types and can also be empty. In that case the default value will be used.

Output parameters

Output parameters (yellow background) allows you to retrieve data after the action has been executed. This data is stored into a variable whose name is the value of the output parameter field.

Common parameters

Some parameters are common to every action:

  • pause before: pause before executing the action
  • pause after: pause after having executed the action
  • timeout: maximum execution time; a Timeout exception is thrown if the execution duration exceeds this value

Exceptions

Exceptions are events that can be triggered during the execution of an action.

Most of the time these are the result of an error in the action parameters. An exception is also thrown if the maximal execution time of an action is exceeded.

Depending on the parameters chosen, an exception can interrupt the script execution, skip the current action or jump to another script line.

Comment

It is also possible to enter a comment to help identifying what an action does.

Color

Each action can also have a background color. This can help visually identifying a group of actions. Select one or more actions and choose "Action color" → "Set action color" or press Ctrl+E to set the background color.

Action list

These are the official actions of Actionaz 3.

Windows

Actions of this category act upon the windowing system of the operating system.

Devices

These actions act upon computer devices.

  • Cursor path : moves the mouse cursor along a path
  • Click : emulates a mouse click
  • Move cursor : moves the mouse cursor at a position on the screen
  • Wheel : emulates a mouse wheel movement
  • Key : emulates a key press or release
  • Write text : emulates text writing

System

These actions act directly on the operating system.

  • Command : executes a command or start a process
  • Detached command : executes a detached command or start a detached process
  • Pixel color : checks the color of a pixel and acts upon
  • Kill process : kills a process
  • Play sound : plays a sound file or a distant stream
  • Open URL : opens an URL with the default browser
  • Notification : shows a notification (GNU/Linux only)
  • System : restarts, stops, or suspends the operating system

Internal

The following actions act upon the script execution.

  • Goto : sets the next action to execute
  • No-op : does nothing
  • Loop : sets the next action to execute multiple times
  • Code : executes Javascript code
  • Variable condition : checks the value of a variable and act upon
  • Time condition : checks a time condition and act upon
  • Console : writes an entry into the Actionaz console
  • Pause : pauses the script execution for a specific duration
  • Exit Actionaz : exits the program
  • Variable : acts on a variable
  • Stop : stops the script execution

Data

These actions act upon data.

en/actions.1317568372.txt.gz · Last modified: 2021/02/13 11:23 (external edit)