Test Data Service

Test Data Service is a web-based application that enables you to manage your test data in distributed environments.

Installation

The installation of Tricentis Test Data Service is part of the Tricentis Tosca Server installation.

For information on supported browser versions and hardware requirements, see the system requirements.

Configure size limits for Test Data Service requests

The default maximum request size value is 31457280 bytes (~30MB). Tosca Server returns a 500 error for any request that's bigger than this.

If you want to import a larger amount of data into Test Data Service, change the maximum request size limit. To do so, follow these steps:

1. Open the appsettings.json located at C:\Program Files (x86)\TRICENTIS\Tosca Server\TestDataService.

2. In the MaxRequestBodySize section, choose one of the following options:

   • Enter a higher value in bytes.

   • Enter null to set the maximum possible value. This is usually about 2GB, but varies based on the operating system.

3. Save and close the file.

4. Restart Test Data Service from the Windows Services app.

If you follow these steps, and Tosca Server still disregards your data import request, we recommend that you split your file into smaller ones.

Authenticate and authorize your Test Data Service TestCases

If you use Tosca Server with an HTTPS binding, Tosca Server only accepts authenticated requests. This means you have to add authentication to your Test Data Service TestCases.

And if an administrator has enabled authorization for your repository, you also need to authorize your TestCases.

To do so, follow these steps:

5. Create an API access token in Tricentis User Administration.

6. In Tosca Commander, create a test configuration parameter (TCP) called AuthenticationAccessKey.

7. Paste the value of the personal access token into the Value field of the TCP.

8. Go to Settings->Tricentis Services->ServerEndpointAddress and enter the endpoint of the Tosca Gateway Service.

   Alternatively, you can create a TCP called ServiceDiscovery and enter the Tosca Gateway Service endpoint into its Value field.

9. This enables authentication. To complete the authorization process for your TestCases, perform the following actions:

   • Open Tricentis Service Configuration.

   • Go to the Test Data Service tab and select Enable Authorization in the Advanced section.

All Test Data Service TestCases that use the TCP AuthenticationAccessKey are authenticated and authorized without further user interaction.

Access the Test Data Service API documentation

To access the Test Data Service API documentation, use the following URL: http://<server address>:<port>/testdataservice/swagger/index.html.

• Replace <server address> with the address of Tosca Gateway Service.

• Replace <port> with the Tosca Gateway Service port.

For example, http://localhost:80/testdataservice/swagger/index.html.

Note that if you use the Tosca Server with an HTTPS binding, you need to access the Test Data Service API documentation from the Tosca Server machine. To do so, use the following URL: http://localhost:<port>/testdataservice/swagger/index.html.

• Replace <port> with the Test Data Service port.

For example, http://localhost:5001/testdataservice/swagger/index.html.

By default, the documentation opens on version v2. To switch to another version, select the respective version from the Select a definition drop-down menu.