Navigate the Tosca XScan UI

This chapters contains detailed information on how to navigate the user interface of the Tosca XScan.

Select Application screen

To scan an application, select it in the Select Application screen of Tosca XScan and click Scan.

Alternatively, just double-click on the application window.

Tosca XScan automatically selects the engine with which it scans the application.

Select application window

Select engine to scan your application

To specify which engine Tosca XScan should use to scan your application, right-click on a window and select one from the list of available engines.

Blacklist an application

To blacklist an application, right-click on its window and select Blacklist Application. Tosca XScan ignores blacklisted applications and does not display them in the Select Application screen.

Blacklisted applications are listed in Settings->TBox->Recorder->Blacklisted processes. If you want a blacklisted application to be displayed in Tosca XScan again, remove it from the list.

Basic View

In Tosca XScan you change select between a Basic View, a Condensed View and an Advanced View.

Click on the Basic button in the Advanced View or Condensed View to switch to the Basic View in the Tosca XScan.

If you switch to the Basic View, the Select on Screen mode is automatically enabled. A click on individual controls in the test object selects or deselects them in the XScan window (see "Select controls in the test object").

Basic View in Tosca XScan

The Basic View tab contains the following options, depending on the technology used:

Option	Description
Finish Screen	Saves your scan results and Tosca XScan creates a new Module.
Scan Screen	Starts scanning the application window. A click on individual controls in the test object selects or deselects them in the XScan window.
Condensed	Opens the Condensed View of the Tosca XScan.
Advanced	Opens the Advanced View of the Tosca XScan.
Close	Closes the Tosca XScan. The scan results are saved and Tosca creates a new Module.

Condensed View

The Condensed View is a minimized view of the Tosca XScan and is displayed at the right side of your screen.

To close the Condensed View click on the Basic button.

Condensed View in Tosca XScan

If some of the controls that you have selected in your application are not uniquely identifiable, you can return to the Basic View to review the controls. To review the controls in the Basic View, click the Review Items button.

Review unidentified selected control

Advanced View

In the Advanced View you can select the controls to steer. The icons next to the controls indicate the identification criteria used. A click on these icons opens the according windows.

Click the Advanced button in the Basic View to switch to the Advanced View in Tosca XScan.

Advanced View in Tosca XScan

The Advanced View tab contains the following options, depending on the technology used:

Option	Description
Condensed	Opens the Condensed View of Tosca XScan.
Basic	Opens the Basic View of Tosca XScan.
Finish Screen	Saves your scan results and Tosca XScan creates a new Module.
Scan Screen	Starts scanning the application window. A click on individual controls in the test object selects or deselects them in the XScan window.
Highlight selection	Each time a control is selected in the tree view Tosca highlights it in red in the test object. You can also navigate in the tree view. To do so, use the arrow keys ↑↓ or double-click the control.
Select on Screen	A click on individual controls in the test object selects or deselects them in the XScan window (see "Select controls in the test object").
Identify by Properties	The Identify by Properties window is either hidden from view or shown. This window contains all the technical information and properties of the selected control (see chapter "Identification parameters"). The Load all Properties button allows all technical properties to be loaded for the selected control.
Identify by Anchor	The Identify by Anchor window is either hidden from view or shown. In this window you can transfer identification criteria from one control (source control) to another control (see also chapter "Identify controls by anchors").
Identify by Image	This window is either hidden from view or shown. You can define an image to be used for identifying controls (see "Identify controls by image: Image-Based Test Automation").
Identify by Index	This option shows or hides the Identify by Index window. If a selected control does not have a unique ID, you can select an index to be used upon test execution to identify the control. Enable the checkbox next to Index to select the index. The index is calculated dynamically and on the basis of already selected identification criteria.
Self-Healing Properties	The Self-Healing Properties button allows you to edit the self-healing properties that Tosca has preselected. For more information, see chapter "Modify your self-healing properties".
Filter	You can filter the controls to define which ones are shown in the XScan window. You can filter by Control Type, Visibility, and Region. Alternatively, you can use the Filtered items slider to filter controls. To keep the filter position between Tosca XScan and Tosca Rescan sessions, enable the setting Keep filter position between sessions in Settings->TBox->XScan.
Filter->Clear Filter	The Clear Filter button allows you to reset the filtered scan results view to the default view.
Filter->Region	You can limit the number of controls shown. To do so, follow the steps below: Click on New. The Filter by Region window opens. Use the cursor which takes the shape of a reticle to define the application area that you want to filter. Hold the left mouse button down. If you drag the cursor around, the area that you want to filter is defined by a rectangle and captured when you release the mouse button. Click OK to enable the filter.
Search	The Search window is either shown or hidden from view. In this window you can enter a string which occurs in the item name as a search filter.
Show/Hide Content Preview	The Content View window is either shown or hidden. This window shows contents of a selected control such as table contents, links, etc. Here you can define table headers and columns (see chapter "Scan tables").
Select new Application	Opens the Select Application window, where you can select a new application to scan.
Close	Closes Tosca XScan. The scan results are saved and Tosca creates a new Module.

Content View

The Content View window shows the content of a selected control.

To hide or show the Content View in Tosca XScan, click on Hide/Show Content Preview in the XScan menu.