Add Desktop Objects

Recording Link: KT sessions for Support on Qualitia 9-20230821_170310-Meeting Recording.mp4 (sharepoint.com)

Amid rapid digital transformation, Qualitia Automation Studio’s (QAS) “Desktop Objects” feature offers a robust solution for efficient test automation. 🔧

💻 QAS’s Desktop Objects feature is crafted to streamline the creation, maintenance, and usage of desktop application test objects. With this feature, users can import and synchronize objects from HP Unified Functional Testing’s (UFT) shared object repositories, ensuring seamless integration and alignment between your testing tools and repositories. This flexibility caters to diverse project needs and significantly boosts the efficiency of your test automation process.

• 🚀 Compatibility: One of the standout attributes of the Desktop Objects feature is its compatibility with other test automation tools. This feature fosters a harmonized work environment, resulting in improved productivity and quality of your test automation efforts.

• 🎯 Convenience: Setting up and using the Desktop Objects is simple and intuitive. Users can effortlessly import shared object repositories, view the imported objects, and manage the associated properties all within the QAS interface. This ease of usage reduces the learning curve for a team, allowing them to focus on other aspects of software quality.

• ⏱️ Efficiency: The true potency of the Desktop Objects feature lies in its ability to create and manage test cases that accurately reflect the desktop application under test. This not only refines the test case creation process but also saves valuable time for your test automation team.

• 🔄 Synchronization: QAS adopts an innovative approach to sync object, ensuring your test objects in QAS are always up-to-date with the shared object repository. This feature enhances the stability of your test cases, reducing test execution failures due to outdated or missing objects.

• 📂Intuitiveness: Desktop Objects feature provides a logical structure to manage your objects, making it easier for your team to navigate and handle these crucial test automation elements.

• 🔐 Secure: QAS safeguards all your desktop objects, ensuring they are secure and only accessible within the confines of the Qualitia Automation Studio environment. This assures control and integrity over your test objects, promoting quality assurance in your test automation process.

Introduction

As a Software Automation Engineer, you can use QAS for Desktop to create script-less test cases for desktop applications. This software leverages Micro Focus - Unified Functional Testing (UFT) to add objects and manage test suite executions.

The functionality for handling test artefacts, like test case creation and test suite execution, remains the same across desktop, web, and mobile applications.

However, creating test objects for desktop applications is a different process. This guide will walk you through the specifics of working with desktop objects in Qualitia.

Desktop Objects in Qualitia Automation Studio

In QAS, Desktop Objects include attributes such as class, properties, and property values. You will work with two types of desktop application objects:

Descriptive Programming (DP):

• Create DP objects manually or import UFT objects from a Test Shared Repository (*.tsr file).

• Update the DP objects in Qualitia Automation Studio when necessary.

Refer to Working with DP Objects for detailed instructions.

Object Repository (OR):

• For UFT objects stored in a Test Shared Repository (tsr), specify the path to the tsr file to map the repository with Qualitia Automation Studio.

• Use UFT objects from the mapped repository in your test cases.

Refer to Working with OR Objects for detailed instructions.

Supported Technologies

Use Qualitia for Desktop to test desktop applications built with the following technologies:

Object Repository

Import Objects from a TSR or BDP file.

After importing DP objects, QAS will only add the new DP objects without updating or removing existing ones. If any object name and its class for an imported DP object conflicts with an existing object, QAS will append '_' followed by a sequential number (starting from 1) in the object name.

Follow these steps to import objects from a TSR or a BDB file:

1. Login to Qualitia Automation Studio Client <insert Screenshot>

2. Access Develop from left navigation of your Qualitia Automation Studio -Client to view Test Explorer screen.

3. Click Objects icon from extreme right of the toolkit.

4. You will see Object Repository.

5. When you are landing on this page for the first time, you will see a button to Import Objects.

6. If Objects are already added, all the Objects under the Desktop Project will be listed.

7. All the Objects listed will be alphabetically sorted.

8. Click the Import Objects icon or Import Objects button if you are seeing one in the Object Repository section.

9. A new popup will appear where you can

   1. Enter TSR Name.

   2. Locate the TSR Select TSR Path file.

10. Click Import Objects.

11. You will see a Progress Indicator followed by the TSR being listed in the Object Repository.

12. If you see a Spinner icon next to TSR Name, it indicates that Upload is currently in progress. You can click the X button next to spinner icon to cancel the upload.

13. Once loaded, all the TSR objects will be listed in Object Repository.

14. Click the Expand Button before the TSR name to view the Objects.

15. If you wish to update another TSR file, follow the same steps.

16. If you have multiple TSR files added and wish to reorder the execution, select the TSR you want to change order and click the Reorder icon.

17. This will bring a pop up where you can drag and drop to reorder.

18. Order done, click Save else click Discard.

Modify Objects imported from a TSR file.

1. Login to your UFT.

2. From top navigation menu, click Resources.

3. Select Resources Manager from the list.

4. From the File menu, click Open.

5. Enter the path for TSR file in Qualitia Automation Studio Project Folder.

6. Once the file is loaded in UFT, click Edit button.

7. Perform the necessary actions like

   1. Adding a new object

   2. Modifying an existing object

   3. Removing an existing object

8. Click Save.

9. Navigate to Qualitia Automation Studio Object Repository.

10. All changes to TSR Objects will be Automatically Synchronized.

11. If you see a Spinner icon next to TSR Name, it indicates that synchronization is currently in progress. Wasit for the synchronization to be completed to view the changes.

Edit an uploaded TSR file.

1. Login to Qualitia Automation Studio Client <insert Screenshot>

2. Access Develop from left navigation of your Qualitia Automation Studio -Client to view Test Explorer screen.

3. Click Objects icon from extreme right of the toolkit.

4. You will see Object Repository.

5. When you are landing on this page for the first time, you will see a button to Import Objects.

6. If Objects are already added, all the Objects under the Desktop Project will be listed.

7. All the Objects listed will be alphabetically sorted.

8. Hover on a TSR File you wanted to edit.

9. You will see an Edit (pencil) icon.

10. Click Edit.

11. A new popup will appear where you can update TSR Name.

12. Click Save to update and Discard to discard.

Delete an uploaded TSR file.

1. Login to Qualitia Automation Studio Client <insert Screenshot>

2. Access Develop from left navigation of your Qualitia Automation Studio -Client to view Test Explorer screen.

3. Click Objects icon from extreme right of the toolkit.

4. You will see Object Repository.

5. When you are landing on this page for the first time, you will see a button to Import Objects.

6. If Objects are already added, all the Objects under the Desktop Project will be listed.

7. All the Objects listed will be alphabetically sorted.

8. Hover on a TSR File you wanted to edit.

9. You will see a Delete (Bin) icon.

10. Click Delete.

11. A new popup will appear where you can confirm deletion.

12. Click Delete to Delete and Discard to discard.

Descriptive Programming (DP) Objects

Add a DP Object

Follow these steps to add a DP object:

1. Login to Qualitia Automation Studio Client <insert Screenshot>

2. Access Develop from left navigation of your Qualitia Automation Studio -Client to view Test Explorer screen.

3. Click Objects icon from extreme right of the toolkit.

4. You will see Object Repository.

5. When you are landing on this page for the first time, you will see a button to Import Objects.

6. If Objects are already added, all the Objects under the Desktop Project will be listed.

7. All the Objects listed will be alphabetically sorted.

8. Click Descriptive Programming node in the bottom pane.

9. You will have two options:

   1. Import from a TSR or BDP file

      1. Click Import Objects button.

      2. A popup will appear

      3. From the Import Path field, locate the TSR or BDP file.

      4. Once done, click Get Objects, click Discard if accidentally clicked.

      5. You will see a Progress Indicator.

      6. If you see a Spinner icon next to Descriptive Programming node, it indicates that Upload is currently in progress. You can click the X button next to spinner icon to cancel the upload.

      7. Once loaded, all the TSR objects will be listed in Object Repository > Descriptive Programming node.

      8. Click the Expand Button before the TSR name to view the Objects.

   2. Create Object Manually

      1. Click Create Object button.

      2. A form will appear where you can

         1. Enter Object Name

         2. Select Technology

         3. Select Class

         4. Select Parent

         5. Enter Description

         6. Add Properties

            1. Locator

            2. Locator Value

      3. Once entered, click Save to add and click Discard to discard.

10. You will see all the added objects under Descriptive Programming Node.

11. While adding new objects, you have two options:

    1. To create a parent object, click on Add Object at same level.

    2. To create a child object, find the parent object under which you want to add the child.

    3. Click Add Contained Object button.

       1. Follow the same process for adding an Object (9.b).

Edit a DP Object

Follow these steps to edit a DP object:

1. Login to Qualitia Automation Studio Client <insert Screenshot>

2. Access Develop from left navigation of your Qualitia Automation Studio -Client to view Test Explorer screen.

3. Click Objects icon from extreme right of the toolkit.

4. You will see Object Repository.

5. When you are landing on this page for the first time, you will see a button to Import Objects.

6. If Objects are already added, all the Objects under the Desktop Project will be listed.

7. All the Objects listed will be alphabetically sorted.

8. Click Descriptive Programming node in the bottom pane.

9. Double click the object you wanted to edit.

10. You will see the Object Details.

11. Click Edit (pencil) icon to enable edit mode.

12. Make necessary changes.

13. Click Save update else click Discard to not update.

14. While adding new objects, you have two options:

    1. To create a parent object, click on Add Object at same level.

    2. To create a child object, find the parent object under which you want to add the child.

    3. Click Add Contained Object button.

       1. Follow the same process for adding an Object (9.b).

Delete DP Objects

Follow these steps to delete DP objects:

1. Login to Qualitia Automation Studio Client <insert Screenshot>

2. Access Develop from left navigation of your Qualitia Automation Studio -Client to view Test Explorer screen.

3. Click Objects icon from extreme right of the toolkit.

4. You will see Object Repository.

5. When you are landing on this page for the first time, you will see a button to Import Objects.

6. If Objects are already added, all the Objects under the Desktop Project will be listed.

7. All the Objects listed will be alphabetically sorted.

8. Click Descriptive Programming node in the bottom pane.

9. Double click the object you wanted to edit.

10. You will see the Object Details.

11. Click Delete (Bin) icon to enable edit mode.

12. Press Ctrl (in Windows) and click all the objects that you want to delete.

13. You will get a popup to confirm. Click Delete else if you don’t want to delete click Discard.

💡 Golden Nuggets: Best Practices for Desktop Object Management

<TBD>

🔧 Got a problem? Let’s fix!

Sometimes you might face issues while working with desktop objects in Qualitia. Here are some solutions for common problems:

• Issue: File Locked and conflict situation.

Solution:

• Issue: Object Repository objects are not visible in Qualitia.

Solution: Make sure you have mapped your project with the correct tsr file containing your Object Repository objects. If you have made changes in the repository, remember to synchronize the repository with Qualitia.

• Issue: Test execution fails because the object is not found during runtime.

Solution: Double-check the properties and values of the object. Make sure the application's UI has not changed. If it has, update the object properties in UFT's object repository and synchronize the changes with Qualitia.

• Issue: Unable to import a DP object from a tsr file.

Solution: Ensure that the tsr file is not open in UFT or any other application during the import process.

• Issue: Unable to delete a DP object.

Solution: Check if the object is used in any test cases. An object that is used in a task or test case cannot be deleted. Also, ensure you have the necessary permissions to delete the object.

Remember, to get the most accurate results, always keep your object repository updated and synchronize the changes with Qualitia Automation Studio. Happy testing! 

📞📚 Here to Help: Support and Resources

Need a helping hand? Don't hesitate to reach out to your Qualitia Relationship Manager. For more resources, our official Qualitia documentation and community website are just a click away!