This article describes how to use the ReportToPDF tool to convert existing Ranorex Studio report files to PDF. This allows Ranorex Studio reports to be viewed on computers where Ranorex Studio is not installed.
Note: If you want Ranorex Studio to convert reports to PDF as they are being generated during test execution, use the ReportToPDFModule contained in the Ranorex Studio Automation Helpers.
Screencast: The screencast Converting reports walks you through the information found in this chapter.
Download the ReportToPDF tool
The ReportToPDF tool is available as a standalone executable:
- Ranorex_PDF_Executable.zip: executable for conversion of existing report files (*.rxzlog).
- style.zip: stylesheet to generate the PDF.
Convert an existing report
The ReportToPDF executable is a command line tool that allows you to convert existing Ranorex Studio reports to PDF. The report must be passed to the converter in its compressed form, the so-called rxzlog. The rxzlog is a single archive (.rxzlog extension) including the report and all associated files.
Use the following call to execute the ReportToPDF tool from the command line:
Report.PDF.exe [input file] [output file] /[argument]
The input and output file are required; the arguments are optional.
[input]: Sets the file (*.rxzlog) which is converted.
[output]: Sets the name of the PDF file.
Allowed arguments
style: Sets a custom stylesheet.
detail: Specifies how much information is shown in the generated PDF:
-
none: No module actions are shown. -
failed: Only actions from failed modules are shown. -
all: All actions are shown (default value).