Enter the name in the text box labelled "Executable". If you are unsure of the application's name, or where to find it on your system, press the button labelled "Executable". This produces a file selection box containing an extra scrolled list.
Each item in the extra scrolled list is a directory from your PATH. Selecting an item from this list displays the contents of that directory in the "Files" list.
When you select an entry from the "Files" list and "OK" the dialog, the entry is placed in the "Executable" field of the Capture/Replay Application Prompt dialog. Enter any flags or arguments for the application in the text box labelled "Arguments" in this dialog. When you press "OK", the application is run with X-Designer Replay.
Two points need to be made here:
X-Designer Replay focuses on recording navigation between widgets within an application and the user interaction with those widgets. The following information can be recorded and replayed:
X-Designer Replay has not been designed as a general-purpose X testing engine and, consequently, there are some aspects of the use of an application which X-Designer Replay does not record. However, facilities are given for extending the X-Designer Replay widget set and adding your own X-Designer Replay commands.
The X-Designer Replay dialog appears to the side of your application. A copyright message is also shown on standard error when X-Designer Replay starts up.
If the copyright message does not appear, your application has probably not been dynamically linked with the Xt library.
This dialog has two pages - one for X-Designer Replay (Replay) and one for X-Designer Capture (Capture). You can change between pages by selecting from the option menu labelled "Page".
Once the X-Designer Replay dialog is displayed, you can begin to record/replay scripts straight away. All record/replay actions take place using the X-Designer Replay button panel.
The buttons are described below:
Record - records user actions in the application from the current position in the selected script. If record is pressed after stopping a script, it will overwrite the script from that point on. Pressing record at the end of a script will append to it.
Insert - records user actions in the application at the point where the script was stopped. Subsequent actions in the script are preserved.
Rewind - rewinds the selected script to the beginning.
To replay the script exactly, you may have to reset the application to the state from which the recording was made.
Stop - stops the playback of a script.
Play - plays the selected script from the current position in the script until either the script is stopped or reaches its end.
Single step - plays the next command in a script.
Pause - pauses a record or playback. Press the button again to continue.
Only valid buttons can be selected; all other buttons are grayed out.
Before you have created any scripts, the only button you can press is "Record". This creates an "unnamed" script. Once you have created a script, you can "Rewind", "Play" and "Single step" it.
The "Insert" button becomes active when the script is stopped or paused.
Press the "New Script" button to create an empty script. To name or rename a script, do the following:
If you enter the same name as that of an existing script, a number is appended to the newly named script to differentiate between it and the original.
The currently selected script is highlighted in the X-Designer Replay dialog.
The X-Designer Replay status indicator shows you whether you are recording or replaying and where in the script you are. If the status indicator is red, it indicates that you are recording. Otherwise you are replaying.
The last button you selected has a red line above it in the button panel.
The "Monitor" button displays a log of the actions you are taking while recording and replaying. Comments indicating the start and end of a record or replay session are inserted automatically by X-Designer Replay.
As well as actions, you can also add non-application commands and comments to a script.
This can be done by editing the script by hand or via the X-Designer Replay interface. This section describes how to edit the script from the interface.
First stop the script at the point where the additional commands are to be placed. To place extra commands at the start of the script, you must first rewind it. To place commands at another point in the script, single-step to that point.
Next press the button labelled "Extra Commands". This displays a text edit window into which the extra commands or comments can be entered.
If the "Enter as comment" toggle is set, the contents of the dialog are treated as comments. Each line is prepended with a `#' character in the script.
The "Run" button executes the commands in the dialog independently of the recorded script. Use the Monitor window to see the commands being executed. Once you are satisfied with the commands, press the "Add" button to store them in the script.
Press "Clear" before entering additional commands or comments. This removes the information from the Extra Commands dialog - it has no effect on the contents of the script.
The fast/slow slider on the X-Designer Replay dialog allows you to change the speed at which the selected script is replayed. By default, the script is played at the maximum speed.
By default, the scripts you create in the X-Designer Replay dialog are stored in a temporary unnamed directory.
Use the The "Save As" option from the X-Designer Replay Directory menu to save the current directory under a new name.
Use the "Open" option from the Directory menu to access scripts from another directory. The "Save As" option can also be used to rename the currently opened directory.
Using the operations in the "Edit" menu, scripts can be cut or copied from one directory and pasted into another. The "Clear" command deletes the selected script.
By convention, record scripts are given the filename suffix ".xds" in the file system. Note however that this suffix is not used to label the scripts in the X-Designer Replay dialog.
See also:
!XDHIGNORE>