This page is maintained for older versions of Rapise only. The latest documentation can be found at: https://rapisedoc.inflectra.com
Convert Functional to Load Test

This aspect of the Rapise-NeoLoad integration describes the process for taking an existing test script written in Rapise and converting it seamlessly into a performance scenario in the NeoLoad load testing system. This feature allows you to convert Rapise tests for HTTP/HTTPS based applications into protocol-based NeoLoad scripts that can be executed by a large number of virtual users (VUs) that simulate a load on the application being tested.

 

Prerequisites

 

In order to use the integration with NeoLoad, you need to have the following:

·Rapise 5.0 or above

·NeoLoad 5.1 or above

Both tools must be installed on the same Windows host.
NeoLoad must have a license with Recording API enabled. The default trial version does not have this capability.
The Rapise test needs to be testing an application that uses HTTP/HTTPs or other NeoLoad supported protocols.

The Steps for Converting a Rapise Test

 

Launch NeoLoad

Open NeoLoad via the Start menu or using a command line:

"c:\Program Files (x86)\NeoLoad 5.1\bin\NeoLoadGUI.exe"

clip0045

Create or Open Existing Load Project

Use menu File > New or File > Open.

clip0046

Open a Test Script in Rapise to be Converted

Inside Rapise, open the script you want to convert. Make sure the application it is testing is a web-based application using the HTTP/HTTPS protocols:

clip0047

Ensure that the Internet Explorer HTML library is set in the test parameters.

clip0048

Open Conversion Dialog

On the Rapise Test Ribbon > Tools tab, press the �Convert to NeoLoad� button:

ribbon, test, tools

This will display the NeoLoad convertor dialog. On this dialog box, set the following parameters:

neoload-conversion-dialog

In this field, you need to enter the name of the virtual user to create in NeoLoad:

·The default value is "VirtualUser"

·If the name is already used, then it is automatically renamed using �_X� suffix, with X an integer incremented.

·If the name has invalid characters then they will be escaped as an underscore (_).

 

Base Container

 

This specifies the base container  where we want to start the recording (Init / Actions / End)

 

·The default value is Actions.

 

 

Container/Business Transaction

 

This is used to specify the current recording container in NeoLoad. It is just based on a single level. There is no way to specify a tree of containers.

·The default is no container.

·If the name is already used then it will be made unique by adding _1, _2, etc.

·If the name is empty then no container will be used.

 

Detect Dynamic Parameters

 

When you check this box, Rapise tells NeoLoad to scan the protocol traffic to look for known dynamic parameters (e.g. Session IDs, ASP.NET ViewState) that change on each HTTP request and need to be parameterized by NeoLoad to ensure the performance scripts are robust and well-defined (v.s. having a hardcoded Session ID).

 

In the NeoLoad tree it looks this way:

 

clip0051

Press Convert Button

After pressing Convert button Rapise will launch the test and NeoLoad will start capturing network traffic. When test playback is finished you�ll see the dialog:

clip0052

Troubleshooting

During conversion you may get a few error messages. This section provides a list of common messages and their solution.

Unable to connect to the remote server

clip0053

If you get this message, check that NeoLoad is running. Usually this message means that NeoLoad is not started or another application is using port 7400, preventing NeoLoad binding to it.

No project is open

clip0054

If you get this message, check that a project is opened in NeoLoad.

NeoLoad is not ready for recording

clip0055

If you get this message, it means that NeoLoad is in the recording state. To fix the issue, you need to stop the existing recording in NeoLoad.

NeoLoad Integration Settings

There are a few global options for the Rapise � NeoLoad integration. To reach them open up the Rapise Options ribbon:

ribbon-options-othertesting

In the 'Other Testing' tab, press the �NeoLoad Integration Settings�� button:

clip0057

This is the NeoLoad Settings dialog.
Normally there is no any reason to change these settings, but for completeness they are described below:

·NeoLoad Data Exchange URL - this is the URL to the NeoLoad data exchange API

·NeoLoad Proxy Address - this is the IP address and prt of the NeoLoad HTTP proxy

·NeoLoad REST Service URL - this is the URL to the NeoLoad recording service REST API