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 |
-
Download the latest release for your Tricentis Tosca version (either 12.1 and below or 12.2 and above).
-
Unzip it in the root folder of the Tricentis Tosca installation directory (for example: C:\Program Files (x86)\TRICENTIS\Tosca Testsuite).
-
Unblock the following 3 DLL files by right clicking the DLL > Properties and tick Unblock
- TRICENTIS\Tosca Testsuite\TBox\NeoLoadTBoxAddOn.dll
- TRICENTIS\Tosca Testsuite\TBox\NeoloadTBoxProxy.dll
- TRICENTIS\Tosca Testsuite\ToscaCommander\NeoLoadToscaCommanderAddOn.dll
-
Relaunch the Tosca Commander.
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:
- NeoLoadApiPort: The port of the NeoLoad API, by default it is 7400.
- NeoLoadApiKey: The API Key specified in the NeoLoad project when identification is required. If no identification is required, 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.
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 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.
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.
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).
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:
- 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.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