Get to know your workspace
Your work environment in Tricentis Tosca is a so-called workspace. This workspace is made up of various sections in which you create, design, and run your tests.
Tricentis Tosca offers two types of workspaces:
Single-user workspaces for environments where only one person needs access to data.
Multi-user workspaces for environments where several people need access to the same data. In multi-user workspaces, a check in / check out mechanism ensures that users don't interfere with each others work (see chapter "Checkin and checkout objects").
For information on how to create workspaces, see the Admin section.
Tosca Commander is the user interface of Tricentis Tosca.
Start it from the Windows Start menu: Start->All Programs->Tricentis->Tosca->Tosca Commander.
You can only run Tosca Commander in single-view mode, that is one display on one desktop. You can mirror the screen to a second display or to a video projector, but other options such as dual-screen mode are not supported. The same applies for remote desktops.
To open a workspace, follow the steps below:
On the Tosca Commander start screen, click on Open.
Alternatively, press CTRL + O.
In the subsequent window, select a workspace and click Open.
By default, your workspaces are located at %TRICENTIS_PROJECTS%Tosca_Workspaces. Workspaces have the file extension .tws.
The next time you open Tosca Commander, you can just double-click on the workspace that you want to open in the Recent Projects list.
Open a workspace from the Recent Projects list on the Tosca Commander start screen
Open workspaces via command line
For information on how to open workspaces via command line, see chapter "Open a workspace via the command line".
Your workspace consists of various sections:
Sections in a workspace - properties pane expanded
The ribbon menu consists of the following menu types:
For more information on menus, see chapter "Tosca Commander menus".
For instance, the Execution tab contains all objects related to the execution of tests
The project tree shows the hierarchical structure of all objects in the tab that you selected.
In multi-user workspaces, a color block on the left of an object indicates whether a particular object is currently checked in or out.
This tab shows detailed information on the selected object. It is also where you enter information, for instance when you fill out your TestSteps.
The properties pane shows all properties of the selected object.
The pane is collapsed by default. To expand it, click on the button on the right side of the window. To collapse it, click .
The status bar shows the progress of the action that Tosca Commander currently performs as well as any additional information.
You can customize your workspace to your needs:
Collapse and expand elements or resize
You can collapse or expand elements by clicking the respective arrows.
You can also change the size of a pane by dragging its borders.
Collapse or expand elements
Close and reopen tabs
To close a tab that you don't need, hover over the tab and then click on the x.
To reopen a tab, go to Home->Section and select the tab from the drop-down list.
Change the order of tabs
You can change the order of tabs within the row of tabs. For instance if you want the first tab to be Modules rather than TestCases.
To do so, drag and drop the tab into the new position.
Create and arrange sections
You can change where Tosca Commander displays content:
Change where Tosca Commander displays the content of tabs. For instance if you want to see TestCases and Modules side by side rather than switching between tabs.
To do so, drag and drop the tab onto the desired position in the docking element.
Create new sections out of objects in the project tree. For instance if you want to have a separate window for a particular TestCase folder.
To do so, right-click the object in the project tree and select Open in new window from the mini toolbar. Then drag and drop the window onto the desired position in the docking element.
Drag and drop a window onto the desired position in the docking element
Save your customization
You can save your customized workspace view. This lets you restore your preferred view if you change any arrangements by accident.
To save your view, follow the steps below:
Go to View->Manage->Save...
In the subsequent Save Perspective window, enter a name for your view and click OK.
To restore a view, go to View->Select and select the preferred view from the drop-down list. If you want to go back to the Tosca Commander default view, select Default.
Open the project overview
You can open a view that shows all workspace sections and objects in the project tree.
To do so, go to Home->Project.
The top-level object in the project window is the project root element. You need this element if you - for instance - want to specify project options or settings.
For more information on the project root element, see chapter "Get to know the project root element".
Authenticate for Tosca Server
If you use Tosca Server with an HTTPS binding, you need to authenticate whenever you want to use a Tosca Server feature.
Click here for information on how to sign in.
To close a workspace, go to Project and click Close.
Tricentis Tosca then performs the following actions:
It closes the workspace and returns to the Tosca Commander start screen.
It automatically starts to compact the workspace.
To check the status of the compacting, hover over the icon in the Windows status bar.
To cancel the compacting, right-click the icon and click Cancel compacting.
Compacting workspaces reduces disk usage and improves performance.
By default, Tricentis Tosca always compacts workspaces when you close them. If you don't want this, disable the option Project->Options->General->Compact Workspace automatically.
You can also compact your workspace manually whenever you need. To do so, go to Project->Info and click Compact Workspace.