...
| Code Block |
|---|
%INSTALLDIR%/jre/bin/java -DapiPort=10080 -DproxyPortStart=20443 -DproxyPortRange=10 -Ddebug=true -jar com.parasoft.traffic.proxy.jar |
| Info | ||
|---|---|---|
| ||
Parasoft Recorder The Smart API Test Generator ships with its own instance of Java, but you can use any Java 8 or later that is already installed on your system. |
Test Creation Properties
You can set determine how the recorder generates tests by defining properties in the tst_creation.properties configuration file to configure how the recorder generates tests. SOAtest and Parasoft Recorder both install an instance of the . The tst_creation.properties file. By default, the file installed by SOAtest is used. The SOAtest instance of the file is deployed to is located in the workspace under the TestAssets folder. All By default, all web proxies that connect to the SOAtest server will use the settings configured in this file.
The An instance of the tst_creation.properties file shipped also ships with the Parasoft Recorder is web proxy installed on a local machine. You can configure the settings in the local file to override settings configured in the tst_creation.properties file on the SOAtest server by setting the the useServerSettings property to false (see useServerSettings). If you want to use the local settings, make sure that the tst_creation.properties file is in the same directory as the com.parasoft.traffic.proxy.jar file so that it can automatically be read during test creation.
If the tst_creation.properties file is moved or deleted, all default settings will be applied.
| Scroll Table Layout | ||
|---|---|---|
|
| includeContentTypes | Defines a comma-separated list of content types to include during traffic processing. Default is application/json,application/x-www-form-urlencoded |
|---|---|
| excludeContentTypes | Defines a comma-separated list of content types to exclude during traffic processing. Default is empty. |
| disableDiffCreation | Enables/disables diff creation. See Diff for additional information. Default is |
| disableDiffParameterization | Enables/disables diff parameterization. Parameterization enables you to use data banked values in the diff. If diff parameterization is disabled (setting this property to true), only static values will be available. Default is false. |
| disableEnvironmentCreation | Enables/disables the creation of an environment and environment variables. Default is false. |
| disableDataBankCreation | Enables/disables data bank creation. See Data Exchange Tools for additional information. Default is |
| disableAssertorCreation | Enables/disables the creation of JSON Assertor tools. Default is false. See JSON Assertor for additional information. |
| diffToolIgnoreNames.<number> | Defines a regex matching element names that should be ignored when creating diffs. Default is You can specify additional name patterns by adding properties and appending them with For example:
|
| diffToolIgnoreValues.<number> | Defines a regex matching values that should be ignored when creating diffs. Default is to ignore timestamps:
You can specify additional value patterns by adding properties and appending them with |
...
For example:
| |||||||
| assertorToolIgnoreQueryParameterNames.<number> | Defines a regex matching query parameter names that should be ignored when creating JSON Assertor tools. Default is to ignore query names starting with "maxResultsSize":
The property is not case sensitive. You can specify additional patterns by adding properties and appending them with | ||||||
|---|---|---|---|---|---|---|---|
| assertorToolIgnoreQueryParameterValues.<number> | Defines a regex matching query parameters values that should be ignored when creating JSON Assertor tools. Ignore query parameters when creating assertions based on parameter value pattern Default is to ignore timestamps:
You can specify additional patterns by adding properties and appending them with | ||||||
| assertorToolIgnoreFieldNames.<number> | Defines a regex matching values in the response payload that should be ignored when creating JSON Assertor tools. Default value is to ignore values in response payload that starts with time, date, url, href, SessionId, or transactionId. Default is to ignore timestamps:
The property is not case sensitive. You can specify additional patterns by adding properties and appending them with | ||||||
| assertorToolIgnoreFieldValues.<number> | Defines a regex matching values that should be ignored when creating JSON Assertor tools. Default is to ignore timestamps:
You can specify additional value patterns by adding properties and appending them with For example:
| ||||||
| includeURLPatterns | Defines a comma-separated list of resource URL patterns to include for test generation. You can define case-sensitive patterns using Ant-style syntax. Default is to include all URLs. In the following example, all URLs in the parasoft.com domain will be included:
| ||||||
| excludeURLPatterns | Defines a comma-separated list of resource URL patterns to exclude from test generation. You can define case-sensitive patterns using Ant-style syntax. Default is to include all URLs. In the following example, all URLs at port 8443 in the parasoft.com domain will be excluded:
| ||||||
useServerSettings
| Enables/disables using the settings from the tst_creation.properties file on the SOAtest server, instead of the settings configured in the local tst_creation.properties file. Default is true. |
| Code Block | ||||
|---|---|---|---|---|
| ||||
includeContentTypes=application/json, application/x-www-form-urlencoded
excludeContentTypes=image/png,font/ttf,text/css,application/javascript
disableDiffCreation=false
disableDiffParameterization=false
disableEnvironmentCreation=false
disableDataBankCreation=false
disableAssertionCreation=true
# Ignore values that start with "time", "date", "url" or "href" in diff tool, case insensitive
diffToolIgnoreNames.1=(?i)^(time|date|url|href).*
# Ignore values that end with "time", "date", "url" or "href" in diff tool, case insensitive
diffToolIgnoreNames.2=(?i).*(time|date|url|href)$
# Ignore values like a timestamp in diff tool, e.g. 2018-03-21T07:00:00.000Z
diffToolIgnoreValues.1=[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}([.][0-9]{1,3})?(([+-][0-9]{2}:[0-9]{2})|Z)?
# Ignore query parameters when creating assertions based on parameter name pattern
assertorToolIgnoreQueryParameterNames.1=(?i)^(maxResultSize).*
# Ignore query parameters when creating assertions based on parameter value pattern
assertorToolIgnoreQueryParameterValues.1=[0-9]{4}-[0-9]{2}-[0-9]{2}T[0-9]{2}:[0-9]{2}:[0-9]{2}([.][0-9]{1,3})?(([+-][0-9]{2}:[0-9]{2})|Z)?
# Ignore fields in payload when creating assertions based on field name pattern
assertorToolIgnoreFieldNames.1=(?i)^(time|date|url|href|SessionId|transactionId).*
# Ignore fields in payload when creating assertions based on field value pattern
assertorToolIgnoreFieldValues.1=[0-9]\{4}-[0-9]\{2}-[0-9]\{2}T[0-9]\{2}:[0-9]\{2}:[0-9]\{2}([.][0-9]\{1,3})?(([+-][0-9]\{2}:[0-9]\{2})|Z)?
# Comma separated list of URL patterns where pattern matching is the same as Apache Ant. URLs can be case sensitive.
includeURLPatterns=http://{host}:8080/path/**/resources/*
excludeURLPatterns=https://{host}:8443/path/**/resources/*
|
Refer to Training the Smart API Test Generator for details about the test creation properties.
Using the API
After starting the web proxy, you can go to the following URL to review the API defintions:
http://<host>:<port>/api/openapi.json
Training the Smart Test Generator
See Training the Smart API Test Generator for information about teaching the Smart Test Generator how to create tests for your project.