# Editor: Interface Overview¶

Alyvix Editor lets you visually create, edit and run complex scripts allowing Alyvix to interact with your applications just like a human user would. Each script consists of multiple test case objects, organized as sequential, conditional and loop commands, along with Sections and Maps.

The Editor interface includes the Alyvix Selector and Designer modules as collapsible panels, which lets you easily inspect and choose test case objects to include when building your scripts.

To run Alyvix Editor from the command prompt, use the following command:

C:\Alyvix\testcases> alyvix_editor -f <alyvix-file-name>


This loads the Editor interface, which has the following elements:

1. The Editor panel, consisting of the Script Management panel (left) and the Scripting panel (right)

2. The Selector pane, where test case objects can be dragged from and then dropped into the Scripting panel

3. The Designer pane, which shows the details of the currently selected test case object

Editor-Specific Features

The principle interface elements specific to Alyvix Editor are:

1. The test case menu (described below), containing actions for Alyvix Editor and the current test case

2. The main Script Management panel, used to select the principal scripts to be edited

3. The Sections list, containing user-defined scripts that can be used as subroutines within any of the principal scripts

4. The Maps list, containing user-defined maps where a script can be called multiple times, once for each key in the map that is then passed as an argument to the named script

5. The scripting mode selector, containing the Script tab to display the currently selected script or map, the Monitor tab to show the screen capture of Selector’s current test case object, and the Console tab to show the output after running the test case script from within Alyvix Editor

6. The scripting panel, which contains the individual scripting elements, placed there using Selector

7. The script properties and actions, where you can enable, disable or remove individual script elements that have been dropped into the scripting panel

8. Panel resizing controls allowing you to resize, minimize, or restore the three peripheral panels

The following actions are available from Alyvix Editor’s menu:

• — Run the current script displayed in the scripting panel (see below)

• New — Throw away the current test case, replacing it with an empty one

• Open — Replace the current test case with a new one chosen from the file dialog

• Save — Save the current test case with its existing filename, overwriting the previous version

• Save As — Create a copy of the current test case under a new file name

• Exit — Close Alyvix Editor

The Monitor Tab

When you need to quickly look at the positions of components in a test case object, the fastest way is not to return to editing the test case object in Designer. As long as you don’t need to change anything, you can use the monitor tab to see the screen capture for the test case object.

Launching Alyvix Robot from Alyvix Editor

The script of the test case currently loaded in Editor can be run by pressing the button at the top left. The starting point is the script specified in the scripting panel.

When run, Editor will be minimized until the scripted interaction has completed, after which Editor will reappear with the output available in the Console tab.

The output is the same as when run in the command prompt, but can be found in the tab at the top of Editor’s scripting panel:

In addition, if the a failure was caused by a simple sequential scripting node, then the annotated screenshot describing the failure will be displayed below the output in the Console tab.

Note that currently the verbosity level for Alyvix Robot cannot be set within Editor.