Create And Manage Workspaces In Tricentis TOSCA Automation Tool

By Sruthy

By Sruthy

Sruthy, with her 10+ years of experience, is a dynamic professional who seamlessly blends her creative soul with technical prowess. With a Technical Degree in Graphics Design and Communications and a Bachelor’s Degree in Electronics and Communication, she brings a unique combination of artistic flair…

Learn about our editorial policies.
Updated March 30, 2026

This tutorial explains how to create and manage TOSCA Workspaces. You will also learn about the Import, Export, and Checkout Process for TOSCA objects.

In this TOSCA Series For Beginners, we discussed the overview of the TOSCA automation tool, which was just the introduction to the tool, to help beginners get started with it in our previous tutorial.

In Tricentis Tosca, knowledge of how to effectively manage projects and collaborate is very important in the successful execution of test automation.

In this section, you will learn more about TOSCA Workspaces, the concept of checkout in version management, and collaborating with teams, as well as the import and export of TOSCA objects.

TOSCA Workspaces

Create And Manage Workspaces In Tricentis TOSCA Automation Tool

Types of Workspaces in Tricentis Tosca

There are mainly two types of workspaces in TOSCA.

  1. Single User Workspace
  2. Multi-User Workspace

Single User Workspace: Unrestricted access for one user, which means only one user/tester can use it. This is a sort of single license.

Multi-User Workspace: This type of access is for the test team members. As multiple users can use the workspace at a time, this type of workspace has the Checkout concept.

Now we will see how to create these workspaces.

How to Create and Manage a Workspace

Creation of a new Single User Workspace:

1. Launch TOSCA Commander

2. On the top menu, select “Workspace -> New”

Creation of New Single User Workspace

3. Select type “None (Creates single user workspace)” for the repository in a pop-up window.

4. Give it a path where the workspace project data will be stored.

5. Enter a preferred name for the new workspace.

6. Press the “Ok” button.

Enter a preferred name and click ok

7. Wait for the result.

8. Press the “Close” button.

Wait for the result and then click cancel

This is how the workspace is created. Now we will see how to open the created workspace.

Open an already created Workspace:

1. Launch TOSCA Commander.

2. On the top menu select “Workspace -> Open”.

Launch TOSCA Commander and click open

3. After that, select the workspace in which you have to work by following the path defined in the project i.e. (the path that was given while creating the workspace)

In the above example:

C:\Data\Documents\TOSCA\TOSCA_Workspaces\Test\test.tws (name of the workspace and the user has to be entered. Here “Test” is the workspace name and “test” is the username)

4. The workspace file extension is .tws. Select the workspace file (test.tws) and click on the “Open” button.

5. Enter the username and password to login to the respective workspace.

 workspace

Checkout Concept in TOSCA

The checkout concept applies only to multi-user workspaces where multiple users work in the same workspace simultaneously. There is a high possibility of data getting overwritten in this type because multiple users are involved.

So, to avoid overwriting data, i.e., created by other test experts/testers, all elements to be used and changed must be checked out first.

What Is Checkout in TOSCA?

Elements in the database (objects) can be changed or deleted only after checkout. When elements are checked out by one particular user, all other users can not change those checked-out elements.

Checkout

  • Checkout of a folder or a single element.

Checkout Tree

  • Checkout of a folder including all subfolders and all elements.
checkout tree

Update all

  • Changes of other users are updated.

Checkin all

  • Checkin of all new and checked-out elements.

Checkin Tree

  • Checkin of a folder including all subfolders and elements.
check in all

Checkout Status

Check out status is indicated by colored icons left of the element in the tree structure. Details are given in the image below.

Checkout Status
checkout status in tree

We explained the checkout concept above. Now, let us see the practical aspects of the concept.

How to Perform Check-in and Check-out in TOSCA

If you want to create a new folder in the existing folder structure, use the checkout command to checkout the existing folder where you need to create this new folder. In this case, only the new folder will be checked out. If you want to change or use other folders at the same level, then use the command Checkout Tree.

You can make all changes done in your workspace permanent in the main database by clicking the button or using the command Checkin all.

When you start your work in the morning, launch the TOSCA commander, open your workspace, the first thing to do is to click on the button Update all. By doing that, you will get all the work updated by others in your workspace.

It is very essential to get all the updates before you make any changes in your workspace. Your saved work will only be seen in every user’s workspace when you activate Checkin all and all others activate Update all.

Checkout

checkout

Checkout Tree

checkout tree

Checkin all (TOSCA provides Checkin all icon in the top menu bar)

Checkin all icon in top menu bar

Update all (TOSCA provides Update all icon in the top menu bar)

Update all icon in top menu bar

How to Perform Import and Export of TOSCA Objects

TOSCA provides import & export features, it helps to transfer data from one project to another. Data from a single user project can be copied to a multi-user project and vice-versa.

All objects in TOSCA Commander™ can be exported in subsets using the command Export Subset.

Subsets are XML files; these are actually compressed data files which are having file extension as .tce, if you want to call the objects from one project to another, TOSCA Commander™ automatically exports all the objects which are necessary to restore the selected objects in another project.

The import of a subset in TOSCA Commander™ is done through the context menu of the project root element. The import process does not overwrite any existing data. It always adds data to a separate folder in the project. Subsets allow unrestricted data transfer between the single user and multiuser projects. The use of subsets is possible for all user groups.

The import subset and export subset options are available either on the project root element or on a component folder. Just right click on the root folder or any component folder and in the context menu, you will find Export Subset and Import Subset options.

Export Subset and Import Subset options.

Conclusion

In this tutorial, we discussed the TOSCA workspace, the check-out concept, and some guidelines for using the checkout process. We also discussed import and export features in TOSCA.

We hope you got a good idea of how to create and manage workspaces in the TOSCA Automation Tool.

Check out our tutorials below for more Automation Tool guides.

PREV Tutorial | NEXT Tutorial

Was this helpful?

Thanks for your feedback!

READ MORE FROM THIS SERIES:



Leave a Comment