Files and directories

This chapter provides an overview of the most important Tricentis Test Automation for SAP files and directories. All paths refer to a standard installation on the C: drive with the default paths suggested by Tricentis.

To work with Tricentis Test Automation for SAP, every Windows user needs unlimited write access to the directories %TRICENTIS_PROJECTS% and %TRICENTIS_ALLUSERS_APPDATA%. The Tosca_Projects folder must be placed on a directory that is persistent on the machine.

Environment variables

During installation, Tricentis Test Automation for SAP creates environment variables by default. The path may vary depending on the operating system you use.

You can modify all default environment variables.

Enter SET into the command line to view the paths to the environment variables listed in the table below.

Environment variables

Environment variable

Examples for Windows 7 (64-bit)

%COMMANDER_HOME%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\ToscaCommander

%TBOX_HOME%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\TBox\

%TRICENTIS_PROJECTS%

C:\Tosca_Projects\

%TRICENTIS_SEARCH%

C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\dll;C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\dll\GuptaEngine;...

%TRICENTIS_ALLUSERS_APPDATA%

C:\ProgramData\TRICENTIS\Tosca Testsuite\7.0.0

Tricentis Test Automation for SAP saves specific information, such as user settings or temporary files under the following path: %APPDATA%\TRICENTIS. If necessary, an administrator can modify this path.

%COMMANDER_HOME%

This is the default directory for Test Automation for SAP Commander. It contains all files required for Test Automation for SAP Commander.

The most important subdirectories are described below in greater detail. The specified paths can be copied to the Windows dialog Start->Run to identify the respective paths.

%COMMANDER_HOME%\SQL

This directory contains SQL scripts for Azure SQL Server, DB2, MS SQL Server and Oracle in order to create databases for Test Automation for SAP Commander.

%COMMANDER_HOME%\x64

This directory contains files required for general access to Tricentis Test Automation for SAP workspaces in 64-bit systems.

%COMMANDER_HOME%\x86

This directory contains files required for general access to Tricentis Test Automation for SAP workspaces in 32-bit systems.

%TBOX_HOME%

This is the default directory for Test Automation for SAP TBox. It contains all files required for Test Automation for SAP TBox.

The most important subdirectories are described below in greater detail. The specified paths can be copied to the Windows dialog Start->Run to identify the respective paths.

%TBOX_HOME%\java

This directory contains files required for Test Automation for SAP TBox Java components.

%TBOX_HOME%\nunit

This directory contains files required by Test Automation for SAP TBox which are used to start Selenium scripts.

%TBOX_HOME%\opencv

This directory contains files required for image-based test automation.

%TBOX_HOME%\Resources

This directory contains Test Automation for SAP TBox browser extensions.

%TRICENTIS_PROJECTS%

This is the default directory where all project-related data is stored.

This directory contains temporary files, sample files and configuration files. The subdirectories are described below.

The specified paths can be copied to the Windows dialog Start-> Run in order to identify the respective paths.

%TRICENTIS_PROJECTS%\Tosca_CommonRepositories

This is the default directory for Test Automation for SAP Commander common repositories with data management in the file system. Please make sure that all users have access to this directory in multi-user environments.

%TRICENTIS_PROJECTS%\Tosca_Workspaces

This is the default directory for Test Automation for SAP Commander workspaces with data management in the file system. Log files are saved to the workspace folder of your project.

This directory contains the following pre-defined workspace: First Steps.

%TRICENTIS_PROJECTS%\ToscaCommander

This is the default project directory for Test Automation for SAP Commander projects. It contains the standard subset file Standard.tsu.

%TRICENTIS_ALLUSERS_APPDATA%

This directory contains all user-specific files. This is the case when users add, for instance, definitions or modify settings (see chapter " Hierarchy of the Settings Files"). This directory is not removed when you uninstall Test Automation for SAP Commander.

You can find a description for all %TRICENTIS_ALLUSERS_APPDATA% subdirectories below. You can copy the specified paths to the Windows dialog Start->Run to identify the respective paths.

You can install the %TRICENTIS_ALLUSERS_APPDATA% directory on a network drive. To do so, use the Windows Installer property NETDRIVE.

In this case, the Tricentis Test Automation for SAP setup skips the access permission configuration for the chosen directory, so you need to set the necessary access permissions before you prompt the installation. Possible access permissions are Group EVERYONE, Full Access, or recursive inheritance.

In this example, the command below grants recursive inheritance.

icacls "<%TRICENTIS_ALLUSERS_APPDATA%>" /t /grant *S-1-1-0:(OI)(CI)F

By default, the NETDRIVE value is 0. In this case, the Tricentis Test Automation for SAP installer sets permissions for user EveryOne on %TRICENTIS_ALLUSERS_APPDATA%.

If you want to use NETDRIVE, set the NETDRIVE value to 1. In this case, you have to set permissions for %TRICENTIS_ALLUSERS_APPDATA% yourself.

However, you need to ensure that Tricentis Test Automation for SAP users have FullControl permissions for %TRICENTIS_ALLUSERS_APPDATA% during Tricentis Test Automation for SAP runtime.

In this example, the command below starts an unattended installation with the following conditions:

  • It installs %TRICENTIS_ALLUSERS_APPDATA% in the directory \\example.domain.com\files\johndoe\toscasettings

  • Tricentis Test Automation for SAP doesn't set permissions for %TRICENTIS_ALLUSERS_APPDATA%

"TricentisTestAutomationSAP<versionnumber>.exe" /s NETDRIVE=1 TRICENTIS_ALLUSERS_APPDATA=\\example.domain.com\files\johndoe\toscasettings /qn

In this example, the command below starts an attended installation and enables NETDRIVE.

"TricentisTestAutomationSAP<versionnumber>.exe"/s NETDRIVE=1 /qn

%TRICENTIS_ALLUSERS_APPDATA%\ManagedFilesArea

This is the default directory for managing file references externally (see chapter "Create file reference with central storage location").

%TRICENTIS_ALLUSERS_APPDATA%\Settings\Dat

This is the directory for user-specific configuration files for Test Automation for SAP Engines.

ObjectMappings.dat

WinClassMappings.dat

WizardMappings.dat

%TRICENTIS_ALLUSERS_APPDATA%\Settings\XML

This is the directory for user-specific settings files.

Settings.xml

UserDefinition.xml