Object Identification Center (OIC) for Selenium

When writing Selenium tests, use the OIC for Selenium to inspect application elements. This lets you optimize element identification and generate selenium-based element identification code to use in your scripts.

In this topic:

Supported environments

The OIC for Selenium is supported for Selenium projects on Windows, Linux, and Mac environments.

It is not supported for Safari browser (on Mac). However, you can use the OpenText Functional Testing for Developers extended Selenium locators and utilities when running Selenium tests in Safari.

Back to top

Spy your application and validate elements

Spy your application to uniquely identify an element.

Prerequisite: Make sure that your browsers and WebDriver drivers are set up, as described in Before you start.

To spy elements in your application

1. Launch the OIC in one of the following ways:

   From your IDE menu. Click UFT Developer > Selenium > Object Identification Center.

   You can also open it in standalone mode:

   Windows	Do one of the following: Run OICSelenium.exe from <Installdir>\Tools From the Windows Start menu, open OpenText Functional Testing for Developers > Selenium > Object Identification Center).
   Linux/Mac	From <Installdir>, open the Tools folder and run ./oic-selenium.

2. In the OIC window, click the Browser Launcher button to select and launch a browser.

3. Click the Start spying button.

   The OIC window is moved to the background.

   When you hover over elements in your application, each element is highlighted and a tooltip displays some basic information about it.

   

   On the left of the OIC window, the hierarchy tree displays the element's full hierarchy.

   On the right, the OIC displays the full list of supported locators for the selected element, and the current values captured from your application.

   Tip: To find the application element that corresponds to an element in the OIC, hover over the element's node in the hierarchy tree, and click the Highlight button.

4. Use the OIC to design a test object identification, as described below.

5. To stop spying, press ESC while focused inside the browser.

To design a test object identification

Spy elements in your application as described above. When the OIC displays the information for the element you want to identify, follow the steps below to create an optimal identification:

1. If you need to use an element higher up in the hierarchy for identification, select the checkboxes next to the relevant elements in the hierarchy.

2. On the right, select the locator or locators that you want to use to identify the element.

3. You can modify the values for any selected locator. To enter a regular expression value for a string, click the Set as Regular Expression asterisk to the right of the value box. For details, see Regular expression guidelines.

4. Click the Validate  button on the OIC toolbar to validate your new test object identification.

   OpenText Functional Testing for Developers searches the application for elements that match the element's locator in the OIC.

   Matching elements are highlighted in your application. A message displays how many matches were found. If more than 20 matched are found, the elements are not highlighted in the application.

5. If no matches are found, or if multiple matches are found, adjust the set of locators that you selected and their values, and validate again. Repeat until you get a unique match.

Back to top

Generate element identification code

After you have spied an element and validated its identification, generate code for the element identification and paste it into your test script.

To generate code

1. In the OIC toolbar, click the Generate code to clipboard button. Code identifying the element is generated and copied to the clipboard.

   By default, the OIC generates code in the following languages:

   IDE	Code language
   Native app	Device > Application > Test object
   Hybrid app	Native objects: Device > Application > Test object
   	Web objects: Device > Application > WebView > Page > Test object
   Mobile Web app	Browser > Page > Test object Note: This is the hierarchy displayed for Web applications in general, not just mobile browsers, supporting cross-browser testing.

   By default, the OIC generates C# code in Visual Studio and Java code in all other IDEs. However, you can change the setting to any language supported on your IDE.

   To change the language, click the Settings button and select a language. The selection is saved and used for all subsequent code generations.

2. In your IDE, paste the code into your test script.

   When you paste the generated code, the browser parent element is called driver. If you assigned a different name to your browser element, modify as needed in the pasted code.

Back to top

Capture an image of an element

Capture an image of the element in your application that corresponds to the currently selected element in the OIC.

To capture an image

1. Make sure no other application is covering any part of your application while performing the image capture.

2. Firefox/IE users: Make sure that the tab containing the element is in focus.

3. In the OIC window, make sure the element you want to capture is in focus in the hierarchy tree.

4. In the OIC toolbar, click the Capture object image button.

   The Save File dialog box opens.

5. In the Save File dialog box, save the image to a location of your choice.

Back to top

See also:

• Add steps to your tests

• Object Identification Center