Add Desktop Objects

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 Mirco-focus 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.

Desktop Objects

In QAS, Desktop Objects include attributes such as class, properties, and property values. You can 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

This section covers Importing Objects from a TSR or BDB file, Modifying Objects imported from a TSR file, editing an uploaded TSR file, and deleting an uploaded TSR file.

Import Objects from a TSR or BDB file

After importing DP objects, QAS only adds the new DP object 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.

To import objects from a TSR or a BDB file:

1. Login to QAS - Client.

2. Access Develop from left navigation to view Test Explorer screen.

3. In far right of the toolkit, click Objects icon.

   1. You can view Object Repository with existing objects in a Desktop Project, sorted alphabetically.

4. When you are landing on this page for the first time, you can view the option to Import Objects.

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

6. A new popup appears, where you can:

   1. Enter TSR Name.

   2. Locate the TSR Select TSR Path file.

7. Click Import Objects.

8. You can see a Progress Indicator followed by the TSR being listed in the Object Repository.

9. 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.

10. Once loaded, all the TSR objects are listed in Object Repository.

11. Click the Expand option before the TSR name to view the Objects.

12. Repeat these steps to update another TSR file.

13. To reorder the execution of multiple TSR files, select the TSR you want to change order.

14. Click the Reorder icon. You can a view a popup window that allows you to drag and drop to reorder.

15. Once completed, click Save. Otherwise, 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 are 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 QAS - Client.

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

3. In far right of the toolkit, click the Objects icon.

   1. You can view Object Repository with existing objects in a Desktop Project, sorted alphabetically.

4. When you are landing on this page for the first time, you can see an option to Import Objects.

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

6. You can view an Edit (pencil) icon.

7. Click Edit.

8. You can view new popup window where you can update TSR Name.

9. Click Save to update. Otherwise, click Discard.

Delete an uploaded TSR file.

1. Login to QAS - Client.

2. Access Develop from left navigation to view Test Explorer screen.

3. In far right of the toolkit, click the Objects icon.

   1. You can view Object Repository with existing objects in a Desktop Project, sorted alphabetically.

4. When you are landing on this page for the first time, you can see an option to Import Objects.

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

6. You can see a Delete (Bin) icon.

7. Click Delete.

8. You can view a new popup window to confirm the delete action.

9. Click Delete to proceed. Otherwise, click Discard.

Descriptive Programming (DP) Objects

Add a DP Object

Follow these steps to add a DP object:

1. Login to QAS - Client.

2. Access Develop from left navigation to view Test Explorer screen.

3. In far right of the toolkit, click the Objects icon.

   1. You can view Object Repository showing existing objects in a Desktop Project, sorted alphabetically.

4. If you are landing on this page for the first time, you can see the option to Import Objects.

5. In the bottom section, click the Descriptive Programming node.

6. Here, you are presented with two options:

   1. Import from a TSR or BDB file.

      1. Click Import Objects.

         1. A popup window open.

      2. From the Import Path field, locate the TSR or BDB file.

      3. Once done, click Get Objects to proceed. Otherwise, click Discard.

         1. You can also see a Progress Indicator.

      4. A Spinner icon next to Descriptive Programming node indicates that Upload is currently in progress. You can click the X button next to spinner icon to cancel the upload.

      5. Once loaded, all TSR objects are listed in Object Repository > Descriptive Programming node.

      6. Click the Expand option before the TSR name to view its Objects.

   2. Create Object Manually

      1. Click Create Object button.

      2. You can view a form to:

         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. Otherwise, click Discard.

7. You can view all existing objects under the Descriptive Programming Node.

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

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

   2. Child object: 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 as shown above.

Edit a DP Object

Follow these steps to edit a DP object:

1. Login to QAS - Client.

2. Access Develop from left navigation to view Test Explorer screen.

3. In far right of the toolkit, click the Objects icon.

   1. You can view the Object Repository with existing objects in a Desktop Project, sorted alphabetically.

4. If you are landing on this screen for the first time, you can see the option to Import Objects.

5. In the bottom section, click Descriptive Programming node.

6. Double click the object you want to edit

7. Doble clicking an object opens the Object Details view.

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

9. Make necessary changes.

10. Click Save to update; otherwise, click Discard.

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

    1. To create a parent object, click 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 QAS - Client.

2. Access Develop from left navigation to view Test Explorer screen.

3. In far right of the toolkit, click Objects icon.

   1. You can view Object Repository with existing objects in a Desktop Project, sorted alphabetically.

4. If you are landing on this page for the first time, you are presented the option to Import Objects.

5. From the bottom screen, click Descriptive Programming node.

6. Double click the object you want to edit.

7. By double clicking the object, you can view the Object Details.

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

9. Press Ctrl (in Windows) and click all objects you want to delete.

10. You are then prompted to confirm the delete action.

11. Click Delete to proceed. Otherwise, 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:

Need to update known issue based on ticket Qdev-49618

• 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.

📞📚 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!