Print reports

You can print reports for the following object types:

• Modules and XModules

• TestCases

• ExecutionLists and ExecutionLogs

• Requirements and RequirementSets

• TestCase-Design TestSheets

• Report definitions

• Project root element

Prerequisites

To print reports, you must meet the following requirements:

• You've assigned your object to a report definition and selected a designer definition for it (see chapter "Create a report definition").

• The report folder is directly below project root level. This means that it's not, for example, located in a ComponentFolder.

If you want to customize your report settings before you print, go to Project->Options->ReportingUI.

Print your report

To print a report, follow the steps below:

1. Right-click on the object for which you want to print a report.

2. Select Print Report ... from the context menu and select your report definition.

   If you have assigned an object to more than one report definition, you get multiple options. You can print a report for each of them.

Disable report definition

Disable a report definition if you don't want it to be available in the Print Report ... context menu anymore. To do so, follow the steps below:

1. Select the report definition and open the Properties pane.

2. Set the property Enabled to False.

Exclude items from a report

You can exclude selected dataset definitions from your printed report. To do so, follow the steps below:

1. In the Details tab, go to the dataset definition you want to omit.

2. Select the check box in the column Omit in Sequence. If the column is not visible, use the Column Chooser to add it.

Alternatively, open the Properties pane and set the property OmitInSequence to True.

Create automated reports via TCShell

You can automatically generate reports via TCShell. To do so, follow the steps below:

1. In Tosca Commander, select the Report Definition for which you want to print a report. Make sure that the value of the property PrintOutputFormat is set to NONE.

2. Go to %COMMANDER_HOME%.

3. Copy the file TCShell.exe.config and paste it in %TRICENTIS_ALLUSERS_APPDATA%\Settings\.

4. Open the copy of TCShell.exe.config file.

5. Under <sectionGroup>, copy an existing <section...*> and paste it directly below its location.

6. Replace name="..." with the following line: "Tricentis.TCAddIns.Reporting.Properties.Settings".

7. Under <userSettings>, copy and paste the following lines:

   Copy

   <Tricentis.TCAddIns.Reporting.Properties.Settings>
       <setting name="DefaultPrintOutputFormat" serializeAs="String">
           <value>ASKUSER</value>
       </setting>
   </Tricentis.TCAddIns.Reporting.Properties.Settings>

   This allows TCShell to create reports without any user interaction.

8. Save and close your TCShell.exe.config file.

9. Start TCShell and navigate to the correct workspace and to the object for which you want to print a report. For information on how to do so, see chapter "Use TC-Shell commands".

10. To print your report, enter the command Print Report....

Example: print a report via TCShell

In the following example, you print your report Test Case Report to PDF and save it to your D:\ drive. To do so, you use the following TCShell commands: You use the TCShell command ChangeNode (cn) to navigate to TestCases. You enter the task Print Report ... and the file path where you want to save your PDF file. You use the command exit to exit TCShell and y to confirm that you want to exit. cn TestCases task "Print Report ... Test Case Report" D:\\example.pdf exit y This generates the report file example.pdf and saves it to your D:\ drive.