Concept of validation | Ranorex
Help CenterUser GuideRanorex Studio fundamentals

Concept of validation

Test validation is based on a process with four consecutive steps. Once entered, the steps are automatically performed one after the other. Usually, the process is started from within a test recording. In this case, the recording is automatically paused until the validation process has been finished and automatically resumes afterward. The process anyway, is also valid if applied manually.

In this chapter

    Concept overview

    Depending on the type of validation (i.e. attribute-based, or image-based validation) the process steps vary in their specification and setting, but they are always the same with respect to their objectives.

    The purpose of this chapter is to introduce and explain them.

    Test validation standard process

    Test validation standard process

    Activating validation

    Within Ranorex, validation is treated as a special type of action. Therefore, ‘activating’ the test validation means inserting a validation action into the current recording module. The herein described activation steps refer to the insertion of a test validation during a recording.

    Validation actions, of course, can also be added manually which is described and introduced in the referring user guide chapter.

    Further reading

    If you are not familiar with the concept of action, we recommend reading > Ranorex Studio fundamentals > ⇢ Actions.

    Test validation activation

    Test validation activation

    Text-based validation

    • Click Validate to activate text-based validation mode

    Image-based validation

    • Select the checkbox Image based
    • Click Validate to activate image-based validation mode
    Note icon


    The recording is paused during the definition and specification of a test validation. This is indicated by the green bar in the Recorder control center.

    Specifying the validation element

    The second step of the validation process is the specification of the validation element. Specifying the validation element means identification of the UI-element which is to be validated. The specification process is independent of the type of validation (i.e. text/attribute/image-based validation).

    Move the mouse over the UI-element which is to be validated

    • A purple colored frame follows the mouse movement
    • It identifies UI-elements along the mouse movement

    Select by mouse-click as soon as you have identified the designated UI-element

    Selection of validation elements

    Selection of validation elements

    Selection of a text-based validation element
    Selection of a image-based validation element

    tipp icon


    • The identification of validation UI-element may be tricky. Especially if the referring UI-element is nested closely with other UI-elements. Take your time, there is no need for hurry.
    • If you have selected the wrong UI-element by mistake, no problem! You can change it during the next step.

    Confirmation of validation element

    The third step of the validation process is the confirmation of the previously selected validation UI-element. This step outlines two objectives:

    Check if the correct UI-element has been selected in the previous process step, or correct the selection
    Finally, confirm the selection by clicking Next

    Confirmation dialog components

    Components of validation confirmation dialog

    Components of validation confirmation dialog

    UI-element location within GUI

    • Ranorex identifies every UI-element within the application under test
    • All UI-elements are managed in a hierarchical tree-like storage structure
    • The names of the UI-elements are retrieved from their underlying type and content

    UI-element states & attributes

    • Every UI-element is defined by a set of attributes and states
    • An example of a state is ‘Enabled’ with a current value of ‘True’
    • An example of an attribute is the UI-elements name, i.e. a text-attribute with the current value ‘lblWelcomeMessage’

    Screenshot of validation UI-element

    • A screenshot of the selected UI-element is displayed for a quick check & confirmation

    Further reading

    UI-elements, their representation within Ranorex and their states and attributes are introduced and explained within the advanced chapter > Ranorex Studio advanced > ⇢ UI-elements.

    Confirmation action

    Click Next to confirm validation element

    Click Next to confirm validation element

    Confirmation of text-based validation element
    Confirmation of image-based validation element

    Defining validation attributes

    Every UI-element is defined by states and attributes. During the final step, the attribute or state which is applied for the test validation is to be specified. Therefore, a dialog is displayed to specify the necessary settings.

    Attribute / sub-image selection for validation UI-elements

    Attribute / sub-image selection for validation UI-elements

    Attribute/state selection for text/attribute-based validation

    • Any of the available attributes/states can be selected
    • The text attribute is the default attribute for text-based validation
    • Select attribute and confirm with OK

    (Sub-)image selection for image-based validation

    • A sub-region of the image can be selected by drawing a pink rectangle within the image
    • If you do not select a sub-region, the complete image is used for test validation

    Image validation mode

    • None = No image-based validation; validation discarded
    • Contains = Matched image is checked to be contained in the reference validation image
    • Compare = Matched image is checked against complete reference validation image

    Validation examples

    The herein introduced concept of validation is explained along some examples which may help you to deepen your understanding of this important topic.

    Further reading

    The current section refers to some further and more advanced topics which are listed herein after.

    Further reading

    UI-elements, their representation, and management within Ranorex and their attributes and states are introduced and explained in detail in > Ranorex Studio advanced > ⇢ UI-elements.

    Further reading

    The concept of image-based automation along with explaining examples is introduced and explained in detail in > Ranorex Studio advanced > ⇢ Image-based automation.