When maintenance mode is active, Ranorex Studio pauses execution upon encountering a supported Ranorex Studio-native error. Depending on the error type, different dialogs appear
Catch and resolve errors
When maintenance mode is active, Ranorex Studio pauses execution upon encountering a supported Ranorex Studio-native error. Depending on the error type, different dialogs appear
Available options
- Open report: Opens the report.
- Continue with error: Continues test execution according to the error behavior set for the test container.
- Abort test run: Aborts the test run.
Element not found
This dialog appears when a UI element can’t be found. It shows the related error message and the RanoreXPath of the associated repository item
- Click Edit and retry to open Ranorex Spy. You can then retract the element or change its path manually. When you apply the changes in Spy, Ranorex Studio automatically retries the failed action using the updated path.
- Click Retry to try again without changing anything. This is useful if you think the path is correct and the element couldn’t be found because the search timeout was too short or the AUT hadn’t reached the correct state yet.
Validation failed
This dialog appears when an expected validation value doesn’t match the actual value. It displays the validation error message with the expected and actual values.
- The drop-down menu contains the expected value (first option) and the actual value (second option).
- In the drop-down, select the actual value.
- Click Apply and retry to rerun the failed action using that value.
Note: Image validations cannot be resolved in maintenance mode. For them, Ranorex Studio shows the generic dialog instead.
Generic dialog
This dialog appears for Ranorex Studio-native errors that are not currently resolvable in maintenance mode.
Click Open Spy to inspect the affected element in Ranorex Spy and diagnose why the error occurred.
Apply your fixes
Once you resolved the errors that appeared in maintenance mode and your test has executed successfully, you can apply the fixes to your test suite in the report.
In the report, maintenance mode events are indicated by a special icon:
- In the report, expand the report item to find the maintenance mode event (marked with the maintenance mode icon and a green check).
- Hover over the event and click Apply… to apply the fix to your test.
Note: Fixes for variables and data bindings can’t be applied automatically. You must update these manually in the test container or data source. This applies to both validation values and RanoreXPaths.