Configure Tosca XScan

You can customize the behavior of Tosca XScan by modifying its settings. To open the settings window, select Settings in the title bar.

Tosca XScan automatically saves your settings for the next scan.

General settings

In General settings, you can customize Tosca XScan settings that are relevant to all scans.

Setting

Description

Keep filter position

Saves the position of your Filtered items filter. That way, Tosca XScan remembers the level of detail for the controls it displays in future scans. It is not selected by default.

Create screenshot during scan

Automatically takes a screenshot of the application you're scanning. Tosca Cloud saves this screenshot to the module and displays it in the Image column. It is selected by default.

Ignore list

In this section, you can find all applications that you chose to ignore during the application selection screen.

To revert this, select Delete next to the desired application.

Unique application identifiers

The changes you make in this section of Tosca XScan only apply to the current scanning session. Tosca XScan doesn't save them for the next session. We'll add this functionality soon.

In this section, you can add the applications you intend to use to define your default IDs on application level.

For every application, specify the following:

  • Application name: enter a unique name to identify the application.

  • Application identifier: from the drop-down menu, select the property that defines this application.

  • Value: optionally, define a different value for the application identifier. To do so, enter a regular expression. This allows you to apply default IDs to a wider selection of pages.

During the scan, Tosca Cloud goes through all defined application identifiers until it finds the first one that matches the defined application identifier and value. Once it does, Tosca XScan assigns the application's default IDs to the scanned controls.

If you no longer need an application identifier, you can delete it by clicking on the icon. This removes all default IDs that are connected to this application. So the next time you scan the application, you need to manually select the additional properties that make a control unique.

Engine settings

In Engine settings, you can adjust settings that are relevant to the application that you scan. The technology behind your application determines which settings are available in Tosca XScan.

Setting

Description

Application

Ignore invisible elements

Automatically adds the IgnoreInvisibleHtmlElements steering parameter to the controls you select. That way, Tosca Cloud only displays and steers visible elements of the scanned page, which can improve performance for pages with multiple invisible elements. Note that you need to scan a new screen or restart Tosca XScan for this to take effect. It is not selected by default.

XBrowser

Ignore Aria controls

Automatically adds the AllowedAriaControls steering parameter to the controls you select. That way, Tosca Cloud ignores all or specific ARIA control elements of the scanned page, which can maximize compatibility in your tests. Note that you need to scan a new screen or restart Tosca XScan for this to take effect. By default, no Aria controls are ignored.

Tosca XScan supports the following ARIA roles (opens in new tab):

  • button

  • cell

  • checkbox

  • columnheader

  • combobox

  • grid

  • gridcell

  • link

  • listbox

  • menu

  • menubar

  • menuitem

  • menuitemcheckbox

  • menuitemradio

  • option

  • radio

  • row

  • rowheader

  • tab

  • table

  • tablelist

  • textbox

  • tree

  • treegrid, as a table tree control

  • treeitem

XBrowser

Enable slot content handling

Specifies whether to display controls as children of their assigned slot element (opens in new tab). You can choose one of the following values:

  • True, if you want controls to appear as children of their assigned slot. During scanning, Tosca Cloud automatically adds the steering parameter EnableSlotContentHandling with the value True to XBrowser controls.

  • False, if you want controls to appear as they are in the DOM structure. During scanning, Tosca Cloud automatically adds the steering parameter EnableSlotContentHandling with the value False to XBrowser controls. False is the default value.

XBrowser

Enable Xpath identification

Allows you to use XPath (opens in new tab) expressions to identify HTML elements in your application during test automation. This is a more precise way to locate elements, which lets you specify complex queries to target specific elements based on their attributes, hierarchy, or other characteristics. The default value is True.

XBrowser

Remote server connection timeout

Defines the time in milliseconds that Tosca Cloud waits for our server processes to establish an initial connection.

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

Remote server timeouts

Remote server response timeout

Defines the time in milliseconds that Tosca Cloud waits for a response from our server. The default value is 120000.

Remote server timeouts

DisableSecurityManager

Enables or disables the Java Security Manager used. You can choose one of the following values:

  • True disables the Java Security Manager.

  • False enables Java Security Manager.

  • Webstart Only disables the Java Security Manager for Webstart applications only. Webstart Only is the default value.

Java

StopAtThumb

Defines if steering should stop at Thumbs with no name while looking for child elements. You can choose one of the following values:

  • True, if you want the scan to stop when Tosca Cloud finds a control with type Thumb. True is the default value.

  • False, if you want the scan to continue when Tosca Cloud finds a control with type Thumb. In this case, Tosca Cloud continues searching for the next child item of the control.

UIA

Window class names

Defines which elements Tosca Cloud treats as windows. Enter one or more class names, separated by semicolon (;). The default value is Chrome_WidgetWin_1.

UIA

Ajax tracer injection delay

Defines the time in milliseconds that Tosca Cloud delays the injection of the AjaxTracer into the webpage. You can increase that value if you encounter problems on your webpage while running tests. The default value is 0.

XBrowser: Browser Settings

Frame id retrieval timeout

Specifies the maximum time in milliseconds that Tosca Cloud waits to retrieve a CrossDomainFrame ID before timing out. The default value is 100.

This is useful on slower machines or pages where scanning or steering content inside CrossDomainFrames may fail. As a result, the XScan might show an empty frame. In those cases, we recommend increasing the value of this setting to allow more time for the frame retrieval process.

XBrowser: Browser Settings

Handle asynchronous loading

Defines the wait behavior of Tosca Cloud for busy pages that load content asynchronously. You can choose one of the following values:

  • Strict if you want Tosca Cloud to always wait for the page to fully load before steering it. Strict is the default value.

  • Loose if you want Tosca Cloud to wait only for the initial loading time before steering the page.

XBrowser: Browser Settings

Disable Ajax Tracer injection on pages

Disables the AjaxTracer scripts on the specified webpage URLs. To specify the URLs, you need to add them as CollectionEntries. It is blank by default.

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

XBrowser: Browser Settings

Disable Shadow Dom Unlocker injection on pages

Disables ShadowDomUnlocker scripts on the specified webpage URLs. To specify the URLs, you need to add them as CollectionEntries. It is blank by default.

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

XBrowser: WebDriver

Exclude frames

Excludes the <frame> HTML elements when loading the HTML DOM structure in the Salesforcetest components. The default value is False.

Salesforce

Exclude Shadow Doms

Excludes the <shadowRoot> HTML elements when loading the HTML DOM structure in the Salesforcetest components. The default value is False.

Salesforce

Chrome path to use

Defines the path to the Chrome executable, which should be used by the WebDriver part ofTosca XScan. This setting is only available for local browser instances. For example: C:\Program Files (x86)\Google\Chrome\Application\chrome.exe. It is blank by default.

XBrowser: WebDriver

Chrome WebDriver Path to use

Specify a path to the WebDriver executable for Chrome. Tosca XScan uses this path if the parameter WebDriver Path in the Select Application window is empty. For example: C:\Program Files (x86)\Google\Chrome\Application\chrome.exe. It is blank by default.

XBrowser: WebDriver

Chrome WebDriver Port for embedded application to use

Specify a port of the WebDriver for Chrome. Tosca XScan uses this port if the parameter Debug Port in the Select Application window is empty. For example: 9222. It is blank by default.

XBrowser: WebDriver

Edge path to use

Defines the path to the Edge Chromium executable, which should be used by the WebDriver part ofTosca XScan. This setting is only available for local browser instances. For example: C:\Program Files (x86)\Microsoft\Edge\Application\edge.exe. It is blank by default.

XBrowser: WebDriver

Edge WebDriver path to use

Specify a path to the WebDriver executable for Edge. Tosca XScan uses this path if the parameter WebDriver Path in the Select Application window is empty. For example: C:\Program Files (x86)\Microsoft\Edge\Application\edge.exe. It is blank by default.

XBrowser: WebDriver

Edge WebDriver Port for embedded application to use

Specify a port of the WebDriver for Edge. Tosca XScan uses this port if the parameter Debug Port in the Select Application window is empty. For example: 9222. It is blank by default.

XBrowser: WebDriver

Firefox path to use

Defines the path to the Firefox executable, which should be used by the WebDriver part ofTosca XScan. This setting is only available for local browser instances. For example: C:\Program Files (x86)\Mozilla Firefox\firefox.exe. It is blank by default.

XBrowser: WebDriver

Access key

Defines the access key of the BrowserStack account. It is blank by default.

XBrowser: WebDriver:
BrowserStack

Hub Address

Defines the hub address, which should be used for BrowserStack. The default value is http://hub.browserstack.com/wd/hub/.

XBrowser: WebDriver:
BrowserStack

Username

Defines the username of the BrowserStack account. It is blank by default.

XBrowser: WebDriver:
BrowserStack