Self-healing | Ranorex Help Center
Help CenterUser GuideRanorex Studio system details

Self-healing

This feature helps to reduce the “Failed to find item” error when running your automated test. Self-healing overcomes this issue by adding an additional robust layer of object recognition to avoid exceptions and reduce manual maintenance

Enable Self-healing

In the top toolbar, click SETTINGS…

When the Settings window opens, select the Advanced tab, and click Expert settings…

Note icon

Note

Review Advanced settings and configurations for more information about RanoreXPath settings.

In the Expert path generation settings window, select Robust RanoreXPath (new) from the RanoreXPath generation mode drop-down list.

Click Apply and OK.

Record your test

Before the self-healing option, when a test failed to find an object, an error displayed in the test log and reported a failed status in the test. The issue had to be solved, to re-run and complete these tests.

The self-healing option finds a similar or the closest object to the missing one in the system while running a test. All the objects are checked based on the attributes that RanoreXPath uses, for more information review Mapping dynamic UI elements.

 

After you enabled the self-healing option, start recording your actions by clicking RECORD.

As soon as you complete your recording, click Validate located in the Ranorex Recorder window.

Once the validation is completed, click Stop to finish your recording. As a result, the recording opens in Ranorex Studio.

In your items section, expand the ApplicationUnderTest. When you select a sub-item, note the RobustPath under the Properties section located on the right side window

Click RUN to start running your test. The self-healing option allows the test to find an appropriate object and continue to run without interruptions or errors.