Report Settings

Report settings define how Ranorex Studio generates and stores test results. Access these settings through the Properties pane of the corresponding test suite.

1. Select the test suite in the Projects view and open the context menu.
2. Click Properties.
   
3. In the settings window, click the Report tab.
   

The following settings control the storage and identification of test results.

1. Enable report: Generates report files for the test run. If you deselect this, Ranorex does not create report files.
2. Report description: Adds a custom text description to the report header. This provides high-level context, such as the test objective or environment details, directly within the test results.
3. Report directory: Sets a specific folder for report storage. This folder replaces the standard project report directory.
4. Report file name: Configures the automated standard report file name.
5. Set of file name parts for automated report file names (set available as tool-tip).
6. Auto save interval: Defines how often Ranorex writes the report to disk (in seconds). A value of '0' turns off auto-save.
7. Timestamp: Sets the format of the timestamp within the report.

Reference: Ranorex standard reporting introduces and explains in detail the concept of report file names and report directories.

• Enable CSV export: Enables the CSV export functionality.
• Export all columns: Includes all items in the report.
• Export selected columns: Includes only the selected items in the report. The mandatory columns appear grayed out because you cannot eliminate them from the export.

Important: In the current CSV export behavior, when a test suite contains mixed results, suite-level summary values may be repeated in every row. This includes columns such as TestSuiteResult, TotalSuccess, TotalFailure, TotalErrors, TotalWarning, and TotalBlocked. For example, if one test case fails, TestSuiteResult may show Failed in every row, even for rows where TestCaseResult or ModuleResult is Success. 
When reviewing detailed CSV results, use row-level result columns, such as TestCaseResult and ModuleResult, to evaluate individual test cases or modules. Treat TestSuiteResult and the total columns as overall test suite summary values.

The report template defines the visual layout and branding of the test results. You can Create a custom template or Choose custom template. For more information, see Report Customization.

Tracing screenshots provide visual context for actions in the report.

• Tracing mode:
  • Foreground: Captures the tracing screenshot before the action executes. This increases accuracy but may impact performance.
  • Background: Captures the tracing screenshot while the action executes. This offers better performance but may reduce accuracy.
  • Off: Captures no tracing screenshots.

• Quality: Adjusts the image quality to manage file size.

Video reporting records a test run as a collection of videos. This feature also works on Ranorex Agents.

1. Recording mode: 
   • Off:  Disables video recording.
   • Failed test cases only: Records the run but only saves videos for failed test cases.

   • All test cases: Records and saves videos for every test case.

     Note: Ranorex Studio records a separate video for each test case. For video reporting, test case means: Test cases and Setup/teardown regions outside of test cases

2. Bitrate (kbps): Defines the data rate for the video file. Lower values make video files smaller, but also lower image quality.
3. Frame rate (fps): The frame rate of the videos. Lower values make video files smaller, but fewer frames also mean less information.
4. Source screen: The screen you want Ranorex Studio to record. The screen numbers correspond to the display settings in Windows. Auto uses the screen the mouse is on at the start of the test run.

Note: If you specify a Source screen that does not exist on the target machine (e.g., selecting 4 on a system with only 2 monitors), Ranorex defaults to the Primary Screen.