This page is maintained for older versions of Rapise only. The latest documentation can be found at:
Do Relative Analog Recording

Let's once again use our trusty over-simplified TwoDialogs sample application to learn how to use relative analog recording.


(1) Run the TwoDialogs sample AUT.  By default this will be located in C:\Users\Public\Documents\Rapise\Samples\TwoDialogs\TwoDialogs.exe

(2) Start Rapise and create a new test and call it TwoDialogsAnalogRelative.

(3) Press the Record/Learn button in the toolbar of Rapise.

(4) When the "Select an Application to Record" dialog is displayed, choose the TwoDialogs.exe application.  Since we will not be using a library for this recording, the library selection is irrelevant.  Press the Select button.

(5) The Recording Activity dialog will again be displayed with an empty grid.

NOTE:  this recording session is going o be a little different from previous sessions.  Previously we could interrupt our object-related recording/learning with other activities and because Rapise was recording activity only related the target application, our recording or object learning would be unaffected.  However, in analog recording, Rapise is monitoring the mouse and keyboard for the entire system - for all applications.  This means that if you answer an email in the middle of analog recording, or log in to a secure system, all the steps including mouse movement, keystrokes, etc., will all be recorded.  However, note also that screen contents are not recorded by Rapise.

(6) If the TwoDialogs UI has been occluded, bring it back to the front so you don't have to hunt for it during recording.

(7) When you're ready to record the session, hit the Analog button on the Recording Activity dialog.

NOTE: The key sequence Ctrl+4 starts an absolute analog recording session.  Press the Analog button to start the relative analog recording session.

When you press the Analog button, two things will happen.  Firstly, the status bar of the Recording Activity dialog will change to read, "Click on object to start analog recording."


After the next mouse click, Rapise is recording all mouse and keyboard activity until you stop the recording.

Secondly, a minimized window will be created that indicates that analog recording is in progress and allowing you to stop the recording.


(7) Go to the TwoDialogs AUT and click anywhere in the application's window to start the analog recording.

Click the mouse on the empty "Please enter your name" text box.

Type a name in the text box.

Hit the <tab> key or click the left mouse button to advance the input position to the second text box.

Type another name.

Move the mouse to the OK button and press the mouse left button.

(8) When you have recorded enough, switch to the Analog Recording dialog box and press the close button or press the key sequence Ctrl+Break.  If you use the "close" button on the Analog Recording dialog, the movement of the mouse to the Analog Recording dialog, and the mouse-click on the Close button will be recorded as part of the analog recording output.  This might not be a desirable outcome at playback time because the Analog Recording dialog will not be present and the mouse click will be played in a potentially random place on the screen.  For thjis rason, Ctrl+Break is probably a better option to terminate analog recording.

NOTE: The grid will have no entry added until you end the analog recording with the Close button in the Analog Recording dialog.  When you do, it will add an entry to the grid.


(9)   You can now record additional analog sessions if you wish.

(10) You can record normal object activity before and/or after the analog recording.  When you have finished all recording press the Finish button or hit Ctrl+3.

(11) The Rapise screen will now be restored and will have placed focus in the editor pane of the Rapise with TwoDialogsAnalogAbsolute.js scrip displayed.  You should see code something like the following:

      //Plays recorded events from "Analog\Analog0003.arf" file


(12) Press the Play button on the Rapise toolbar to playback the recording you made.  Be sure not to interfere with the mouse or keyboard whilst the recording is playing back.

NOTE: You will see all mouse and keyboard activity reproduced as the analog recording plays.  The recording will start from the point where you left-clicked the mouse to begin the recording (step 7 above) and will end with clicking the close button in the Analog Recording dialog.  If you used Ctrl+Break to end the recording then the last recorded activity will be the one that keystroke.

(13) When the analog playback is complete, use the mouse to move the Two Dialogs AUT to a different location on the screen.  Play the recording again, and watch the operation unfold.  The most important thing to realize is that the relative analog recording will playback the recording wherever the application is positioned on the screen.  This is because you used relative analog recording.  However, once the recording within the AUT is complete, all mouse motion and keyboard strokes are relative to the current position of the AUT.  Suppose that during analog recording, you click the OK button in TwoDialogs.exe, then move the mouse to terminate the recording using the analog recording Close button.  Now, prior to playback, you move the AUT to a different location on the screen and hit playback.  All the activity within the AUT will be faithfully reproduced.  However, the mouse motion outside the AUT will be relative to the position, so the following activities will not be accurately reproduced.  Try this for yourself, but be sure to minimize all applications before starting so you don't cause mouse events where they will do harm to other applications on the screen.