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:
|
Download Binaries | See the latest release |
You can refer to the following table to find which version of this addon to use based on your Tosca version.
Tosca Version | NeoLoad Tosca Addon Version |
---|---|
2024.1.X and above | 2.8.X |
2023.1.X | 2.7.X |
16.0.X and below | 2.6.X |
Download and unzip the latest release.
Execute the Install-NeoLoadToscaAddon.bat
file to launch the installation wizard.
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.
Go to PROJECT > Options, to define the NeoLoad Add-on settings:
Parameters:
To access these values, go to the NeoLoad Preferences, then the Project settings tab, then select the REST API category.
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.
The NeoLoad Controller used to convert the Tosca SAP script must be 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 GUI 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.
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.
The NeoLoad Controller used to convert the Tosca SAP script must be 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 GUI and Web test case to NeoLoad NeoLoad starts the recording at the first step named "SAP" or "SAP Login", then both SAP GUI and Web are recorded, the recording is stopped at the end of the test case.
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.
(Tosca EUX is currently in beta and subject to change)
This integration allows Tosca to communicate with NeoLoads DataExchangeApi to send Tosca's TestStep and TestCase duration timings to NeoLoad during execution. This helps when analysis of the End User Experience (EUX) in NeoLoad is required.
Setup
In Tosca set the following test configuration parameters on ExecutionLists or ExecutionEntries which should be executed as part of your EUX test
Name | Value | Description |
---|---|---|
SendEndUserExperienceToNeoLoad | True/False | Whether the NeoLoad DataExchangeApi should be used to send End User Experience metrics to NeoLoad. |
NeoLoadApiHost | Default: localhost | (Optional) The hostname of the NeoLoad DataExchangeApi |
NeoLoadApiPort | Default: 7400 | (Optional) The port of the NeoLoad DataExchangeApi |
NeoLoadApiKey | Default: empty | (Optional) E.g. abcb6dcd-ea95-4a6a-9c64-80ff55ff778d |
Alternatively this can also be set as part of your TCShell script as shown in examples/RunToscaExecution.tcs
Hint: Set the repetition property on the ExecutionEntry to let one execution run repeatedly. This will increase the TPS as the workspace does not have to be reopened by the UserPath constantly.
Prepare your Tosca execution environment to allow executions via the command line
Create separate EUX User Path in Neoload and add an Executable Test Script Action to it which will trigger the execution of an Tosca Execution List or Entry
TCShell.exe
Example: \
TCShell -executionmode -workspace "C:\Tosca_Projects\Tosca_Workspaces\PathToYour\Workspace.tws" "${NL-CustomResources}\RunToscaExecution.tcs"
ToscaCIClient.exe
Trigger the load test in combination with your EUX User Path in NeoLoad. Only one instance of Tosca should be run per LoadGenerator.\
Hint: It is recommended to run the UEX UserPath by defining a iteration number or to set the Population Parameter Stop Policy to Indeterminate. This will allow last iteration to close Tosca workspace without locking it.
_The above example focuses on the execution via command line, Tosca test cases can alternatively be remotely executed via the Tosca Rest API_
Aditionally to the TestStep and TestCase durations timings the integration will collect browser performance timings similar to the NeoLoad Selenium EUX integration when automating web applications.
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\
Make sure NeoLoad is running, on same host specified by IP address (127.0.0.1 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.
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:
Version 2.8.0 (August 20, 2024):
Version 2.7.0 (September 20, 2023):
Version 2.6.1 (July 6, 2022):
Version 2.6.0 (December 16, 2021):
Version 2.5.1 (October 22, 2021):
Version 2.5.0 (August 3, 2021):
Version 2.4.0 (June 19, 2021):
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.
Version 2.1.0 (May 08, 2020): Make transactions when recording web test case.
Version 2.0.0 (April 27, 2020): Stabilization.
Version 1.0.0 (November 30, 2018): Initial release.