Detecting page elements reliability

Modified on Fri, 11 Aug 2023 at 03:10 PM





Web-based application pages can have both static and dynamically rendered content. In order to provide end users with contextual guidance for page elements, Newired has to find and identify them at runtime when the user plays the Journey. If it cannot, then the Journey fails.


Some types of elements are more likely to be found and identified at runtime than others. Our algorithm analyses page elements as you hover over them and displays a reliability score as Excellent/Ok/Bad. Green color (Excellent) indicates higher reliability; yellow and red colors (Ok and Bad) indicate lower reliability.


A lower reliability score does not necessarily mean the Step will fail at runtime, as the real time visibility of a given step depends on other factors as well. You should however be sure to test lower score elements in relevant runtime scenarios.





In the above figure, both selections will appear to the end user as pointing to the Main page item in the navigation menu. However, in a dynamic page environment, the Text element is much more likely to always be present, and so the algorithm gives it a higher reliability score. In general, you should try to always select an element with the best score, which will still be clearly indicated to end users.


TIP: If the underlying app or site has the capability to render content in multiple languages, a Journey can fail even if a page element has a high reliability score in the Journey primary language. For such apps or sites, you may need to create translations of page elements. For information, see Translation/localization of Journey content and Translation of an Application or Website here.


 How to use precise selection


To increase the selection accuracy, you can use the mouse combination Ctrl+Alt+mouse wheel (or touchpad movement). This will enable you to correctly go through all items of the page, if you aren't able to select them by just hovering on the wanted item.

 


Element IDs and Reliability

Every page element has an ID, but there is no way for Newired to determine if an ID can be trusted enough to continue a Journey and run a Step.


For every Site, you should consult with the developers or support personnel of the underlying application or website to determine if page element IDs can be trusted. For example, some IDs may be automatically generated and change when the page is refreshed. In such cases, you need to tell the Newired system not to trust element IDs.


  1. In the portal, open the Site and select the Site Settings tab.
  2. Scroll the page to show the Trust page element IDs option.
  3. If element IDs should not be trusted, uncheck the checkbox. Otherwise, check it.


When this option is checked, element IDs will have a high reliability score. When it is unchecked, element IDs are still evaluated, but they will have a lower reliability score. This helps you make the best choice of available page elements and thus to reduce the chances of a Journey failing. 


Reliability in the Step Editor and selector precision

While editing a step or tip, you can see its reliability in both the up-right corner of Step Editor and the up-left corner of selector precision. This way, if you make some changes in the selector precision, you can see real-time the reliability acquired or lost. Extra waiting time has been moved to the selector precision panel.


 

 

Selector Passive Mode

The selector "Passive Mode" enables you to click on the page elements without attaching the step/tip to the items clicked. This enables you to click elements that require additional clicks in order to display. Check this article to know more about it.



Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select atleast one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article