Settings - Engines

The following setting is located at Settings -> TBox -> Engines:

Remote server connection timeout
Description	Time in milliseconds that Tosca waits for XEngine server processes to establish an initial connection. For example, the SAP Engine 3.0 components may use server processes such as Tricentis.Automation.ApiServer.exe. Establishing the initial connection may take longer than the default time, which is 20000 milliseconds.
Example	45000

Remote server connection timeout

Description

Time in milliseconds that Tosca waits for XEngine server processes to establish an initial connection.

For example, the SAP Engine 3.0 components may use server processes such as Tricentis.Automation.ApiServer.exe. Establishing the initial connection may take longer than the default time, which is 20000 milliseconds.

Example

45000

Remote server response timeout
Description	Time in milliseconds that Tosca waits for a response from XEngine server processes. The default value is 120000.
Example	150500

Key Vault path
Description	The path to your key vault executable. For information about configuration for your specific key vault provider, check out "Specify a different path to the key vault executable".
Example	C:\Users\my\OnePwd

Database

SQLite Enable Extension loading
Description	If you enable this setting, you can load SQLite extensions, for instance to perform searches. You can load either external DLL files or the SQLite.Interop.dll library that is already installed with Tricentis Tosca. To enable the setting, set it to True. If you enable this setting, you also need to populate the setting SQLite Extension(s) to load.
Example	True

SQLite Enable Extension loading

Description

If you enable this setting, you can load SQLite extensions, for instance to perform searches. You can load either external DLL files or the SQLite.Interop.dll library that is already installed with Tricentis Tosca.

To enable the setting, set it to True.

If you enable this setting, you also need to populate the setting SQLite Extension(s) to load.

Example

True

SQLite Extension(s) to load
Description	Enter the full path of the extension(s) that you want to load as follows: \path\to\library\library.dll=extension_name. If you want to use multiple extensions, separate them with a semicolon. If you want to load the SQLite.Interop.dll library, you do not need to enter the full path.
Example	SQLite.Interop.dll=sqlite3_json_init

SQLite Extension(s) to load

Description

Enter the full path of the extension(s) that you want to load as follows: \path\to\library\library.dll=extension_name. If you want to use multiple extensions, separate them with a semicolon.

If you want to load the SQLite.Interop.dll library, you do not need to enter the full path.

Example

SQLite.Interop.dll=sqlite3_json_init

Java

DisableSecurityManager
Description	This setting enables or disables the Java Security Manager used. The following options are available for selection: True: the Java Security Manager is disabled. False: the Java Security Manager is enabled. Webstart Only: The Java Security Manager is disabled for Webstart applications only.
Example	False

DisableSecurityManager

Description

This setting enables or disables the Java Security Manager used. The following options are available for selection:

True: the Java Security Manager is disabled.
False: the Java Security Manager is enabled.
Webstart Only: The Java Security Manager is disabled for Webstart applications only.

Example

False

Mobile30

Auto checkout/checkin configuration
Description	Set to False if you don't want the Mobile Scan to automatically check out and check in the Mobile configuration node. The default value is True.
Example	False

Auto checkout/checkin configuration

Description

Set to False if you don't want the Mobile Scan to automatically check out and check in the Mobile configuration node.

The default value is True.

Example

False

Default iOS Simulator Version
Description	Default iOS simulator version.
Example	11.3

Desired capabilities path
Description	Path to a directory that contains the configuration files with Desired Capabilities.
Example	C:\YourFolder

Enable Native scan
Description	Enables or disables scanning of native applications on Android in the Mobile Engine 3.0.
Example	False

Engine for mobile web scans
Description	The engine you want to use to scan your mobile web applications. By default, this is set to Mobile Web Engine 3.0. We recommend keeping this setting for optimal performance and compatibility.
Example	XBrowser Engine 3.0

EncodeJavaScript
Description	Encodes JavaScript resources for execution and scanning on mobile web applications. The default value is False.
Example	True

EncodeJavaScript

Description

Encodes JavaScript resources for execution and scanning on mobile web applications.

The default value is False.

Example

True

PDF

Compare failed pages directory
Description	Path to the directory where you want to save the comparison report.
Example	@{Environment.ProjectDir}\PdfCompareFailedPages

Ignore whitespaces in text-only comparison
Description	Specify whether you want to ignore whitespaces during a text-only comparison of two PDF files with the PDF 1:1 Compare Module. By default, the setting is False, which means that Tosca takes whitespaces into account.
Example	True

SAP

Automatic TestCase creation and start Automation Recording Assistant (Tricentis ARA)
Description	Enables Tricentis Tosca to automatically perform the following actions: Create the TestSteps SAP Logon, SAP Login, and SAP Toolbar. Run these TestSteps. Start Tricentis ARA. The default value is False.
Example	True

Automatic TestCase creation and start Automation Recording Assistant (Tricentis ARA)

Description

Enables Tricentis Tosca to automatically perform the following actions:

Create the TestSteps SAP Logon, SAP Login, and SAP Toolbar.
Run these TestSteps.
Start Tricentis ARA.

The default value is False.

Example

True

Combobox items selectable by its Key
Description	Enables Tricentis Tosca to identify ComboBox items by keys and values.
Example	False

Log level for Solution Documentation Synchronization
Description	Enables Tricentis Tosca to save log messages that are exchanged between Tricentis Tosca and SAP Solution Manger. The following options are available: Off: no messages are logged. Basic: the most important messages are logged. Comprehensive: all messages are logged. The default value is Off.
Example	Basic

Log level for Solution Documentation Synchronization

Description

Enables Tricentis Tosca to save log messages that are exchanged between Tricentis Tosca and SAP Solution Manger.

The following options are available:

Off: no messages are logged.
Basic: the most important messages are logged.
Comprehensive: all messages are logged.

The default value is Off.

Example

Basic

Log path for Solution Documentation Synchronization
Description	Specify the directory where you want to save the log messages that are exchanged between Tricentis Tosca and SAP Solution Manager.
Example	False

TableCompare

EnableAutoCreateBaseline
Description	Determines if automatic generation of baselines is enabled. The default value is False.
Example	True

UIA

StopAtThumb
Description	Defines if steering should stop at Thumbs with no name while looking for child elements. If you set this setting to True, the scan will stop when a control with type Thumb is found. If you set the setting to False, the scan will not stop when a control with type Thumb is found and continues searching for the next child item of the control.
Example	True

StopAtThumb

Description

Defines if steering should stop at Thumbs with no name while looking for child elements.

If you set this setting to True, the scan will stop when a control with type Thumb is found. If you set the setting to False, the scan will not stop when a control with type Thumb is found and continues searching for the next child item of the control.

Example

True

Window Class Names
Description	Enter one or more class names, separated by semicolon (;).Tosca treats elements with these class names as windows.
Example	Chrome_WidgetWin_1

Web service

These settings control API Engine 3.0 configuration.

Request/Response log directory
Description	This setting specifies the directory where the log files are stored. Tricentis Tosca creates log files if you have defined the test configuration parameter WebserviceEngineLogRequestResponse (see chapter "Logging").
Example	%APPDATA%\Tricentis\TOSCA Testsuite\7.0.0\logs\Automation\WSE

Response timeout
Description	This setting specifies how many milliseconds the system waits for a web service to respond.
Example	60000

Web service->Ports

Server
Description	Defines which port is used for the Webservice server.
Example	17006

Web service->WebsphereMQ

Enable JMS
Description	If this setting is enabled, the message sent via WebsphereMQ receives a MQRFH2 header.
Example	True

Win32->Ports

Server
Description	Defines which port is used for the Win32 server.
Example	17002

XBrowser

Browser pipe connection timeout
Description	Defines the time limit in milliseconds for establishing a connection between TBox and HtmlEngineExtensionHelpers. Its default value is 5000 milliseconds, which means TBox waits up to 5 seconds to establish a connection before timing out. If your browser responds slowly, we recommend you try increasing this timeout value. Note that if you don't set a TCP Browser, TBox waits up to three times the specified timeout value.
Example	6000

Browser pipe connection timeout

Description

Defines the time limit in milliseconds for establishing a connection between TBox and HtmlEngineExtensionHelpers. Its default value is 5000 milliseconds, which means TBox waits up to 5 seconds to establish a connection before timing out.

If your browser responds slowly, we recommend you try increasing this timeout value.

Note that if you don't set a TCP Browser, TBox waits up to three times the specified timeout value.

Example

6000

Enable slot content handling
Description	Specify whether to display controls as children of their assigned slot element. This setting works as follows: If True, the controls appear as children of their assigned slot. During scanning, Tosca automatically adds the steering parameter EnableSlotContentHandling with the value True to XBrowser controls. If False (default), the controls appear as they are in the DOM structure. During scanning, Tosca automatically adds the steering parameter EnableSlotContentHandling with the value False to XBrowser controls.
Example	False

Enable slot content handling

Description

Specify whether to display controls as children of their assigned slot element. This setting works as follows:

If True, the controls appear as children of their assigned slot. During scanning, Tosca automatically adds the steering parameter EnableSlotContentHandling with the value True to XBrowser controls.
If False (default), the controls appear as they are in the DOM structure. During scanning, Tosca automatically adds the steering parameter EnableSlotContentHandling with the value False to XBrowser controls.

Example

False

Enable XPath identification
Description	Allows you to use XPath expressions to identify HTML elements in your application during test automation. This is a more precise way to locate elements and lets you specify complex queries to target specific elements based on their attributes, hierarchy, or other characteristics. The default value is True.
Example	True

Hide Soft Hyphens
Description	By default, XBrowser Engine 3.0 ignores soft hyphens for all HTML elements. If you want to see soft hyphens in controls' properties, change the value of this setting to False. The properties InnerHtml and OuterHtml include soft hyphen in their values even if this setting is set to True.
Example	True

Hide Soft Hyphens

Description

By default, XBrowser Engine 3.0 ignores soft hyphens for all HTML elements. If you want to see soft hyphens in controls' properties, change the value of this setting to False.

The properties InnerHtml and OuterHtml include soft hyphen in their values even if this setting is set to True.

Example

True

Ignore Aria controls
Description	Specify whether to ignore the role of all or only specific ARIA controls during the scan. This setting works as follows: If set to False (default), XBrowser Engine 3.0 automatically adds the steering parameter IgnoriaAriaControls to XBrowser controls during the scan and sets it to False. This option lets you use ARIA attributes to identify and steer these controls, if available. If set to True, XBrowser Engine 3.0 doesn't automatically add the steering parameter IgnoriaAriaControls to XBrowser controls during the scan. This option maximizes compatibility. If you encounter issues with XBrowser customizations, set to True. If set to a specific control name, XBrowser Engine 3.0 automatically adds the steering parameter IgnoreAriaControls to XBrowser controls during the scan and sets it to the specific control. This option lets you specify the specific ARIA roles you want to ignore. To ignore multiple controls, configure the setting using the control names, separated by commas (,) or semicolons (;). For example, if you want to ignore the ARIA controls ComboBoxes, Links, and ListBoxes at the same time, use the value combobox,link,listbox. Note that changing the value of this setting doesn't automatically update previously scanned controls and their respective IgnoriaAriaControls steering parameter.
Example	False

Ignore Aria controls

Description

Specify whether to ignore the role of all or only specific ARIA controls during the scan. This setting works as follows:

If set to False (default), XBrowser Engine 3.0 automatically adds the steering parameter IgnoriaAriaControls to XBrowser controls during the scan and sets it to False. This option lets you use ARIA attributes to identify and steer these controls, if available.
If set to True, XBrowser Engine 3.0 doesn't automatically add the steering parameter IgnoriaAriaControls to XBrowser controls during the scan. This option maximizes compatibility. If you encounter issues with XBrowser customizations, set to True.
If set to a specific control name, XBrowser Engine 3.0 automatically adds the steering parameter IgnoreAriaControls to XBrowser controls during the scan and sets it to the specific control. This option lets you specify the specific ARIA roles you want to ignore. To ignore multiple controls, configure the setting using the control names, separated by commas (,) or semicolons (;). For example, if you want to ignore the ARIA controls ComboBoxes, Links, and ListBoxes at the same time, use the value combobox,link,listbox.

Note that changing the value of this setting doesn't automatically update previously scanned controls and their respective IgnoriaAriaControls steering parameter.

Example

False

Ignore invisible HTML elements
Description	If you activate this setting, XScan for HTML pages adds the SteeringParameter "IgnoreInvisibleHtmlElements" to created Modules. The scan result will only contain the visible elements of the page. This improves scan and execution times if the tested HTML page contains a lot of invisible elements.
Example	False

Scrolling Behavior
Description	Defines the default scrolling behavior for the XBrowser Engine 3.0 and for HTML controls to be steered with the Mobile Engine 3.0. The following options are available: No Scrolling Scroll to top Scroll to center Scroll to bottom
Example	Scroll to center

Scrolling Behavior

Description

Defines the default scrolling behavior for the XBrowser Engine 3.0 and for HTML controls to be steered with the Mobile Engine 3.0.

The following options are available:

No Scrolling
Scroll to top
Scroll to center
Scroll to bottom

Example

Scroll to center

XBrowser->Browser Settings

Ajax tracer injection delay
Description	Controls how long Tosca delays the injection of the AjaxTracer into the webpage. The default value is 0. Increase the value if you encounter problems on your webpage while running tests. The time value is in milliseconds.
Example	500

Ajax tracer injection delay

Description

Controls how long Tosca delays the injection of the AjaxTracer into the webpage. The default value is 0. Increase the value if you encounter problems on your webpage while running tests.

The time value is in milliseconds.

Example

500

Close browser delay
Description	Specifies how long the browser extension waits before it closes the browser. If you run into trouble with your webpage during tests, increase the value. The default value is 100. The time value is in milliseconds.
Example	100

Close browser delay

Description

Specifies how long the browser extension waits before it closes the browser. If you run into trouble with your webpage during tests, increase the value. The default value is 100.

The time value is in milliseconds.

Example

100

Handle asynchronous loading
Description	Defines Tosca's wait behavior for busy pages that load content asynchronously: If set to Strict, Tosca always waits for the page to fully load, before steering it. If set to Loose, Tosca only waits for the initial loading time, before steering the page.
Example	Strict

Handle asynchronous loading

Description

Defines Tosca's wait behavior for busy pages that load content asynchronously:

If set to Strict, Tosca always waits for the page to fully load, before steering it.

If set to Loose, Tosca only waits for the initial loading time, before steering the page.

Example

Strict

Disable Ajax Tracer injection on pages
Description	Disables the AjaxTracer scripts on the specified webpage URLs. To specify the URLs, you need to add them as CollectionEntries. To add a CollectionEntry, right-click on Disable Ajax Tracer injection, click on Create... and select CollectionEntry. Use regular expressions to specify the URLs.
Example	.example-page\.com.

Disable Ajax Tracer injection on pages

Description

Disables the AjaxTracer scripts on the specified webpage URLs. To specify the URLs, you need to add them as CollectionEntries.

To add a CollectionEntry, right-click on Disable Ajax Tracer injection, click on Create... and select CollectionEntry. Use regular expressions to specify the URLs.

Example

.*example-page\.com.*

Disable Shadow Dom Unlocker injection on pages
Description	Disables ShadowDomUnlocker scripts on the specified webpage URLs. To specify the URLs, you need to add them as CollectionEntries. To add a CollectionEntry, right-click on Disable Shadow Dom Unlocker injection on pages, click on Create... and select CollectionEntry. Use regular expressions to specify the URLs. Note that this setting only applies to WebDriver.
Example	.example-page\.com.

Disable Shadow Dom Unlocker injection on pages

Description

Disables ShadowDomUnlocker scripts on the specified webpage URLs. To specify the URLs, you need to add them as CollectionEntries.

To add a CollectionEntry, right-click on Disable Shadow Dom Unlocker injection on pages, click on Create... and select CollectionEntry. Use regular expressions to specify the URLs.

Note that this setting only applies to WebDriver.

Example

.*example-page\.com.*

XBrowser->Internet Explorer->Ports

Server
Description	Defines which port is used for the Internet Explorer server.
Example	17009

XBrowser->Salesforce

Associated Labels Identification
Description	Enables the Salesforce Scan to use the AssociatedLabel property instead of ApiKey to identify Salesforce controls. By default, the setting is disabled. If set to True, you need to rescan existing Modules that don't have the AssociatedLabel property value.
Example	True

Associated Labels Identification

Description

Enables the Salesforce Scan to use the AssociatedLabel property instead of ApiKey to identify Salesforce controls.

By default, the setting is disabled. If set to True, you need to rescan existing Modules that don't have the AssociatedLabel property value.

Example

True

Custom Domain
Description	URL of the custom domain production or sandbox environment in Salesforce.
Example	login.example-page.com

Exclude frames
Description	Excludes the <frame> HTML elements when loading the HTML DOM structure in the Salesforce Engine.
Example	True

Exclude ShadowDoms
Description	Excludes the <shadowRoot> HTML elements when loading the HTML DOM structure in the Salesforce Engine.
Example	True

SFDCQuickSearch
Description	Enable manually this setting in the Salesforce Engine to find controls more quickly during scanning and test execution. The default value is True. However, if you encounter issues with control recognition, we recommend setting the value to False.
Example	True

Scanner include classic objects
Description	Displays objects defined in Salesforce Classic as tabs in the Salesforce Module.
Example	True

Scanner include lightning objects
Description	Displays objects defined in Salesforce Lightning Experience as tabs in the Salesforce Module if they're not defined in Salesforce Classic.
Example	True

SFDC CPQ
Description	Enables Tricentis Tosca to use adapters for CPQ automation. The following options are available for selection: True: Loading of CPQ dlls is enabled. False: Loading of CPQ dlls is disabled. Auto (default): Tricentis Tosca automatically identifies objects as CPQ or not.
Example	Auto

SFDC CPQ

Description

Enables Tricentis Tosca to use adapters for CPQ automation. The following options are available for selection:

True: Loading of CPQ dlls is enabled.
False: Loading of CPQ dlls is disabled.
Auto (default): Tricentis Tosca automatically identifies objects as CPQ or not.

Example

Auto

Skip ApiKey
Description	Skips the use of the ApiKey property to uniquely identify Salesforce controls. By default, this setting is disabled. If you enable this setting and don't find Salesforce controls during execution, we recommend that you enable the Associated Labels Identification setting to uniquely identify Salesforce controls.
Example	True

Skip ApiKey

Description

Skips the use of the ApiKey property to uniquely identify Salesforce controls.

By default, this setting is disabled. If you enable this setting and don't find Salesforce controls during execution, we recommend that you enable the Associated Labels Identification setting to uniquely identify Salesforce controls.

Example

True

URL based UI type identification
Description	Enables Salesforce Engine to identify the Salesforce interface (Classic, Lightning) of the Salesforce application that you scanned based on URL.
Example	True

XBrowser->Salesforce->Api

Consumer Key
Description	Client ID of the application trying to connect to Salesforce APIs.
Example	9578290mxur0ihf98c3n4y8mhfeuif

Consumer Secret
Description	Client secret for authentication.
Example	jxr843oum5t9xe4rc

Password
Description	Password to sign in to Salesforce.
Example	pass123

Username
Description	Username to sign in to Salesforce.
Example	mylogin@salesforce.uk

KeyVaultPath

Description

Path to the secret that you store in one of the supported key vaults.

To define the path, use the standard key vault path syntax, but without curly brackets.

Example

SECRET[cyberark][kv/database/production/pw][MyPassword][MyCyberarkAppID]

XBrowser->WebDriver

Chrome path to use
Description	Defines the path to the Chrome executable, which should be used by the WebDriver part of the XBrowser Engine 3.0. This setting is only available for local browser instances.
Example	C:\Program Files (x86)\Google\Chrome\Application\chrome.exe

Chrome WebDriver Path to use
Description	Specify a path to the WebDriver executable for Chrome. XScan uses this path if the parameter WebDriver Path in the Select Application window is empty.
Example	C:\Program Files (x86)\Google\Chrome\Application\chrome.exe

Chrome WebDriver Port for embedded application to use
Description	Specify a port of the WebDriver for Chrome. XScan uses this port if the parameter Debug Port in the Select Application window is empty.
Example	9222

Edge path to use
Description	Defines the path to the Edge Chromium executable, which should be used by the WebDriver part of the XBrowser Engine 3.0. This setting is only available for local browser instances.
Example	C:\Program Files (x86)\Google\Edge\Application\edge.exe

Edge WebDriver Path to use
Description	Specify a path to the WebDriver executable for Edge. XScan uses this path if the parameter WebDriver Path in the Select Application window is empty.
Example	C:\Program Files (x86)\Google\Edge\Application\edge.exe

Edge WebDriver Port for embedded application to use
Description	Specify a port of the WebDriver for Edge. XScan uses this port if the parameter Debug Port in the Select Application window is empty.
Example	9222

Firefox path to use
Description	Defines the path to the Firefox executable, which should be used by the WebDriver part of the XBrowser Engine 3.0. This setting is only available for local browser instances.
Example	C:\Program Files (x86)\Mozilla Firefox\firefox.exe

XBrowser->WebDriver->Cloud services->Browser Stack

Access Key
Description	Defines the access key of the BrowserStack account.
Example	CFkuSpEWajK2LM216Jmu

Hub Address
Description	Defines the hub address, which should be used for BrowserStack.
Example	http://hub.browserstack.com/wd/hub/

Username
Description	Defines the username of the Browser Stack account.
Example	myuser

XML->Ports

XSD server
Description	Defines which port is used for the XSD server.
Example	17005