(8.3.0) Work with Desktop Applications

Qualitia for Desktop feature allows you to create script-less test cases to automate testing of desktop applications. It uses Micro Focus Unified Functional Testing (UFT) to add objects and test suite executions.

The functionality to work with test artefacts, such as creating test cases and executing test suites, for the desktop applications remains the same as the web and mobile applications.

However, the way you create test objects for desktop applications differs. This topic provides details on how to work with desktop objects.

Types of Desktop Objects

In Qualitia Automation Studio, a desktop object contains attributes such as class, properties, and property values.  

There are two types of desktop application objects:

Descriptive Programming (DP) 
You can create DP objects manually or import UFT objects from a Test Shared Repository (*.tsr file). If necessary, you can update the DP objects in Qualitia Automation Studio.
For detailed instructions on how to work with DP objects, refer to Working with DP Objects.

Object Repository (OR)
For the UFT objects that are stored in a Test Shared Repository (tsr), you can specify the path to the tsr file to map the repository with Qualitia Automation Studio. The UFT objects in the mapped repository are then available in Qualitia Automation Studio, which can be used in test cases. For detailed instructions on how to work with OR objects, refer to Working with OR Objects.

Supported Technologies

You can use Qualitia for Desktop feature to test desktop applications that are built on the following technologies.

Viewing Test Cases Associated with an Object

To view the test cases associated with an object:

1. Open the appropriate desktop project. 

2. From the Expand Menu, click Develop. 

3. Click the Objects tab.

4. From the tree view, right-click the object to select View Test Cases.
   A list of test cases associated with the object is displayed.

Working with DP Objects

You can create DP objects manually or import UFT objects from a Test Shared Repository (*.tsr file). If necessary, you can update the DP objects in Qualitia Automation Studio.

Adding a DP Object

To add a DP object:

1. Open the desktop project in which you want to add DP objects.

2. From the Expand Menu, click Develop.

3. Click the Objects tab.

4. In the left pane, click the DP object tree node.

5. In the right pane, click the New button.
   The New dialog box appears.

6. Do the following in the order listed:

   1. Select a parent object.

   2. Enter Object Name and Description.

   3. Select Technology and Object Class.

   4. Click Add.

   5. Double-click the property field to add an object property and its property value.

7. Click OK.

Editing a DP Object

To edit a DP object:

1. Open the desktop project that contains the DP object you want to edit.

2. From the Expand Menu, click Develop.

3. Click the Objects tab.

4. In the left pane, click the DP object tree node.

5. In the right pane, click the Edit button.

6. Make the necessary changes and clic

Deleting the DP Objects

Please note the following before you delete any DP object:

• You cannot delete an object that is used in a task or a test case

• If you delete a parent object, then all its child objects are also removed.

• You cannot delete a parent object if one of its child objects is used in a task or a test case.

• You cannot delete two child objects that are present under different parent objects simultaneously.

To delete the DP objects:

1. Open the desktop project that contains the DP object that you want to delete.

2. From the Expand Menu, click Develop.

3. Click the Objects tab.

4. In the left pane, click the DP object tree node.

5. Select the parent object for which you want to remove its child objects.

6. In the right pane, select a child object that you want to delete.

7. Press Ctrl and click all the objects that you want to delete.

8. Click Remove.

Importing DP Objects from a tsr or bdb file

You can import DP objects that are created using UFT into Qualitia Automation Studio. Simply export the DP objects on UFT as a tsr or a bdb file and import the file in Qualitia Automation Studio.

To import objects from a tsr or a bdb file:

1. Open the desktop project in which you want to import the DP objects.

2. From the Expand Menu, click Develop.

3. Click the Objects tab.

4. In the left pane, click the DP object tree node.

5. Click Import.

6. Locate the tsr or bdb file that you want to import and click OK.

If the importing of DP objects fails, then Qualitia displays error messages. To troubleshoot the importing errors, see the Import_Log.txt file located in the following location:

%localappdata%\Qualitia\WD\Logs

Working with OR Objects

For the UFT objects that are stored in a Test Shared Repository (tsr), you can specify the path to the tsr file to map the repository with Qualitia Automation Studio.
The UFT objects in the mapped repository are then available in Qualitia Automation Studio and can be used in test cases.

Mapping a tsr file with a Qualitia Project

You need to create a tsr file using UFT and map it with a Qualitia desktop project. After you map a tsr file, the objects in the mapped repository are available in Qualitia Automation Studio.

To map a tsr file with a Qualitia project:

1. Open the desktop project in which you want to add DP objects.

2. From the Expand Menu, click Develop.

3. Click the Objects tab.

4. Select a desktop project that you want to map with a repository, and click Edit.

5. Click the Browse (...) button next to the Global TSR Path field, and then locate and select the tsr file.

6. Click Save.
   The Objects screen now displays all the objects in the OR tree node.

Replacing the Mapped tsr File

To replace a mapped tsr file for a project:

1. From the Expand Menu, click Project Management.

2. Select a desktop project that you want to map with a repository, and click Edit.

3. Click the Browse (...) button next to the Global TSR Path field, and then locate and select the new tsr file.

4. Do one of the following:

Synchronizing OR Objects with the Test Shared Repository

Before you start synchronizing, you can preview to check whether all the objects in the updated tsr file are present to create the required test cases.

To synchronize OR objects with the test shared repository:

1. Open the Qualitia project which contains the OR objects that you want to synchronize.

2. Open the desktop project in which you want to add DP objects.

3. From the Expand Menu, click Develop.

4. Click the Objects tab.

5. Click Sync the TSR located at the top-right corner.

6. Do one of the following: