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 + while Add while on Web Locators tab. You can also select Folder to create a folder to organize your web locators by clicking on  and entering a name for your folder.Image Removed. To create a new locator, select Locator.

Image Added

2. This will This open up the New Locator tab as follows:Image RemovedWeb Locator window. If you have created locators before, the previously used page and frame information will automatically be filled on the web locator form.

Image Added

3- Advanced View icon on the top left of New Web Locator Image Removed) form 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 New Web 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. If more than one of these values is specified, Subject7 will use the first one that it finds based on the order mentioned above and will ignore the rest.These options can be viewed under Locator Strategy and only the active option will be used.

Image 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 Advanced Browser Specific section of locator and populate XPath in the IE XPath, Chrome, Firefox, Edge or Safari XPath, etc. These XPath’s XPaths have priority over the general XPath identified. The image below shows the Advanced menu which is concealed by default.

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.

...