Skip to content
Switch branches/tags

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Tricentis Logo

NeoLoad Add-on for Tricentis Tosca


C# extension to integrate Tricentis Tosca with NeoLoad for SAP GUI and Web Script maintenance. It allows you to interact with the NeoLoad Design API to convert a Tricentis Tosca SAP GUI or Web script to a NeoLoad User Path or update an existing User Path.

Property Value
Maturity Stable
Author Neotys
License BSD 2-Clause "Simplified"
NeoLoad Licensing License FREE edition, or Enterprise edition, or Professional with Integration & Advanced Usage
Tested versions Tricentis Tosca versions:
  • 12.x (12.2, 12.3)
  • 13.x (13.0, 13.1, 13.2, 13.3, 13.4)
  • 14.x (14.1, 14.2)
NeoLoad versions from 6.6 to 7.10.
Download Binaries See the latest release

Setting up the NeoLoad Tricentis Tosca Add-on

  1. Download and unzip the latest release.

  2. Execute the Install-NeoLoadToscaAddon.bat file to launch the installation wizard.

  3. For more installation options, refer to the README.txt file you will find inside your downloaded release.

Warning: For SAP test case, you might need to launch both Tosca and SAP Logon as administrator in order to convert the Tosca Script to NeoLoad.

Global Configuration

Go to PROJECT > Options, to define the NeoLoad Add-on settings:



  • NeoLoadApiPort: The port of the NeoLoad API, by default it is 7400.
  • NeoLoadApiKey: The API Key specified in the NeoLoad General settings or in Project settings REST API. If no identification is required both in Project settings and in General settings, this parameter can be left blank.
  • NeoLoadApiHostname: The hostname of the machine that contains NeoLoad, by default it is localhost. It should be localhost for SAP GUI test case.
  • CreateTransactionBySapTCode: Enable/Disable the creation of transaction in NeoLoad for each SAP TCode.
  • Http2: Enable/Disable the recording of HTTP/2.

To access these values, go to the NeoLoad Preferences, then the Project settings tab, then select the REST API category.

Design API

When enterprise proxy is set

During any transfer from Tosca to NeoLoad, the enterprise proxy settings must be disabled so that NeoLoad can manage the system proxy temporarily to record the network traffic generated by the Tosca test. Before the transfer, go to windows proxy settings. Set "Automatically detect settings" and "Use setup script" to Off as shown below. After the transfer complete, reset the settings at their initial value.

Windows proxy seetings

How to convert a Tricentis Tosca SAP script to a NeoLoad User Path

The NeoLoad Controller used to convert the Tosca SAP script must be 32 bits and launched in process mode (service mode is not supported). More information about NeoLoad Prerequisites for SAP GUI on NeoLoad documentation.

In Tricentis Tosca, right click on an execution of a Test Case and then NeoLoad Add-on > Transfer SAP test case to NeoLoad NeoLoad starts the SAP recording at the first step named "SAP" or "SAP Login", and stops it at the end of the test case.


user path

How to convert a Tricentis Tosca Web or API script to a NeoLoad User Path

In Tricentis Tosca, right click on an execution of a Test Case and then NeoLoad Add-on > Transfer Web test case to NeoLoad NeoLoad starts the Web recording at the beginning of the test case, and stops it at the end.


User Path Update

During the execution of the Tricentis Tosca test case, if the NeoLoad User Path does not exist, it will be created. Otherwise, the existing User Path will be updated thanks to the User Path Update feature. The User Path Update feature merges the original User Path with a newer recording, copying variable extractors and variables. Below the SAP GUI User Path in NeoLoad.


From Tosca version 12.2, if execution errors are not displayed in Tosca Commander (Loginfo column displays "Stack empty."), check file neoload-add-on-error.txt located in your user profile directory (for example C:\Users<username>\neoload-add-on-error.txt).

Unable to connect to the remote server (No connection can be established to

Make sure NeoLoad is running, on same host specified by IP address ( for localhost), and make sure NeoLoad design API is listening on port specified (by default 7400).


You need a valid license with Integration & Advanced Usage.


NeoLoad is running, but there is no project open. Make sure to wait until project is fully loaded in NeoLoad before converting Tosca script.

NL-DESIGN-CANNOT-START-SAP-RECORDING (There is no active SAP connection)

The API call sent from the NeoLoad add-on to the NeoLoad Controller Design API was performed when there was no active SAP connection. Make sure there is an active SAP connection when the conversion starts. If needed, adjust name of test case actions to allow a delayed start. The add-on will trigger the "Start SAP recording" either on action pre-execution or post-execution, as coded here.


Different causes that can produce an NL-DESIGN-ILLEGAL-STATE-FOR-OPERATION:

  • A test is running.
  • NeoLoad is busy.
  • A recording is already in progress.
  • The post-recording wizard is still open or running.
  • No workbench instance found.
  • A recording is already stopping.
  • Recording is already paused.
  • Recording is not paused.
  • Not currently recording.


  • Version 2.4.0 (June 19, 2021):

    • Create a new transaction in NeoLoad from Tosca test step or folder for both Web and SAP GUI.
    • Tosca version below 12.2 is not supported anymore.
  • Version 2.3.0 (October 13, 2020): Add option to enable/disable HTTP2 during NeoLoad recording

  • Version 2.2.0 (July 15, 2020): API test recording.

    • Support API test case recording
    • Support of Tosca version 13.3
  • Version 2.1.0 (May 08, 2020): Make transactions when recording web test case.

    • Support of Tosca version 13.1 and 13.2
  • Version 2.0.0 (April 27, 2020): Stabilization.

    • Support of Tosca version 13.0
    • Support Web test case recording
    • Create a new transaction in NeoLoad at each SAP TCode encountered during the recoding. This feature is available since NeoLoad 7.3
    • Make installation procedure easier
  • Version 1.0.0 (November 30, 2018): Initial release.

    • July 24, 2019: Support of Tosca version 12.2