Configuration

This section introduces the basic configuration of the testsuite-nocoding. In the first part, the xlt-nocoding specific properties are explained. In the second part, the test case mapping is introduced, where individual properties can be mapped onto individual test cases:

• Configure default settings
• Configure test specific settings

Like every other Test-Suite for XLT, the configuration is done in the properties files, which are usually located in <testsuite-folder>/config.

See XLT Framework Configuration if you are not familiar with that.

Configure default settings

In addition to the XLT properties, testsuite-nocoding expects some extra properties:

• Filename: com.xceptance.xlt.nocoding.filename
• Directory: com.xceptance.xlt.nocoding.directory
• Mode:com.xceptance.xlt.nocoding.mode
• Redirections: com.xceptance.xlt.nocoding.redirect
• Download-Threads:com.xceptance.xlt.staticContent.downloadThreads

Filename

• The filename is the name of the file with the test definitions.
• A filename must consist of the name for the test case and optionally the file-type, separated by a dot, for example: filename.fileformat. Internally, the xlt-nocoding library decides the parser with the specified file format. Therefore, if the file format is missing, it tries to add all known file formats to the filename.
• The filename property can also be a path.
• Examples: com.xceptance.xlt.nocoding.filename = torder.yml or com.xceptance.xlt.nocoding.filename = torder
• Default: The simple class name.

Note: If the file format is missing in the filename, xlt-nocoding adds all known file formats. First, it tries to add ".csv", then ".yml" and lastly ".yaml". The first of these files/URLs to exist, is then parsed. The ParserFactory class of the library is responsible for creating and supplying the parser, as well as mapping the extensions to a parser.

Directory

• The directory is the relative path, starting from the main project folder and points to the directory where the test definitions are stored.
• Default: com.xceptance.xlt.nocoding.directory = ./config/data

Note: Before the configured directory is checked, the file is looked for in classpath.

Mode

• The mode sets the running mode under which the test suite executes the requests. Possible values:
• dom : The responses are parsed into the DOM. This takes more time.
• light : No DOM exists and therefore this mode enables a fast execution of the test cases. However, if an XPath extraction is used, a temporary DOM is created.
• request : Only plain HTTP requests are sent and HTTP responses received, which makes this the fastest mode. Yet, this means that the following settings are ignored:
  • com.xceptance.xlt.javaScriptEnabled
  • com.xceptance.xlt.cssEnabled
  • com.xceptance.xlt.loadStaticContent
• Default: com.xceptance.xlt.nocoding.mode = light

Redirections

• This property expects one of the boolean values, true and false.
• If true, redirections, indicated through the status response code of the group 3xx, are handled automatically. This may be convenient but could be harmful if you need information of the original response and not of the redirected one.

TLS-Version

• This property defines the TLS version used by the web client.
• Possible values are TLSv1.2,TLSv1.1, ...
• Default: No TLS

Download-Threads

• This property expects an integer value.
• Uses as much threads as specified by the property when executing static requests.
• Default: com.xceptance.xlt.staticContent.downloadThreads = 4

Configure test specific settings

Since test cases may require different settings, it is possible to declare individual properties for each test case.

• Test case specific properties are declared as <TestCaseName>.property = value, where <TestCaseName> is the simple name of the test class.

Example:

# File  
TestCaseName.com.xceptance.xlt.nocoding.filename = testcasefile.yml

# Mode 
TestCaseName.com.xceptance.xlt.nocoding.mode = light

#TLS Version
TestCaseName.com.xceptance.xlt.nocoding.TLSVersion = TLSv1.1

The following is a list of properties, that can be configured for each test case specifically:

• Filename: com.xceptance.xlt.nocoding.filename
• Directory: com.xceptance.xlt.nocoding.directory
• Mode:com.xceptance.xlt.nocoding.mode
• Redirections: com.xceptance.xlt.nocoding.redirect
• Javascript:com.xceptance.xlt.javaScriptEnabled
• CSS: com.xceptance.xlt.cssEnabled
• Static Content: com.xceptance.xlt.loadStaticContent
• Password: com.xceptance.xlt.auth.userName
• Username: com.xceptance.xlt.auth.password
• Download-Threads:com.xceptance.xlt.staticContent.downloadThreads