Test Cases

A Test Case consists of steps and may contain single or multiple tasks. Each step contains an action along with its associated objects and parameters. Define the sequence of the steps in a test case that resemble the flow of a test scenario. You can add test data as per the requirements.

A test case determines whether the application under test meets the defined specifications under the given set of conditions or variables. Test cases are also created to validate if an application meets the business and functional requirements.

Before you create a test case, create a test scenario or select from available test scenarios.

A Test Case Editor screen contains buttons that you can use to add steps or execute a test case.

The following table shows the description of each button.

Button	Button Name	Description

Button	Button Name	Description
	Create New task	To create a new task while adding or editing a test case. You need to select a step after which you want to create the new task
	Create Tasks using the selected steps	To create a new task using the steps of the test case. You need to select the steps.
	Import Task	To add a task that is already created in the project. Select a step after which you want to add a task.
	Detach Task	To remove a task from the test case. You need to select the task that you want to remove.
	Add Test Case Step	To add an independent test case step, that is, a step which is not part of any task.
	Add Task Step	To add a step in a task. You need to select a task in which you want to add a step. Note: If you add a new step, ensure that the execution of all the associated test cases are not affected.
	Remove Step	To remove a step from the test case. You need to select the consecutive steps.
	Add Conditional Block	To insert a conditional statement. For more information, refer to Conditional Structure (IF-ELSE).
	Move Up	To move up a selected step.
	Move Down	To move down the selected step.
	Start Web Recording	To start web recording on a web application under test. Or, if a recording session is on, then this button is replaced with the Pause Web Recording button (). Note: If you have already dry run a test case, you cannot record in the same session. You need to close the browser, open the test case, and then do the recording.
	Stop Web Recording	To stop the web recording session.
	Start Mobile Recording	To start web recording on a mobile application under test. Note: If you have already dry run a test case, you cannot record in the same session. You need to close the browser, open the test case, and then do the recording.
	Stop Mobile Recording	To stop the mobile recording session.
	Add Test Data	To insert test data. For more information, refer to Adding a Test Data.
	Dry Run	To dry run the test case. For more information, refer to Dry Running a Test Case.
	Debug	To debug a test case. For more information, refer to Debugging a Test Case.
	Debug Logs	To open the debug execution logs.
	Go To Line	To go to a specific line of a test case
	Previous Error	To go to the previous step, which has been identified as: Deleted: The objects are deleted Empty: The objects are not added. New Test data: Add with a new set of test data.
	Next Error	To go to the next step, which has been identified as: Deleted: The objects are deleted Empty: The objects are not added. New Test data: Add with a new set of test data.
	Save	To save the test case every time you update it. Also, you can click the arrow button to save it as another test case with a different name.

Define the sequence of the steps in a test case that resemble the flow of a test scenario.

You need to add or edit some or all the steps manually for a test case in the following situations such as:

To add certain actions that are not supported by Qualitia Automation Recorder.
To create a test case to automate testing on desktop applications.
To add certain General Web Actions and Mobile Actions.
To define conditional statements at the appropriate places.
To add custom actions at the appropriate places.

Before you start adding or editing steps manually, ensure that all the objects of the application under test are added in the Object Repository. For more information, refer to Working with Objects.

To add or edit a test case manually:

From the Expand Menu, click Develop.
On the Test Case Editor screen, from the left pane, open an existing scenario or create a scenario. For more details, refer to Working with Scenarios.
You can edit or add a test case of the selected scenario:
1. To edit a test case
  - Select a test case
    The Test Case Editor screen opens.
    If a test case is underlined with the red color, open the test case to resolve the steps that are also underlined with the red color. For more information, refer to Editing a Step Underlined with the Red Color.
2. To add a test case
  1. On the right pane, click the New Test Case button ().
  2. Enter a Test Case Name, Description, Manual TC ID, and File Name.
  3. Click OK.
    The Test Case Editor screen opens.
(Optional) To add a task from the first step, click Create Task. Enter a name and description for the task, and then click OK.
To add steps for the added task, refer to step 4.
To add an independent step or a task step
1. Click the Add Test Case Step button () to add a blank step in the Test Case Editor screen.
2. To add an object, double-click the Object cell to open the Object Repository hierarchy, and then select an object. For more information on objects, refer to Working with Objects.
  Note: You can right-click the object and select Edit Object to edit its properties. For more information, refer to Editing an Object.
  Some Generic Actions do not require an object such as OpenURL, Maximize Browser, and so on.
3. Double-click the Action cell and click the arrow button to select an Action.
  Note: As per the selected object, only the relevant actions are displayed. For more information, refer to Qualitia Actions.
  As per the selected action, the associated parameters in a single or multiple parameter cells are automatically displayed.
4. Enter the relevant values for the parameters. For more information, refer to Quailtia Actions.
  Similarly, you can add more steps that you want to add to the test case.
To add a task using the steps that you have defined
1. Select the steps, Press Ctrl and select the other steps that you want to add to the task, right-click and then select Add New Task.
2. Enter a name and description for the task, and then click OK.
  To add steps to the task, refer to step 4.
To import an existing task, select a step from where you want to insert the task, click the Import Task button () from the Test Case Editor screen.
To edit the steps for the imported task, refer to step 4.
If you edit the steps of the imported task, ensure that there is no impact on other test cases that are using the same task.
The task steps have white background, whereas the independent test case steps
To move a task or step to its appropriate place, select the task or step, and then click the Move Up button () or the Move Down button ().
After adding or editing all the tasks and steps, click the Save button () to save the test case.

If a task step is added with test data, you need to update the same task in other associated test cases. The associated test cases and test scenarios are automatically underlined with the red color in the left pane. If you execute the associated test cases (underlined with the red color) without updating the test data, the test case execution fails.

For more information, refer to Editing a Step Underlined with the Red Color.

You can now click the Run button () to dry run the test case to know whether expected results are achieved. For more information, refer to Dry Run a Test Case.

Qualitia recommends saving the test case after making every change in the test case.

You can use the following Qualitia Automation Studio features to enrich a test case:

Editing a Highlighted Step

The Test Case Editor highlights the steps that have issues with a red underline and a vertical red line next to the step number. Similarly, the associated problematic tasks, test cases, and test scenarios that need resolution are also highlighted.

You must resolve the highlighted steps to avoid test case execution failures.

The following figure shows how steps, tasks, test cases, and test scenarios are highlighted:

The highlighted steps may have one of the following problems:

The task step does not have test data. Add the relevant test data for that task step. For instructions on how to add test data, refer to Adding Test Data for a Test Case.
The step contains an empty object, which means that one or more of the object property values are blank, such as locator type and locator value.
The step contains a deleted object, which is applicable for the desktop projects only. The object was deleted from the objects repository due to updates in the synchronized TSR file.

To navigate through the highlighted steps, select any step in the Test Case Editor screen, click the Next Error button () or the Previous Error button ().