Quick Start

The first example uses only Ranorex Recorder and does not require any programming experience.

1. Create a new Ranorex test automation project by selecting the menu item 'File | New | Solution ...'.

: Define a name and a location folder for your Ranorex project

Now select the 'Ranorex Console Application' template from the category 'C#' and choose a name for your project.

: New Project dialog

The new project template now contains an empty recording file and the Program.cs file which is used to write Ranorex based test automation code.

: Empty Ranorex Studio project with integrated Ranorex Recorder

2. What we do next is to start a recording session which opens and automates the Calculator application.

Now press the 'Record' button within the recorder. Ranorex Studio will be now minimized.

: Ranorex Recorder start button

3. Open your calculator application via Windows start menu.

Note: Normal mouse movements are not currently recorded by the Ranorex Recorder. Please make a mouse click at each GUI element where normally only a simple mouse action would be necessary. This is especially important in recording menu items.

4. Now start a new calculation.

After pressing the sum button of the calculator application we would like to validate the result. To do this we click the 'Validate' button of the Ranorex Recorder tool bar.

: Ranorex Recorder tool bar

5. Recording is now paused. Move your mouse pointer over the calculator's text box.

Wait a moment to see that the text box is being tracked and is ready to be validated. Now click the highlighted GUI element to open the validation dialog.

: The frame specifies the element to validate

: The dialog shows the available attributes to check

Just check the 'Text' for validation and close the dialog by selecting the 'OK' button.

6. Now close the Calculator application and stop the recording by pressing the 'Stop' button of the Recorder toolbar.

Ranorex Studio appears and shows all recorded actions within the Recorders actions table.

: Recorded actions

7. Press the 'Play' button to replay the recorded actions and to validate the result of the calculator's text box after calculation.

: Replay the recorded actions

8. Now you can edit the code to execute the recording from your test application

Open the Program.cs file and insert follwing line of code.

: Calling 'Recording1.Start' method within main routine of your test application

9. Start your test application

Compile and start your application by clicking the 'Run' button.

: Starts your test application

Now the test automation executable is also available within your project folder. To run the test without starting Ranorex Studio or Ranorex Recorder simply double click the executable file.

: Ranorex Studio generated executable file