Changed functionality

This chapter explains changed functionality of Tricentis Tosca 15.2 LTS, compared to version 15.1 STS.

TBox Convert Decimal Module

The Module TBox Convert Decimal supports thousands separators in the result. Resulting values now carry over the separator after the decimal conversion. Moreover, the Module preserves the number of decimal digits.

If you designed your tests to work with the previous version's limitations, you might need to adapt them.

Mobile Engine 3.0: Appium Server and Tosca Mobile Assistant installation

As of Tricentis Tosca 14.2 LTS Patch 1 and Tricentis Tosca 14.3 STS, the Appium Server and Tosca Mobile Assistant are no longer part of the Tricentis Tosca installation. Not having these components can affect the way you work with the Mobile Engine 3.0:

  • Appium Server is a mandatory component if you want to run a local Appium Server and automate locally connected devices.

  • Tosca Mobile Assistant is an optional component that allows the Mobile Scan to automatically display locally connected devices and applications installed on them.

The upgrade procedure depends on your previous Tricentis Tosca installation:

Situation

Procedure

You upgrade from Tricentis Tosca 14.2 LTS or earlier versions.

You have to install the Appium Server and Tosca Mobile Assistant manually.

To do so, follow the steps described in chapter "Install the Mobile Engine 3.0".

You upgrade from Tricentis Tosca 14.2 LTS Patch 1. You have already installed the Appium Server and Tosca Mobile Assistant manually for this version. You haven't deleted the Tosca Testsuite installation folder.

After you upgrade to Tricentis Tosca 14.3 STS, the Appium Server and Tosca Mobile Assistant are already in the %TBOX_HOME% folder.

You don't have to install them again.

You upgrade from Tricentis Tosca 14.2 LTS Patch 1. You haven't installed the Appium Server and Tosca Mobile Assistant for this version yet or you have deleted the Tosca Testsuite installation folder.

You have to install the Appium Server and Tosca Mobile Assistant manually.

To do so, follow the steps described in chapter "Install the Mobile Engine 3.0".

Mobile Engine 3.0: Appium Server and Desired Capabilities

Tricentis Tosca 15.2 LTS supports Appium version 2.0. If you use Desired Capabilities with the Appium server, you need to adjust these capabilities in the respective Modules or in the Appium Server custom configuration file. To do so, add the Appium prefix to each Desired Capability: appium:<Desired Capability>.

Mobile Engine 3.0: Supported online clouds

Tricentis Tosca 15.2 LTS doesn't support the clouds Experitest and GigaFox. If you access your device, emulator, or simulator by using one of them, you need to adjust your configurations.

Tosca Commander settings

As of Tricentis Tosca 15.2 LTS, some settings have been moved to new locations:

You might lose stored values after the upgrade. In this case, refer to the %TRICENTIS_ALLUSERS_APPDATA%\Settings\XML\Settings.xml file to retrieve any previously used values.

Tosca Continuous Integration with Tosca Distributed Execution

The behavior of the Tosca CI Client setting CiClientTimeout has changed.

If the Tosca CI Client doesn't get a response within the specified time frame, it doesn't abort the execution anymore. Instead, the Tosca CI Client leaves the TestEvent in the queue until you cancel it in the Tosca Distributed Execution Monitor.

Tosca Commander: update of environment variable

The environment variable %TRICENTIS_HOME% now points to C:\Program Files (x86)\TRICENTIS\Tosca Testsuite\Settings. If you use this variable in your tests, you need to update them.

Tosca Distributed Execution

If you use Tosca Server with an HTTPS binding, Tosca Server now only allows authenticated requests. This means that users need to authenticate with Tricentis User Administration credentials whenever they perform an action that involves Tosca Server. Tosca Server checks whether a user with these credentials exists; if that's true, it proceeds with the task. Click here for more information on authentication via Tricentis User Administration.

In a Tosca Distributed Execution context, authentication means the following:

  • After the upgrade, users need to authenticate whenever they, for instance, trigger the execution of a TestEvent or want to access the DEX Monitor.

  • Your Tosca Distribution Agents also need to authenticate. You have to create at least one user in Tricentis User Administration for your Agents; you can use the same account for multiple Agents. This user has to have a personal access token in Tricentis User Administration. You need the token's client ID and client secret when you start and connect your Agents after the upgrade.

Last, but not least: Tosca Distributed Execution with AOS is now the default setup. If you want to use Tosca Distributed Execution without AOS, you need to deactivate AOS after the upgrade.

Data Integrity: new environment variable

The Data Integrity environment variable has changed from $ToscaDataIntegrity_Home to the new variable %TRICENTIS_DI_HOME%. If you use this variable in your tests, you need to update them.

Tricentis File Service

Tricentis Tosca 15.2 makes it easier to use Tricentis File Service. It's now automatically enabled for every new project that you add to the Tosca Administration Console. Additionally, it includes auto-removal functionality that removes execution log data from the Tricentis File Service file system after a certain period of time. This helps you to manage your file system size without any manual intervention.

Tricentis Tosca 15.2 includes new auto-removal settings in the File Service tab of the Tricentis Service Configuration. By default, these settings are active. However, this doesn't necessarily mean that auto-removal is turned on for a specific project. To verify that auto-removal is off, check the project in the Tosca Administration Console. If the File Service column says Auto-removal disabled, auto-removal is turned off.

You don't want to use Tricentis File Service at all? As of Tosca 15.2, you can also disable it.

Deprecated features in 15.2 LTS

API Engine 3.0 scripting feature

Tricentis no longer offers scripting (HMAC support) as part of the API Early Access features for the API Engine 3.0.

Tosca Distributed Execution with AOS: no more results folders

Tosca Distributed Execution with AOS no longer supports results folders. Instead, Tosca now saves the results of your test runs directly to the ExecutionLists.

Tosca doesn't delete existing results folders, so you still have access to your old results. However, any test that you run after the upgrade ignores existing results folders and writes the results to your ExecutionLists.