Settings - Doku Snapper

The following settings can be found under Settings->Engine->Doku Snapper:

Capture Mode

Description

Specify the method for creating screenshots of the currently open window. The following interfaces are available:

Device Context: the system takes a screenshot of the current screen and transfers it via the Graphics Device Interface (GDI).

Copy Screen: the system takes a screenshot of the current screen and transfers it via the clipboard.

Example

Device Context

Enable Snapper

Description

Enable / Disable the DokuSnapper function.

When the DokuSnapper function is enabled, Tosca generates a Microsoft® Word document for every TestCase upon each execution. The document name consists of the TestCase name and the timestamp of the execution time.

Example

NO

Path

Description

The folder for generated Microsoft® Word documents.

Example

@{Environment.AppData}\dokusnapper

Template

Description

The generated document is based on a Microsoft® Word template. During the default installation, Doku Snapper saves a template to the configured Doku Snapper folder.

The central element of this template is a table with two columns. The left column of a row saves a screenshot of the TestStep and the right column contains the data used by the TestStep.

This template can be customized.

Note the following preconditions:

  • The template must contain exactly one table with two columns.

  • You can insert the placeholder <TestCaseName> at any position in the template. When the document is generated, the system replaces this placeholder with the corresponding TestCase name in Tosca Commander.

Example

@{Environment.ProjectDir}\templates\TemplateDokuSnapper.doc

Use Action Text Translation

Description

Enable / Disable the UseActionTextTranslation function

Function enabled:
Dynamic values and special characters of the TestStep are entered abstractly in the data area of the Microsoft® Word document and concretely in the screenshot area. Values marked with the DataType Password are displayed as plain text.

Function disabled:
Dynamic values and special characters of the TestStep are displayed concretely in the data field and the screenshot field of the Microsoft® Word document. Values marked with the DataType Password are displayed blanked with asterisks *****.

Example

Yes

Screen Flow

Description

Generate screenshots of all TestStepValues that use the ActionMode Input (see chapter "Take screenshots of TestStepValues with ActionMode Input").

Example

True

Screen Flow Path

Description

Define a directory where you want Tricentis Tosca to save the screenshots.

If you have enabled Tricentis File Service, you don't have to specify a path. Tricentis Tosca saves the screenshots to the Tricentis File Service.

Example

C:\Temp