Managing recording modules | Ranorex
HomeUser GuideRanorex Studio FundamentalsManaging recording modules

Managing recording modules

This chapter is to introduce and explain the various options for managing and structuring recordings within Ranorex Studio. This topic has a strong link to test suite which plays a central role in modularizing and structuring test cases.

In this chapter

    Renaming recording modules

    The default naming of recordings is along the sequence of their creation where the prefix Recording is followed by consecutive numbers, i.e. Recording1, Recording2, Recording3, … Default names of recording modules are changed easily.

    Changing recording module name

    Changing recording module name

    Renaming in project file view

    • Renaming recording modules in project file view
    • The names of all corresponding files are changed accordingly
    Renaming in module browser view

    • Renaming through context menu, or F2

    Cut/copy/paste/delete

    Cutting/copying/pasting and deleting is done by well-known keyboard, context menu and toolbar actions.

    Cut/copy/paste/delete action elements

    Cut/copy/paste/delete action elements

    Cut/copy/paste/delete in context menu
    Cut/copy/paste/delete in toolbar menu
    tipp icon

    Hint

    These functions can only be performed in the project file view and not in the module browser view.

    Structuring recording modules in folders

    Folders allow building a structure in a hierarchical way to group, store and manage recording modules.

    Creating a new folder in the project file view

    Creating a new folder in the project file view

    Select the folder in the project file view where to add a new folder
    Open the context menu
    Click > Add > New folder
    Assign the folder a meaningful name (e.g. MyRecordings)
    Moving recording modules to new folder

    Moving recording modules to new folder

    Drag the recording module on to the new folder

    Result(s):

    Recording module in new folder in project file view
    Recording module in new folder in module browser view

    Structuring within recording modules

    Recordings by itself usually consist of a sequence of actions in a defined order. There is no way of structuring actions within an action list. The separation of actions in visual groups is another is the only structuring method within recording modules.

    Adding a separator action into a recording module

    Adding a separator action into a recording module

    Click > Add new action > Separator
    See the separator action within the recording module

    Result(s):

    • The separator is being inserted as log message into the final report
    Separator message in test report

    Separator message in test report

    Further reading

    Inserting a separator is also part of the larger context of reporting which is introduced and explained in detail in > Ranorex Studio fundamentals > Reporting > ⇢ Basic report characteristics & data.

    Adding a new recording module

    Recording modules shall be as small as possible and as large as necessary. Adding new recording modules is, therefore, necessary for well-structured test cases.

    Adding a new recording module

    Adding a new recording module

    Click the symbol for adding a new recording module in the Studio toolbar
    Select the destination folder for the new recording module and confirm with OK
    Assign the recording module a meaningful name and click Create

    Result(s):

    • Find the new empty recording module in the Studio working environment
    New recording module in project file view and module browser view

    New recording module in project file view and module browser view

    New recording module in project file view
    New recording module in module browser view

    Building a new recording module

    Usually, recordings are not produced in the modular and small way they should be with respect to modularization and possible re-use. Tests are rather recorded along a proper test sequence following a storybook and therefore need to be split into re-usable modules afterward. This section shows how to do this.

    Select the actions which are to form a new and separate recording module and open the context menu
    Building a new recording module

    Building a new recording module

    Click Move to new recording module
    Give the new recording module a meaningful name
    Click Create

    Result(s):

    The new recording module is build based on the selected actions and stored within the project file structure.

     

    New built recording module

    New built recording module