Document toolboxDocument toolbox

Header

OV_Manage Objects

Qualitia Automation Studio (QAS) enables you to easily manage Objects. You can view objects, edit existing Objects and remove unwanted or redundant ones.

📚Prerequisites:

  • User must have access to QAS - Client.

  • User must have “Manage Objects “privileges to access Object toolkit.

Edit an Object

Sometimes, an object's name or properties might change, or you might want to rearrange your object hierarchy.

View Object

To view Object Repository via Object Spy

  1. Login to QAS - Client.

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

  3. Click Objects icon from extreme right of the toolkit to view the Object Repository.

    1. All the objects are listed in the Object Repository.

  4. Launch Object Spy. By default, you will land in Learn Objects Tab.

    1. For a comprehensive guide to launch a web object spy, refer to Launching ObjectSpy.

  5. Click the Repository tab.

  6. Under Project, you can view all the Pages from which the Objects are captured.

  7. If you see a Red Dot on the Refresh icon, it indicates that a new object has been added to repository or updated by another user.

  8. Click the Refresh icon to update newly captured objects.

  9. If you see a Light Bulb icon next to an Object, it indicates that the Smart Locator is used to identify the Object.

To view Objects via Object Repository

  1. Login to QAS - Client.

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

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

    1. You can view the Object Repository, where all the objects will be listed.

  4. Click Refresh icon to update newly captured objects.

  5. Use the Seach bar to search for Objects based on keywords.

    1. Use Expand All option to expand all the parent objects.

    2. Use Collapse All to hide the child Objects.

  6. Double Click on the desired Object to view its details (referred to as Object Details.)

The number next to Smart Object indicates the number of test cases in which the given object is used. No number indicates, the given Object is not used in any test case.

When you hover over the info icon on the Object Details screen, you'll see the object creator in the Updated By field and the date of the update in the Updated On field.

View Test Cases Before Modifying Objects from Object Repository

Before updating an object, check which test cases might get affected to understand the impact of your changes.

  1. Login to QAS - Client.

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

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

    1. You can view the Object Repository where all objects are listed.

  4. Double Click on any Object to view its details.

  5. Click the Number next to Smart Object.

    1. A new popup window will appear and list all the Test Cases that uses this Object. It's the popup of list and user can only copy paste the Test Case name.

Filter Objects in Object Spy

  1. Login to QAS - Client.

  2. Access Develop from to view Test Explorer screen.

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

    1. You can view the Object Repository, where all objects are listed.

  4. Launch or start Object Spy.

    1. For a comprehensive guide to launch a web object spy, refer to Launching ObjectSpy.

    2. By default, you land in the Learn Objects Tab.

  5. Click the Repository tab.

    1. Under Project, you can view all the Pages from which the Objects are captured.

  6. Click the Expand icon to view the Objects under each page.

  7. Using the Filter option, you can narrow down your search.

    1. Select the Web Page dropdown from which you want to filter Objects.

    2. From the Object Class, select the WebElement you want to Filter.

  8. Once the Filters are applied, you can view the objects that match the given criteria.

  9. To clear the filters, simply click x button next to each of the filter option.

Create Object

Create Object via Object Spy

  1. Login to QAS - Client.

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

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

  4. When no Object exist, you are prompted to Create Object in the Object Repository screen.

  5. You can also click + Create Object from the top right corner of the Object Repository screen.

  6. Clicking Create Object will open a Create Object window with the following fields:

    1. Name: Enter an intuitive name for the object that is easy to recognize.

    2. Technology: Select Web or Mobile from the dropdown menu.

    3. Class: Select class of the Object from the dropdown menu.

    4. Parent: Select parent object if any.

    5. Description: A brief description about the object.

    6. Locator Type: Select the locator type from the dropdown menu.

    7. Locator Value: Enter the value.

  7. Once completed, click Save to proceed. Otherwise, click Discard.

Edit Object

Edit Objects from Object Repository via Object Spy

The Object Spy allows you to update object details, including their locator type and associated locator value.

To modify an object learned through the Hover mode, follow these steps:

  1. Login to QAS - Client.

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

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

    1. You can view the Object Repository, where all objects are listed.

  4. Launch the Object Spy.

    1. For a comprehensive guide on how to launch a web object spy, refer to Launching ObjectSpy.

  5. By default, you land in the Learn Objects Tab.

    1. Under Projects, you can view all Pages from which the Objects are captured.

  6. Click the Expand button before each web page to view the Objects under a page.

  7. Within the Repository section, locate and select the page under which an object needs to be updated.

  8. Hover over the object you want to update.

  9. You will see three options:

    1. Edit

    2. Highlight

    3. Delete

  10. Click the Edit (Pencil) icon next to the object you intend to update.

  11. You can edit the following:

    1. The Name of the Object.

    2. The Class of the Object.

    3. The Locator Type.

    4. The Locator Value.

  12. To replace an object with another object, click the Update Object icon.

    1. The section changes to light orange color to indicate the Update Object mode is on.

    2. Click the new Object; the previous object gets replaced with the latest one.

  13. Double click the Page Name to Edit the name of the page.

  14. Once updated, click the Tick mark.

  15. Once updated, click Save.

  16. Once all the changes are made, click Save To Repository to update the changes.

Keep in mind that Smart Locator mode does not support changes to the Locator Value (HTML tag/structure) or Locator Type. If you intend to update them, uncheck the Smart Locator.

For a use case, consider a website where the properties of a web element, say a button, have been updated during a website revamp. You can use this process to update the details of the button in your test script.

To modify an object learned through the Image mode:

  1. Login to QAS - Client.

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

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

    1. You can view the Object Repository, where all objects are listed.

  4. Initiate Chrome Object Spy.

    1. For a comprehensive guide to launch a web object spy, refer to Launching ObjectSpy.

  5. Ensure you are in Learn Objects Tab.

  6. Within the Repository section, locate and select the page under which an object needs to be updated.

  7. Hover over the object you want to update.

  8. You will see four options:

    1. A camera icon, indicating an image object.

    2. Edit

    3. Highlight

    4. Delete

  9. Update the object details as needed. You can update the following:

    1. The Name of the Object.

    2. The Class of the Object.

    3. The Locator Type.

    4. The Locator Value.

  10. To replace the image object with another image, click the Update Object icon.

    1. The section appears light orange to indicate the Update Object mode is on.

    2. Click the new image to replace the existing one.

    3. The latest image object gets updated.

    4. Click Save to proceed; otherwise, click Reset.

  11. Once all changes are made, click Save To Repository to update the changes.

    1. As an example, if the source of an image object has been changed on the website, you might need to update the test script to reflect this change.

Edit Objects in Object Repository

  1. Login to QAS - Client.

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

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

    1. You can view Object Repository, where all objects are listed.

  4. Click the Refresh icon to update newly captured objects.

  5. Double click the Object you intend to update. You can view the Object Details screen.

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

  7. Make necessary updates.

  8. Click Save to save the changes; otherwise, click Discard.

    1. Upon clicking Save, you can view the Object Successfully Updated.

Remove Objects

Remove Objects from Object Repository

  1. Login to QAS - Client

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

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

    1. You can view Object Repository, where all objects will be listed.

  4. Click the Refresh icon to update newly captured objects.

  5. Double click the Object you intend to delete.

    1. You can view the Object Details screen.

  6. Click Delete (Bin) icon to delete. You are prompted to confirm the delete action.

  7. Click Delete to proceed; otherwise, click Discard if you accidentally clicked delete icon.

    1. The selected object is now deleted.

Remove Objects from Object Repository via Object Spy

The Object Spy allows you to delete object details, including their locator type and associated locator value.

To delete an object learned through the Hover mode:

  1. Login to QAS - Client.

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

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

    1. You can view the Object Repository, where all objects are listed.

  4. Within the Repository section, find and select the page under an object needs to be deleted.

  5. Initiate Chrome Object Spy.

    1. For a comprehensive guide to launch a web object spy, refer to Launching ObjectSpy.

  6. Ensure you are in the Learn Objects Tab.

  7. Hover on the object that you want to delete.

  8. You will see three options:

    1. Edit

    2. Highlight

    3. Delete

  9. Click the Delete (Bin) icon.

💡Golden Nuggets: Best Practices for Object Management


🔧 Got a problem? Let’s fix!

 

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

Footer