Tosca Connect

The Tosca Connect interface can be used 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.

The following Tosca components are required:

• Tricentis Tosca version 8.4 or higher

• Tosca REST API Service to access Tosca workspaces and share information

• Tosca Connect to connect to several third party systems.

  For further details on using a specific Tosca Connect version, please refer to one of the following chapters:

  • chapter "Using Tosca Connect Version 17.1 or above"

  • chapter "Using a Tosca Connect Version below 17.1 "

To download Tosca components, follow the steps below: go to the Support Portal download the respective version of the Tasktop Integration Hub (Tosca Connect) file. Please contact the responsible Tricentis sales expert for further details on licensing.

For detailed information regarding software versions and hardware requirements, please refer to the Tosca Server System Requirements as well as the Tricentis Tosca System Requirements.

Installing the Tosca REST API Service

The Tosca REST API Service is installed and configured by using the Tricentis Tosca Server (see chapter "Install Tricentis Tosca Server via InstallShield Wizard").

Configurations can be manually adjusted and completed in the Web.config file in the RESTApi directory.

Files and paths to be configured
Web.config
Path to your server directory Default path: C:\Program Files (x86)\TRICENTIS\Tosca Server\RESTApi

The Tricentis Tosca Server must be restarted via the IIS Manager each time the Web.config file is changed. Tricentis recommends defining a timeframe for the restart since all newly installed features will be restarted as well.

The following properties can be defined for the Tosca REST API Service:

• WorkspaceBasePath: path to the directory where all workspaces are stored, e.g. C:\Tosca_Projects\Tosca_Workspaces

• ExceptionLogPath (optional): path to the directory which includes log files and error descriptions regarding the access to REST Web services

• LogExceptions (optional): saves access logs in the defined ExceptionLogPath when set to True. By default, this property is disabled with the value False.

• AttachmentPath (optional): path to the directory where attachments should be stored temporarily

• APIInstanceCachingTime (optional): time in seconds until a TCAPI instance is closed. By default, this property is set to 60 seconds.

  This property is used when requests are sent to the REST API. The REST API uses the TCAPI for the request, which requires a license. The TCAPI is closed after the defined APIInstanceCachingTime so that the license will not be used anymore. For every subsequent request, the time count starts from 0 again.