Add web Application Objects
Choosing between Image Objects and Mouse Hover can largely depend on the specific context and requirements of the application under test. Here are a few use cases that might help clarify when to choose one over the other:
...
In conclusion, your choice between Image Objects and Mouse Hover depends on the specifics of the application you're testing. For comprehensive testing, you would ideally want to use a mix of both, depending on the context, to ensure all aspects of the application are thoroughly tested.
A vital note about Qualitia Smart Locator:
Smart Locator has the capacity to automatically identify dynamic objects during the execution of a test case. If this option is enabled, you won't be able to edit object details such as the locator value and locator type.
If you choose to disable this option, the object will no longer be identified by Smart Locator. If you wish to re-enable this option for this object at a later stage, you'll need to either learn this object anew using Qualitia Object Spy or specify a valid XPath for the object. The object will be re-enabled for Smart Locator identification only after its first execution.
If you see a Light Bulb icon next to an Object, it indicates that the Smart Locator is used to identify the Object.
You have the capability to include an object from a web application currently under test with just a single click. You can then choose the type of locator that best suits your needs. Qualitia additionally offers you the flexibility to include objects in the form of an image object.
Below is the standard sequence for incorporating objects for a typical web Web application:
Link
Name
ID
XPath
CSS
For SFDC (Salesforce) applications, the standard sequence differs slightly and is as follows:
...
When dealing with image objects, the locator type defaults to Image. You have the autonomy to modify this locator type sequence in alignment with your specific needs.Prerequisites: .
The last locator precedence will be stored and when you login for the next time, the same locator precedence will be defaulted.
📚Prerequisites
Before moving forward, please confirm that
...
Your computer has connectivity to the Qualitia Server.
In the scenario of adding objects from a Salesforce application, it's crucial to ensure you've selected a Salesforce project. Salesforce applications are best viewed/added via the Chrome Object Spy ObjectSpy as Salesforce applications are not fully supported on Edge.
Adding Objects
Add Web Application Objects (excluding image objects)
The inclusion of web application objects (excluding image objects) involves the following steps:
Login to QAS - Client <insert Screenshot>
Access Develop from left navigation of your QAS - Client to view Test Explorer screen.
Initiate either the Edge or Chrome Object Spy ObjectSpy. For an in-depth guide on launching a web object spyObjectSpy, please refer to Launching Object Spy from the BrowserObjectSpy.
Input the URL of the application you're testing into the address bar.Ensure you are in Learn Objects Tab. <insert Screenshot>
Enable Hover mode, as shown in the screenshot. <Screenshot>
Position your mouse pointer over the object and once the object details are highlighted, click on it.
This action will result in the object being added to the list in the Object Spy ObjectSpy window.
After including all the necessary objects, click Save to Repository.
If you need to incorporate objects for a child window, you can follow one of these methods:
Launch the child window and open its corresponding Object Spy to include the child window objects into a new child window object repository.
Open the child window and click the Hover button of the Object Spy associated with the parent window. This will add the child window objects to the parent window object repository. You can switch between the parent and child windows to include their objects using the Hover buttonIf you prefer to edit or delete any of the existing objects in the session, hover on the added Object in ObjectSpy window.
You will see three options:
Edit
Highlight
Delete
Click the Edit (Pencil) icon adjacent to the object you intend to modify.
You can edit
Name: Name of the Object
Class: Class of the Object
Locator Type
Locator Value
If you prefer to change the object with another object, click Update Object icon.
The section will change to light orange color to give the feedback that the Update Object mode is on.
Click the new Object you wanted to replace; the object will be updated.
After making the necessary changes to the object details, click Save.
Once all the changes are made, click Save To Repository to update the changes.
At the bottom of the screen, you can see the number of objects from this page added to the repository.
Add Image Objects
When it comes to integrating image objects, the process is as follows:
...
Initiate Chrome Object Spy.
Login to QAS - Client. <insert Screenshot>
Access Develop from left navigation of your QAS - Client to view Test Explorer screen.
Click Objects icon from extreme right of the toolkit.
You will see Object Repository.
All the objects will be listed.
Initiate ObjectSpy. For comprehensive guidelines on how to launch a web object spy, please refer to Launching Object Spy from the Browser..
Ensure you are in Learn Objects Tab. <insert Screenshot>
Input the URL of the application you're testing into the address bar.
Activate Image mode, as illustrated in the screenshot. <include screenshot>
Choose the image you wish to include using the drag and drop method and set the position of the pointer by clicking on the image.
The image object will then be added to the list in the ObjectSpy window.
Hover on the object that you want to edit.
You will see three options
Edit
Highlight
Delete
Click the Edit (Pencil) icon adjacent to the Object Spy windowobject you intend to modify.
You can edit
Name: Name of the Object
Class: Class of the Object
Locator Type
Locator Value
if you prefer to change the object with another object, click Update Object icon.
The section will change to light orange color to give the feedback that the Update Object mode is on.
Click the new Object you wanted to replace; the object will be updated.
After making the necessary changes to the object details, click Save.
After incorporating all the necessary objects, click Save to Repository.
Your objects will be stored in the repository, as shown in the relevant screenshot.
It is suggested that you use the Web Object Spy in either left dock mode or right dock mode. However, if you prefer using it in a different dock mode, you can simply click the Hover/Image button to commence usage.
Additionally, you have the ability to separate the Object Spy UI from the application under test page, and also include the objects of child windows, as explained in the previous step. It's important to note though, if you're including objects for multiple application pages in detached mode, the Web Object Spy will incorporate the objects of all the pages into the same object repository.
View Repository
<TBD>
Filter Objects List
<TBD>
Editing Objects
The Object Spy feature 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:
...
Initiate the browser (Edge or Chrome) that has the Web Object Spy enabled.
...
Duplicate objects are not allowed.
| Note |
|---|
The object will be locked for any edits if any user or you for that matter is trying to edit the Object in Object Repository and trying to edit it using the Object Spy. |
Highlight Objects
Login to QAS - Client <insert Screenshot>
Access Develop from left navigation of your QAS - Client to view Test Explorer screen.
Initiate either the Edge or Chrome ObjectSpy. For an in-depth guide on launching a web object spy, please refer to Launching Object Spy from the Browser.
Within the Repository section, locate and select the page under which the object that requires updating resides.
Click the Edit icon adjacent to the object you intend to modify. For more detailed instructions on how to modify an object learned via the Hover mode, refer to 'Editing an Object'. Note: Keep in mind that SmartLocator mode does not support changes to the HTML tag/structure.
After making the necessary changes to the object details, click Save.
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:
Launch the Chrome / Edge browser that is enabled with Web Object Spy.
For detailed instructions on how to launch a web object spy, refer to Launching Object Spy from the Browser.
In the Repository section, select the page under which the object exists that needs to be updated.
Click the edit icon next to the object that you want to modify. For comprehensive instructions on how to edit an object learnt by the Image mode, refer to Editing an Image Object. Note: Please note that SmartLocator mode doesn't support the Image mode.
Amend the object details as needed, and then click Save. Remember, you cannot modify the locator type of the image object.
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.
A vital note about Qualitia SmartLocator:
SmartLocator has the capacity to automatically identify dynamic objects during the execution of a test case. If this option is enabled, you won't be able to edit object details such as the locator value and locator type.
If you choose to disable this option, the object will no longer be identified by SmartLocator. If you wish to re-enable this option for this object at a later stage, you'll need to either learn this object anew using Qualitia Object Spy or specify a valid XPath for the object. The object will be re-enabled for SmartLocator identification only after its first execution.
Deleting Objects
TBD
Highlighting Objects
TBD
Challenges in Object Identification and Remedies
...
Ensure you are in Learn Objects Tab. <insert Screenshot>
Hover on the object that you want to edit.
You will see three options
Edit
Highlight
Delete
Click Highlight icon.
The object that was used will be highlighted in the browser window.
💡Golden Nuggets: Best Practices for Object Management
Please note that the screen resolution where optimum UX for Object Spy will work would be 884px x 675px.
📞📚 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!