Skip to content

Tutorial: Manual Testing

Purpose

Exploratory manual testing is used for situations where you have a new or changing application and the user interface is still evolving. Traditional manual testing, where you create a test case ahead of time, define prescriptive test steps, and then assign them to a tester, is not practical in such cases. The solution is to perform exploratory testing, where you explore the application while simultaneously creating the test script. The created test script can then be published to your test management system (i.e., SpiraTest) for future regression testing.

Rapise can help accelerate and optimize exploratory manual testing. Rapise lets you walk through the application, capturing your interactions as you use the application, and recording screenshots of the objects and screens you interact with. Based on this, Rapise will create a fully formed test script ready for use.

Step 1 - Creating a New Test

To start manual testing, simply create your test as normal using the New Test dialog box and choose Manual methodology:

Manual Methodology

Once the test has been created, click the Tools > Manual Steps menu item to be taken to the Manual Editor, with the Manual Toolbar visible.

The test step list will initially be empty:

Manual Steps

Step 2 - Recording Some Steps

Now, open the application you want to record. In this example, we will be testing the built-in Microsoft Paint application. This is a good candidate for manual testing, as much of its functionality is difficult to test automatically due to its simple drawing canvas, rather than discrete buttons and data elements.

To ensure that screenshots are recorded, while keeping their size reasonable, use the following recording options:

manual_recording_2

Now click the Record Manual button (or menu Test > Record Manual) and choose MS Paint from the list of running applications in the Select Application to Record dialog, then click 'Select' to start recording.

As you click through the application, the recording will display the list of steps and actions being captured:

manual_recording_3

In this example, we created a new canvas, chose the Pencil tool, drew a design using the pencil, entered some text, and then made it bold:

manual_recording_3b

When you click Finish to complete the recording, Rapise will display the list of populated manual test steps, complete with embedded screen captures:

manual_recording_4

Notice that each recorded test step already has a Description and an Expected Result, along with a screenshot of the user's actions. In addition, the Sample Data contains the equivalent Rapise automation code for reference. This can be useful later if you decide to automate this test.

Step 3 - Editing the Steps

Typically, you may want to add some additional steps (e.g., we added a line to describe the process of starting MS Paint), delete any duplicate or unnecessary steps, and reword them to make the most sense to the tester. In our example, we used the manual editing screen to update the steps as follows:

manual_recording_5

Click Save to ensure all updates are saved locally. Before you can execute these tests, you will need to save them to Spira (our web-based test management system).

Step 4 - Saving to Spira

Click the Save to Spira option. You will be asked to confirm the creation of the document folder in Spira that will hold the test files:

manual_recording_6

Click Create, and then click OK in the Synchronize Files dialog. The manual test will be saved to Spira. You will see that this process adds unique Spira test step IDs to each step. They are displayed using the format [TS:xxx]. This special token [TS:xxx] can be used in Tester.Assert commands to relate specific verification points with test steps during automated testing.

manual_recording_7

Now that the test has been saved in Spira, you can click the View Manual Test in Spira toolbar button to see how the test steps appear within Spira.

view manual in spira

manual_recording_8

Now that we have finished the recording, we can play back this manual test.

Step 5 - Executing the Manual Test

Choose the Release from the list of available releases in the project:

manual_playback_1

Then, click the Execute icon to start manual test execution. This will bring up the manual playback screen:

manual_playback_2

On this screen, we will follow the steps listed in the test case. This involves opening MS Paint, creating a new canvas, adding some lines using the pencil, and then adding some text using the text tool. As you perform these steps, click the Pass button to indicate that each step has passed. You can also minimize the manual playback screen by clicking the >| button.

Once you reach Step 6, we will pretend that MS Paint failed to display the text correctly. Enter a message to that effect in the Actual Result field:

manual_playback_3

Next, we will attach a screenshot of what actually happened and log a test failure.

Step 6 - Capturing and Annotating a Screenshot

Click the Image icon in the rich text editor associated with the Actual Result text box. This will bring up the Drawing Tools screen, which prompts you to draw a rectangle to select a portion of the current screen for capture:

manual_playback_4

If the MS Paint application is not in the foreground, simply press Esc on your keyboard to abort, rearrange your windows, and then try again. Once you have selected the rectangle, the drawing tools will display your selected image in the image editor:

manual_playback_5

You can now use the annotation tools to add labels, text, and other items to explain the issue you found:

manual_playback_6

In the example above, we added a red ellipse, arrow, and text to mark the issue observed in MS Paint. Once you are satisfied with your image, click Accept, and the image will be included in the test's Actual Result:

manual_playback_7

Finally, Fail Step 6 and click the Finish button.

Fail Step

The results will be posted to Spira.

Step 7 - Viewing the Results

To view the results in Spira, click the View > View Manual Test in Spira menu. This will bring up the test case in Spira. Now, click the Failed hyperlink in Spira, and the new test run will be displayed:

manual_playback_10

If you scroll down, you can see the individual test steps that were executed, along with the associated actual result (including the captured screenshot):

manual_playback_11

Congratulations! You have now successfully executed a manual test using Rapise.

See Also