Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

Amid rapid digital transformation, Qualitia Automation Studio’s Studio (QAS) “Desktop Objects” feature offers a robust solution for efficient test automation. 🔧for Desktop supports creation of 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 artifacts, like test case creation and test suite execution, remains the same across desktop, web, and mobile applications.

💻 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 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

...

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.

...

Objects

...

In QAS, Desktop Objects include attributes such as class, properties, and property values. You will 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 the below sections 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 the below section for detailed instructions.

Remember, UFT objects in Qualitia Studio can not be modified directly. Modify the existing UFT objects or add new ones in the repository and synchronize the changes in Qualitia Automation Studio.

Supported Technologies

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

Technology

.Net SilverLight

.Net WebForms

.Net Windows Forms

.Net WPF

ActiveX

Delphi

Flex

Generic

Mobile

Oracle

PeopleSoft

PowerBuilder

SAP Web

SAPNWBC

SAPWDJ

SAPWebTxt

SAPUI5

Seibel

Stringray

Supplemental

Swing

Terminal Emulators

UI Automation

Visual Basic

VisualAge Smalltalk

Web2.0 and Web

Win

Windows Runtime

View Test Cases Associated with an Object

To view the test cases associated with an object:

...

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. Click Objects tab icon from the right side of the screen.

  4. From tree view, right-click the object and select View Test Cases.

    1. You can view a list of test cases associated with the chosen object.

Working with DP Objects

Add a DP Object

Follow these steps to add a DP object:

...

Access Develop from left navigation.

...

Click Objects tab icon from the right side of the screen.

...

Click DP object tree node in the left pane.

...

Click New button in the right pane to open the New dialog box.

...

Follow these steps in the order provided:

  1. Select a parent object.

  2. Enter Object Name and Description.

  3. Select Technology and Object Class.

...

Click Add.

...

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

...

Click OK.

Info

Note: If you don't define any object property with its value, the object will be highlighted in red and termed as an empty object.

Edit a DP Object

Follow these steps to edit a DP object:

  1. Login to you QAS Client.

  2. Access Develop from left navigation.

  3. Click Objects tab icon from the right side of the screen.

  4. Click the DP object tree node in the left pane.

  5. In the right pane, select Edit.

  6. Make necessary changes and click OK.

Delete DP Objects

Note

Before deleting any DP object, be aware of the following:

  1. Objects used in a task or test case cannot be deleted.

  2. Deleting a parent object will also delete its child objects.

  3. A parent object cannot be deleted if one of its child objects is used in a task or a test case.

  4. Two child objects under different parent objects cannot be deleted simultaneously.

Follow these steps to delete DP objects:

  1. Login to your In far right of the toolkit, click Objects icon.

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

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

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

  4. A new popup appears, where you can:

    1. Enter TSR Name.

    2. Locate the TSR Select TSR Path file.

  5. Click Import Objects.

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

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

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

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

  10. Repeat these steps to update another TSR file.

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

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

  13. Once completed, click Save. Otherwise, click Discard.

Note

Remember, UFT objects in Qualitia Studio cannot be modified directly. Modify the existing UFT objects or add new ones in the repository to automatically synchronize with QAS.

Info

Upload multiple TSR files to reduce the size of a single TSR file. This can vastly improve your test execution or object management or reduce the sync time.

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.

Note

Ensure to select the TSR from Project folder of QAS. Selecting the file from any other sources will not update the Object Repository.

Edit an uploaded TSR file

  1. Login to QAS - Client.

  2. Access Develop from left navigation .

  3. Click Objects tab icon from the right side of the screen.

  4. Click the DP object tree node in the left panel.

  5. In the right panel, select the child object you want to delete.

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

  7. Click Remove.

Import DP Objects from a tsr or bdb 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 your of your Qualitia Automation Studio -Client to view Test Explorer screen.

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

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

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

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

  6. Click Edit.

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

  8. 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. Click Objects tab icon from the right side of the screen.

  4. Click DP object tree node in the left pane.

  5. Click Import.

  6. Locate tsr or bdb file that you want to import

  7. Click OK.

Working with Object Repository (OR) Objects

Map a tsr file with a Qualitia Project

Follow these steps to map a tsr file with a Qualitia project:

  1. Login to your QAS - Client.

  2. Access Develop from left navigation.

  3. Click Objects tab icon from the right side of the screen.

  4. Click Edit for the project you want to map with a repository.

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

  6. Click Save.

Replace the Mapped tsr File

To replace a mapped tsr file for a project:

  1. Login to your 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.

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

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

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

  5. Click Delete.

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

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

Info

A Red Dot on the Refresh icon indicates one or more new objects are added to or updated in the repository. Click the Refresh icon to update newly captured objects.

If by any chance the Auto synchronization did not work, hover on the TSR file and click Sync icon to explicitly trigger a sync. If you intend to sync all the TSR files, click the Sync icon next to the TSR node.

Note

If a user is editing the TSR file through Qualitia then it will be locked for another user. It will show a pop-up message TSR is locked by admin user on QSPL machine.

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. Click Objects tab icon from the right side of the screen.

  4. Click Edit for the project you want to map with a repository.

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

  6. Choose one of the following options:

    1. Preview: View new set of objects in a CSV format report. You can view all new, modified, and deleted objects compared to current Object Repository objects. After viewing, click Proceed or Abort.

    2. Proceed: Map the new tsr file.

    3. Abort: Cancel mapping process.

Synchronize Object Repository Objects with the Test Shared Repository

To synchronize Object Repository objects with the test shared repository:

  1. Login to your 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.

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

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

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

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

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

Info

If you do not define any object property with its value, the object gets highlighted in red and termed as an empty object.

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. Click Objects tab icon from the right side of the screen.

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

  5. Choose one of the following options:

    1. Preview: View new set of objects as a CSV format report. You can view all new, modified, and deleted objects compared to current Object Repository objects. After viewing, click Proceed or Abort.

    2. Proceed: To sync the objects.

    3. Abort: To cancel the synchronization process.

View Test Cases Associated with an Object Repository Object

  1. Login to your 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.

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

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

  4. Double click the object you want to edit.

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

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

  7. Make necessary changes.

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

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

Note

Before deleting any DP object, be aware of the following:

  1. Objects used in a task or test case cannot be deleted.

  2. Parent object cannot be deleted unless its child objects are deleted.

  3. A parent object cannot be deleted if one of its child objects is used in a task or a test case.

  4. Two child objects under different parent objects cannot be deleted simultaneously.

Follow these steps to delete DP objects:

  1. Login to QAS - Client.

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

  3. Click Objects tab icon from the right side of the screenIn 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 tree view, right-bottom screen, click Descriptive Programming node.

  6. Double click the OR object and select View Test Cases.

  7. The system will then display a list of test cases associated with the chosen OR object.

💡 Golden Nuggets: Best Practices for Desktop Object Management

...

  1. object you want to edit.

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

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

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

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

🔧 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: Another user will have to release a lock to get the file release from lock and for conflict situation user can reload the project through settings tab.

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

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

...

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

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

...

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!