Object Spy for Internet Explorer

Object Spy supports CRUD operations to manage objects.

Prerequisites

• Ensure you have Full control rights to the folder and subfolders where Object Spy is getting installed.
• Ensure that the Active scripting option is set to Enable under Security Settings section. To do so, under Internet Options > Security > Custom Level.  
  By default, this option is set to Disable in the high security zone.
  

• Ensure that Enable third-party browser extensions* is enabled from the Advanced section of Internet Options.  

 View Image

Object and their Attributes

Objects

Object Attributes

• Name
• ID
• Class

• Name: Sign in
• Color: Blue

Selection of Attributes

Static and Dynamic Objects

Static Objects

Dynamic Objects

Locator Priority Settings

Locator Types

• Link
• Name
• ID
• XPath
• CSS

1. On Object Spy toolbar, click the Settings icon.
   The Locator Priority Settings window appears.
   1. Click Up/Down buttons to changes the priorities of the locator type.
   2. Click Restore Default to restore the default priorities.
   3. Click Cancel to discard changes.
   4. Click Ok to apply the changes.

Object Learning Algorithm

When Object Spy overrides the preferred locator type even if the object has Name or ID Attributes

Objects under Frame

Object Identification Failure

• Object does not exist

• Object exists but tool failed to identify

Selecting Capture Mode and API

Capture Mode

• Left Click: In this mode, you can add objects to the repository using the left click of the mouse.
• Mouse Hover: Using this mode, you can add objects in the repository just by hovering mouse pointers over objects.

1. Launch Object Spy.
2. Go to Settings > Inspection.
3. In Capture mode, select the required option.
4. Click OK

Capture APIs

• Browser Mode: In this mode, Qualitia identifies objects using JavaScript events or native events.
• Accessibility: Selecting this mode, you can utilize Microsoft Active Accessibility API to identify objects from application under test more reliably.

1. Launch Object Spy.
2. Go to Settings > Inspection.
3. In Capture API, select the required option.
4. Click OK.

Launching Object Spy

1. Open the Qualitia Automation Studio client.

2. From the Expand Menu, click Develop.

3. Click the Objects tab.

4. Click the Spy button. as shown in the following figure:

1. You are prompted with the following confirmation message:

1. Click Yes if you have administrative privileges. You will not be able to continue with the installation if you do not have administrative privileges.
   The following Windows confirmation message appears:

1. Click Yes.
2. Internet Explorer opens, and you will see Object Spy at the bottom as shown in the following figure:
   

• Right-click the Test case or Task screen, and select from the context-menu Object Spy.
  
  

Object Spy User Interface

1. Object Spy tab
2. Tree view
3. Grid view
4. HTML tab
5. Button to change Object Inspection Mode

1. Object Name
2. Object Description
3. Object Class
4. Locator Type
5. Locator Value
6. SmartLocator

1. Highlight
2. Clear Highlight
3. Save
4. Delete
5. Reset
6. Search
7. Settings

Adding Objects Using Different Modes

1. From the Objects screen, click Spy.
   The Object Spy window appears.
2. Navigate to the page from where you want to add objects.
3. Ensure that Select Object option is disabled. 
   
4. Point to an object that needs to be added.
   The object is highlighted with a blue border.
5. Right-click the object and select Add Object from the context-menu.
   A confirmation message appears after the object is added.
   An object is added to the repository using the precedence set in Locator Priority Settings.

Left-Click Mode

1. From the Objects screen, click Spy.
   The Object Spy window appears.
2. From the Settings > Inspection. 
3. Select Capture Mode as Left-Click and click OK.
   
   
4. Navigate to the page from where you want to add objects.
5. Ensure that Select Object option is enabled.
   
6. Left-click the object which you want to add into the repository.
   A confirmation message appears after the object is added.

Mouse Hover

1. From the Objects screen, click Spy.
   The Object Spy window appears.
2. From the Settings > Inspection. 
3. Select Capture Mode as Mouse Hover and click OK.
   
   
4. Navigate to the page from where you want to add objects.
5. Ensure that the Select Object option is enabled.
   
6. Hover the mouse pointer over the object which you want to add into the repository.
   A confirmation message appears after the object is added.

Selecting Object Attribute On-The-Fly

1. From the Objects screen, click Spy.
   The Object Spy window appears.
2. Navigate to the page from where you want to add objects.
3. Right-click the object and select Add Object By from the context-menu.

4. Select the object attribute using which you want to add object into the repository.
   A confirmation message appears after the object is added.
   

   When adding new object in the repository, if object already exists, Qualitia notifies displaying the object name that is used while adding this object into the repository.

Adding Objects from HTML Code View

Adding Objects from Modal Dialogs

1. Launch Object Spy.
2. Go to Settings > Inspection.
3. Select the Allow Modal Inspection option.
4. Click OK.
   Now you can add objects from modal dialogs and use them while creating new tasks and test cases.
   
   

Searching Object

• Search by Object Name
• Advanced Search

Search by Object Name

1. On the Object Spy window, enter the object name you want to search.
2. Click Search.
   When you select objects from the search results, immediate parent will be highlighted for easy identification.
   

Advanced Search

1. On the Object Spy toolbar, click the Search icon.
   The Object Search window appears.
2. Select the appropriate filter (Name, Object Class, Locator Type, or Locator Value) to search an object.
3. Click Search.

Editing Object Details

• Press F2 key or double-click the cell.
• Use arrow keys to traverse from one field to another.
• Use the Enter key to save the data.

Resetting Objects

• On the Object Spy toolbar, click Reset.
  This will discard any unsaved changes.

Deleting Objects

1. On the Object Spy grid-view, select the check box(s) corresponding to the objects that you want to remove.
   Select the check box at the top of the column to select all the objects.
2. On the Object Spy toolbar, click Delete.

Highlighting Objects

Highlight

1. Navigate to a page from which objects are added earlier.
2. Select an object from the Object Spy toolbar.
3. To select all objects, select the check box at the top of the column.
4. Click Highlight.
   The selected objects get highlighted on the current page with the object name that is used to store in Qualitia.
5. On the Object Spy toolbar, click Clear Highlight to clear the highlighted object from the current page.

Google Chrome Object Spy

Adding Extension to the Google Chrome Browser

1. Download the ChromeExtension folder from the S3 location to your computer and open it.
2. Extract the QualitiaChromeExtension-8.3.0 zip file in a local folder on your computer.
3. Launch Google Chrome browser and navigate to chrome://extensions/
4. Enable Developer mode.
5. Click Load unpacked.
6. Select the folder where you extracted the QualitiaChromeExtension-8.3.0 zip file and click OK.
7. To launch the Qualitia Object Spy, Press F12 to open Developer options and select Qualitia Object Spy.
8. To start using Qualitia Object Spy, navigate to the Developer options (F12) and select Qualitia Object Spy.
   
   

1. Enter the Qualitia Server URL, Qualitia User Id, and then click

Launching Object Spy from the Browser

You can launch the object spy from the browser type on which you have added the object spy as an extension.

To launch the Object Spy from the Browser:

1. Do one of the following:

   1. To launch the Chrome Object Spy, open the Chrome browser.

   2. To launch the Edge object spy, open the Edge browser.

2. Press F12 to open Developer options and select Qualitia Object Spy.The Qualitia Object Spy login page opens.

3. Enter the Qualitia Server URL.

4. Enter the same user id that you use to login to Qualitia Automation Studio (QAS) client ,in User Id.

5. Click Continue.

6. Select the associated project on which you want to add and manage objects.

Adding New Objects using Google Chrome Extension

1. Launch Google Chrome browser and navigate to the application URL.
2. Open Developer tools (press F12 or right-click and select Inspect from the context-menu).
3. In Developer tools, select Object Spy.
4. Enter Server URL and Qualitia User ID.
   The Server URL is a combination of the hostname and port 8887 where you have installed Qualitia server. 
   For example, http://192.112.33.123:8887 or http://localhost:8887 (if server is installed on a local machine).
   By default, Qualitia uses port 8887. You may change it while installing /wiki/spaces/QASWM7/pages/1169433190 component.
   
   
   
   
5. Click Continue.
   The list of projects appears which are accessible to that user.
6. Select the project under which you want to add new objects and click Continue.
   
   
   
   
7. To add new objects in the repository, turn the Select Mode on.
   
   
8. Hover the mouse pointer over the object and click it once the object details are highlighted.
   You will see the object added into the list in the Object Spy window.

9. Once you add all the required objects, click Save to Repository.
   
   
   
   This will add objects into the repository and the object is now ready for use in the automation studio.

10. To add the objects for a child window, do one of the following:
    1. Open the child window, and open its associated Object Spy to add the child window objects to a new child window object repository.
    2. Open the child window, and click the Select Mode button of the Object Spy associated with the parent window to add the child window objects to the parent window object repository. You can switch between parent and child windows to add their objects using the Select Mode button.  

       It is recommended to use Qualitia Object Spy on Google Chrome in left dock mode or right dock mode. If you want to use it in any other dock mode, re-enable the Select Mode button to start using it.

       You can also detach Object Spy UI with the application under test page and also add the child window objects as shown in the above-mentioned step. However, if you are adding objects for multiple application pages in the detach mode, the Chrome Object Spy adds the objects of all the pages in the same object repository.

Locator Priority Settings for Chrome Object Spy

• Link

• Name

• ID

• XPath

• CSS

• SFDC:Label

• Link

• Name

• ID

• XPath

• CSS

Updating Object Details

1. On the Google Chrome browser, launch Qualitia Object Spy and connect to the desired Qualitia server and project. 

    Click here for more information

   • Enter Qualitia Server URL and Qualitia username and click Continue.
     The Qualitia Server URL is a combination of the hostname and port 8887 where you have installed Qualitia server. 
     For example, http://192.112.33.123:8887 or http://localhost:8887 (if server is installed on a local machine).
     By default, Qualitia uses port 8887. You may change it while installing Qualitia Server component.
   • Select the desired project from which you want to edit the objects and click Continue.

2. In the Repository section, select the page under which the object exists which needs to be updated.

3. Click the edit () icon next to the object which you want to edit.

   Any type of manual intervention like HTML tag/structure change, objects parameterization, and so forth will not work for the SmartLocator mode.

   
   
   
   

4. Modify object details and then click .
   
   

Highlighting the Objects

Qualitia Web Object Spy lets you highlight the added objects when you navigate to the associated application under test page. This helps you to understand which objects are added into the repository and which objects are not added yet.

To highlight the objects:

1. Launch the browser (Edge or Chrome) that is enabled with Web Object Spy.
   For detailed instructions on how to launch a web object spy, refer to Adding Web Application Objects.
2. In the Repository section, select the page from which you want to highlight the object.
3. Do one of the following:

   1. To highlight all objects on the page, click the highlight () icon at the page level.

   2. To highlight a specific object, click the object name you want.
      The application page highlights the objects.
      
      

      Objects existing in the repository are highlighted with the green border (as shown in the screenshot above). Objects that do not exist in the repository yet are highlighted with the red border. 

Remove Objects from Repository

1. On the Google Chrome browser, launch Qualitia Object Spy and connect to the desired Qualitia server and project.

    Click here for more information

   Page lookup error: page "(8.3.0 2) Updating Object Details" not found.

   If you're experiencing issues please see our Troubleshooting Guide.

2. In the Repository section, select the page from which you want to remove the object.
3. Click the remove () icon next to the object which you want to remove.
   
   

Filter Object List

1. On the Google Chrome browser, launch Qualitia Object Spy and connect to the desired Qualitia server and project.

    Click here for more information

   Page lookup error: page "(8.3.0 2) Updating Object Details" not found.

   If you're experiencing issues please see our Troubleshooting Guide.

2. In the Repository section, use the filter () option to filter objects.
   1. To filter objects by Web Page, select the desired page from the drop-down list.
   2. To filter objects by Object Class, select the desired object class from the drop-down list.
      

Object Spy Limitations/Known Issues

Limitations of SmartLocator Feature:

• For the test cases getting executed through Qualitia Bot (erstwhile Offline package), the corrected locator value by SmartLocator will not be updated in the object repository.
• SmartLocator feature does not support any wait-related Qualitia actions like WaitForExistence, WaitForVisibility, WaitForClickability, WaitForAttributeContains, and so forth.

Limitations for Qualitia Object Spy for Google Chrome

• Identifying SVG elements is not supported while adding objects from Object Spy for Google Chrome.
• If the network connection failure occurs on Qualitia Server, Qualitia Web Service needs to get restarted. 
• The object inside frames cannot be highlighted while working with Qualitia Object Spy for Google Chrome.

Object Spy for Mobile Applications

Installing the Mobile Components