Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

In order to define a new web locator, follow the steps below:

1- Click Image Removed while Add while on Web Locators tab. You can select Folder to create a folder to organize your web locators. To create a new locator, select Locator.

Image RemovedImage Added

2. This will This open up the New Web Locator window. If you have never created locators before, you will not see the prompt below. If you have created locators before, it will appear to ask you if you would like to use the previously used page and frame information will automatically be filled on the web locator form.

Image RemovedImage Added

3- Advanced View of New Locator ( Image RemovedImage Added) will switch to editor mode where you can copy the content of the locator and then Grid View (  ) takes you back to the above view of new Locator definition

Image RemovedImage Added

4. On the window in Step 2, specify the Web Page which is an editable drop-down (best practice is to use application name followed by “_” and followed by page name, for example myApp_login, myApp_search, etc.), Type (another editable drop-down), and Alias for the locator you are defining along with only one unique identifier. This identifier can be the Web ID, Name, Partial Text, CSS Selector, or XPath of the widget. These options can be viewed under Locator Strategy and only the active option will be used.

Image RemovedImage Added

    1. If the locator is on a frame, you need to define the frame by clicking Yes under Located in a Frame? and using the frame XPath. If you have nested frames, you can include the XPath’s for all the frames separated by “;”
    2. If the widget is on a popup window, you need to include a text or phrase that uniquely identifies that popup (only exists on that popup) and add it by clicking Yes under Located in a Popup?
    3. If you have XPath specific to each type of browser, you can include that under Browser Specific section of locator and populate XPath in the Chrome, Firefox, Edge or Safari XPath. These XPaths have priority over the general XPath identified.

For best results with XPath/CSS, you can use our Smart XPath/CSS Generation Engine to generate your XPath values.Image Removed


5- Click the Save & Close button to save your locator. Once saved, your newly defined locator will show up in the locator listing on the Web Locators screen. In order to see the relevant elements, you can filter them using Key, Web Page, XPath, CSS Selector, Frame, Owner, State, or Popup.

...