Tosca Connect

Use the Tosca Connect interface to synchronize information on errors and requirements between Tosca and third party systems. The Tosca Connect interface uses the Tasktop tool to assign and update information.

Prerequisites

To use the Tosca Connect interface, you must have the following Tosca components installed:

For information on software versions and hardware requirements, refer to the Tosca Server system requirements and the Tricentis Tosca system requirements.

Licensing

Tosca Connect requires a license once a repository is integrated with Tasktop. That is true even if it is not actively running or used anymore.

For detailed information on licensing, contact Tricentis Sales.

Download Tosca Connect

To download Tosca Connect, follow the steps below:

  1. Go to the Support Portal.

  2. Download your required version of the Tasktop Integration Hub (Tosca Connect) file.

  3. Double-click the MSI file to start the installation.

Install Tosca REST API Service

You install and configure Tosca REST API Service with Tricentis Tosca Server. For detailed information on how to do so, see chapter "Install Tosca Server via setup dialog".

Configure Tosca REST API Service

To manually adjust and complete the configurations, use the appsettings.json file located at C:\Program Files (x86)\TRICENTIS\Tosca Server\RESTApiService.

You must restart the service in the Windows Services app each time you change the file.

You can specify the following properties for the Tosca REST API Service:

 

Property

Description

Optional

WorkspaceBasePath

Path to the directory where all workspaces are stored.

Example: C:\Tosca_Projects\Tosca_Workspaces

ExceptionLogPath

Path to the directory which includes log files and error descriptions regarding the access to REST Web services.

X

LogExceptions

Saves access logs in the ExceptionLogPath that you specify. To do so, set the value to True.

The default value of this property is False.

X

AttachmentPath

Path to the directory where you want to store attachments temporarily.

X

APIInstanceCachingTime

Time in seconds until a TC API instance is closed.

The default value is 60 seconds.

When requests are sent to the REST API, it uses the TC API which requires a license. The TC API is closed after the defined APIInstanceCachingTime so that the license is not used anymore. For every subsequent request, the time count starts from 0 again.

X

Next steps

For information on how to use a specific Tosca Connect version, refer to one of the following chapters: