Document the execution of your tests
If you want to document the execution of your tests for reporting purposes, you can configure Tosca Commander to perform the following actions:
-
Take screenshots of failed TestSteps:
Tosca Commander generates screenshots of all TestSteps that failed because of verification or dialog failures. For tests created with Classic Engines, you can also take screenshots of user aborts.
-
Take screenshots of TestStepValues:
Tosca Commander generates screenshots of all TestStepValues that use the ActionMode Input. Use this option if you want to view screenshots of values that Tosca Commander used during execution.
-
Use DokuSnapper to generate a Microsoft® Word document that contains screenshots and data on all executed TestSteps. Rather than generate separate screenshots for every TestStep, DokuSnapper collects all data in one document.
If you run TestCases via ExecutionList, DokuSnapper creates a document for each completed ExecutionEntry. If you run TestCases in the ScratchBook, DokuSnapper creates a document for each TestStep.
Take screenshots of failed TestSteps
This option is available for tests created with the following engines:
-
All Classic Engines
Tosca Commander does not generate screenshots for Modules with the property SpecialExecutionTask. |
Enable screenshots
To enable screenshots of failed TestSteps, choose the respective value for the setting Make screenshot on failed test steps in the settings dialog that applies to your tests:
Engine |
Setting |
---|---|
Engines 3.0 |
Project->Settings->TBox->Logging->Screenshots (see chapter "Settings - Logging") |
Classic Engines |
Project->Settings->Engine->Logging Options->Screenshots (see chapter "Settings - Logging Options") |
Tests created with Engines 3.0: Available values for Make screenshot on failed test steps setting
You can also define a directory in which you want to save your screenshots as well as the desired image format in the settings dialog.
If you have enabled Tricentis File Service, you don't have to define a path for your screenshots. In this case, Tricentis Tosca saves the screenshots to the Tricentis File Service.
View screenshots
When you execute your tests, Tosca Commander saves your screenshots in the specified directory and displays the screenshots in the Detail column. Hover your mouse over the screenshot to see a tool tip with the path to the screenshot.
Failed verification in the Make TestStep
If you have enabled Tricentis File Service, the Detail column shows a confirmation message that the screenshots have been saved.
To view your screenshots, right-click the message and select View Screenshots from the context menu.
You can double-click the Before or After image to view it full-screen.
Take screenshots of TestStepValues with ActionMode Input
This option is only available for tests created with the following Engines 3.0: Mobile, AnyUI, DotNet, UIA, XBrowser, and Image-based test automation.
Tosca Commander does not generate screenshots for Modules with the property SpecialExecutionTask. |
Enable screenshots
You can enable screenshots in one of two ways:
-
Globally, via the settings Screen Flow and Screen Flow Path under Project->Settings->Engine->Doku Snapper
-
For specific TestCases, ExecutionLists, or ExecutionEntries by creating test configuration parameters
Test configuration parameters ScreenFlow and ScreenFlowPath
If you have enabled Tricentis File Service, you don't have to define a path for your screenshots. In this case, Tricentis Tosca saves the screenshots to the Tricentis File Service.
View screenshots
When you execute your tests, Tosca Commander creates a folder with screenshots in the specified directory and displays the path in the Detail column of the TestStepValue.
Path to screenshots in the Detail column
If you have enabled Tricentis File Service, the Detail column shows a confirmation message that the screenshots have been saved.
To view your screenshots, right-click the message and select View Screenshots from the context menu.
View screenshots: Before and after executing the TestStep
You can double-click the Before or After image to view it full-screen.
Use DokuSnapper to generate a Microsoft® Word document
This option is available for tests created with the following engines:
-
All Classic Engines
Tosca Commander does not generate screenshots for Modules with the property SpecialExecutionTask. |
DokuSnapper is not available for Tosca Distributed Execution via Execution Agent. |
To enable DokuSnapper, enable the setting Enable Snapper under Project->Settings->Engine->DokuSnapper.
For more information on DokuSnapper settings, see chapter "Settings - Doku Snapper".
Recorded TestStep in the Microsoft® Word document
The amount of memory needed by DokuSnapper depends on the number and complexity of your TestCases. |
Exclude Modules or ModuleAttributes
You can exclude individual Modules or ModuleAttributes from recording with DokuSnapper.
To exclude Engine 3.0 XModules or XModuleAttributes, create a configuration parameter called AvoidSnapper and set it to True.
Exclude Example XModule from recording with DokuSnapper
To exclude Classic Modules or ModuleAttributes, create the parameter AvoidSnapper for the ObjectMap of the Module and set it to 1.
Exclude Example Classic Module from recording with DokuSnapper