Getting Started with Object Spy

With the introduction of objects, their importance in test automation, challenges and remedies, let us now see how Qualitia Object Spy helps you to add and manage objects at different levels of projects.
For more information on Qualitia Object Spy, see "Qualitia Object Spy Feature Help"

Create an Object

The first and foremost thing that you will perform is creating a project.
To create a new project:
For more information about creating a project, please refer to "Qualitia for Web and Mobile User Manual".

Opening an Existing Project

You can open an existing project to add new objects or view the objects added earlier.
For more information about creating a project, please refer to "Qualitia for Web and Mobile User Manual".

Launching Object Spy

You need to launch Object Spy to add new objects or view the objects added earlier.
To launch Object Spy from Object screen:

• On Object screen, click Launch icon.

This will open Internet Explorer window along with Qualitia Object Spy plug-in.

Plug-in can be observed in the bottom screen of IE with functionalities like Object Spy tab and HTML source tab on left bottom. A Toolbar having Highlight, Highlight All, Clear Highlights, Save, Delete, Reset functionality is present on right bottom pane. If you do not see the plug-in embedded, please refer to "/wiki/spaces/DOC/pages/14015998".
To launch Object Spy from Test case and Task screen:

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

Note: You need to have Manage Object privilege to launch Object Spy.

Object Spy User Interface

Object Spy plug-in contains a Tab bar, Grid view and Object Spy toolbar.
Tab bar includes:

• Object Spy tab
• Tree view
• Grid view
• HTML tab
• Mouse Hover mode button
• Space for warning or error messages

Grid view includes:

• Object Name
• Object Description
• Object Class
• Locator Type
• Locator Value
• Delete

Object Spy toolbar includes:

• Highlight
• Highlight All
• Clear Highlight
• Save
• Delete
• Reset
• Search
• Settings

Adding Objects

Qualitia Object Spy allows you adding objects in an easy way and simultaneously building workflows in Qualitia using these objects. You can also add objects manually with its Locator Type and Locator Value.
To add new objects using the Mouse Hover mode:

1. Navigate to a page from which you want to add objects.
2. On the Object Spy tab, click Mouse Hover icon.
3. On the current page, point to an object that is to be added.

The pointed object is then highlighted with a blue border.

1. Right-click Add Object.

The selected object gets added in Object Spy grid view.
Note: While pointing to an object ensure you have pointed to an object with its appropriate Object Class.
To add objects manually:

1. Right-click on the current page of the object and select Add Object.
2. Right-click on Project (root) node and select Add Object.
3. On the Object Spy tree, select a page and right-click Add Object.
4. Once objects are added, you need to enter Locator Value and select Qualitia Object Class associated with the object.

Note: Objects that are added manually with CSS/DOM Locator Type values cannot be highlighted.

Saving Objects

You can save the added object so that it gets stored in the repository.
Saving objects in frame

• If an object is inside a frame or nested frames, then the tree view displays entire frame hierarchy.

The inspected object, parent frame and the corresponding page is saved.
To save the learned object

• On the Object Spy toolbar, click Save.

The object is then added to the repository.
Unsaved changes in grid
If there are any unsaved changes in Object Spy grid, you will be prompted to save those before navigating to:

• Any other page or frame node in the tree or
• A different URL

Editing Objects

You can edit the objects added earlier. Object Name, Object Description, Locator Type and Locator Value can be edited.
To edit an object

• Press F2 key or double-click the cell.

Note: Objects not used in Test cases or Tasks are allowed to be edited. If objects that are used in Test cases or Tasks are edited, then you will be prompted for confirmation before allowing any edit.

Searching Project

You can search the objects added earlier.
To search an object

1. On the Object Spy toolbar, click the Search icon.

The Object Search window is displayed.

1. Select the appropriate filter (Object Name, Object Class, Locator Type, and Locator Value) to search an object.
2. Click Search.

The search result displays a list of objects that match the search criteria with name, class, and description of objects.

Deleting Objects

You can delete the objects added earlier.
To delete an object:

1. On the Object Spy grid view, select Delete check box or multiple check boxes of required grid cell.
2. On the Object Spy toolbar, click Delete.

Notes:

• An object can only be deleted from the Object Spy, if it is not in use in the test case development.
• Delete operation is permanent and cannot be reverted.
• If you try to delete a page or frame object, you will be prompted to delete all child objects first and then delete the page object.

Adding Objects from HTML Code View

This option is recommended to learn WebList (<Select>) objects which could not be learnt from the application HTML. To do this, hover mouse on an object close to the WebList to be learnt, click on 'View HTML Source', this will highlight HTML for the hovered object.
Find the HTML for the WebList and then learn the WebList. This can certainly be done for other objects as well.

Resetting Objects

You can reset the objects added earlier.
To reset an object

• On the Object Spy toolbar, click Reset.

This will discard any unsaved changes.
Note: All manually added objects and inspected objects that are not saved will be discarded.