...

Enter GUI-specified and manually - specified settings into Parasoft DTP, which centralizes reporting and preference distribution across the team.
Configure and use different setting configurations for different projects.
Extend or override team-wide settings as needed (for example, for settings that involve local paths).
Adjust settings without having to open the GUI.
Share preferences across a team, as well as to apply different groups of settings to different projects and test runs.

session.tagname session tag used to label these results. The tag is an identifier of the module checked during the analysis process. Reports for different modules should be marked with different tags.

Default: ${config_name}

Setting	Purpose
`build.id`	Specifies a build identifier used to label results. It may be unique for each build but may also label more than one test sessions that were executed during a specified build. The maximum length for a build ID is 128 characters. Default: `${dtp_project}-${time:yyyy-MM-dd}`
`report.active_rules=true\|false`	Determines if the reports contain a list of the rules that were enabled for the test. Default: `false`
`report.archive=true\|false`	Enables the generation of an additional compressed archive (.zip) file in the specified report location. The ZIP file contains all the files generated to build the report. This option can generate an archive for any report format (for example, HTML, CSV, PDF, and so forth). By generating an archive, you can also perform custom transformations of the report because all of the elements are generated to the specified destination folder. Default: `false`
`report.associations=true\|false`	Specifies whether the report shows requirements, defects, tasks, and feature requests that are associated with a test. Default: `false`
`report.authors_details=true\|false`	Determines whether the report includes an overview of the number and type of tasks assigned to each team member. Default: `true`
`report.contexts_details=true\|false`	Determines whether the report includes an overview of the files that were checked or executed during testing. Default: `false`
`report.coverage.version=1\|2`	Specifies the version of the XML coverage report. Acceptable values are: `1 -` The basic (legacy) coverage report. `2 -` The optimized XML report. Default is `2`
`report.custom.extension` `report.custom.xsl.file`	Specifies the location and extension of the XSL file for a custom format. Used with `report.format=custom` For details and examples, seeConfiguring Reporting Settings.
`report.developer_errors=true\|false`	Determines whether manager reports include details about team member tasks. Default: `false`
`report.developer_reports=true\|false`	Determines whether the system generates detailed reports for all team members (in addition to a summary report for managers). Default: `true`
`report.format=html\|pdf\|sate\|xunit\|custom`	Specifies the report format. Available formats are HTML, PDF, SATE, XUnit, and custom. To generate multiple reports in different formats for a single run, enter a comma-separated list. If you have the "Command Line" license feature enabled, XML reports are generated and saved in addition to the report formats specified. For example: `report.format=html,pdf,xunit` Default: `html`
`report.mail.attachments=true\|false`	Determines whether reports are sent as attachments. All components are included as attachments; before you can view an HTML report with images, all attachments must be saved to the disk. Default: `false`
`report.mail.cc=[email_addresses]`	Specifies where to mail comprehensive manager reports. This setting must be followed by a semicolon-separated list of email addresses. This setting is typically used to send reports to managers or architects. It can also be used to send comprehensive reports to team members if such reports are not sent automatically.
`report.mail.compact=trends\|links`	Specifies that you want to email a compact report or link rather than a complete report. If `trends` is used, the email contains a trend graphs, summary tables, and other compact data; detailed data is not included. If `links` is used, the email contains only a link to a report (which is available on DTP)
`report.mail.domain=[domain]`	Specifies the mail domain used to send reports.
`report.mail.enabled=true\|false`	Determines whether reports are emailed to team members and to the additional recipients specified with the `cc` setting. Remember that each team member with assigned tasks will automatically be sent a report that contains only the assigned tasks. Default: `false`
`report.mail.exclude=[email_addresses]`	Specifies any email addresses you do not want to receive reports. This setting is used to prevent automated sending of reports to someone that worked on the code but should not be receiving reports.
`report.mail.exclude.developers=true\|false`	Specifies whether reports should be mailed to any team member whose email is not explicitly listed in the `report.mail.cc` property. This setting is used to prevent reports from being mailed to individual team members. Default: `false`
`report.mail.format=html\|ascii`	Specifies the email format. Available formats are HTML and ASCII. Default: `html`
`report.mail.from=[email_address OR user_name_of_the_same_domain]`	Specifies the "from" line of the emails sent. Default: `<global_user_name>`
`report.mail.include=[email_addresses]`	Specifies the email addresses of team members that you want to receive individual reports. This setting must be followed by a semicolon-separated list of email addresses. This setting is typically used to send individual reports to team members if such reports are not sent automatically (for example, because the team is not using a supported source control system). It overrides team members specified in the 'exclude' list.
`report.mail.on.error.only=true\|false`	Determines whether reports are sent to the manager only if a task is generated or a fatal exception occurs. Team member emails are not affected by this setting; individual emails are sent only to team members who are responsible for reported tasks. Default: `false`
`report.mail.port=[port]`	Specifies the mail server host’s port number. Default: `25`
`report.mail.security=[SL\| STARTTLS\| NONE]`	Specifies the desired security. Available settings are SSL, STARTTLS, NONE. SSL is not available in Visual Studio.
`report.mail.server=[server]`	Specifies the mail server used to send reports.
`report.mail.subject=My New Subject`	Specifies the subject line of the emails sent. The default subject line is `${tool_name} Report - ${config_name}`. For example, if you want to change the subject line to "SOAtest Report for Project A", you would use `report.mail.subject=SOAtest Report for Project A` Default: `${tool_name} Report - ${config_name}`
`report.mail.time_delay=[server]`	Specifies a time delay between emailing reports (to avoid bulk email restrictions). Default: `0`
`report.mail.unknown=[email_address OR user_name_of_the_same_domain]`	Specifies where to mail reports for errors assigned to "unknown".
`report.mail.username=[username] report.mail.password=[password] report.mail.realm=[realm]`	Specifies the settings for SMTP server authentication. The `realm` value is required only for those servers that authenticate using SASL realm.
`report.metrics_details=true\|false`	Determines whether an XML report with metrics summary information (as well as individual class and method detail data where applicable) is produced. This report will be generated only when a metrics-enabled Test Configuration is run. Metrics details will be shown in HTML and PDF reports. Default: `true`
`report.organize_security_findings_by=CWE\|OWASP2021`	Specifies whether API Security reports are sorted by CWE or OWASP 2021 Top 10. Default: `CWE`
`report.rules=[url_path_to_rules_directory]`	This setting specifies a path to the directory containing static analysis rules HTML files. Based on that path, links to rule documentation are added in HTML reports. The rules HTML files are provided by tools or can be generated by clicking Printable Docs in the Static tab of the Test Configuration. To apply this setting in the GUI, you need to define it in a .properties file and then provide a path to this file in the Option file field in the Report & Publish window. For more details, see Generating Reports. For example: `report.rules=file:///C:/Temp/Burt/parasoft/xtest/gendoc/` `report.rules=../gendoc/` `report.rules=file:///<TOOL_INSTALL>/rules/docs/` Default: none
`report.setup.problems=top\|bottom\|hidden`	Determines whether reports include a section about setup problems. `top` - Adds a "Setup Problems" section to the top of the report. This is the default. `hidden` - Prevents a "Setup Problems" section from being added. `bottom` - Adds a "Setup Problems" section to the bottom of the report. Default: `bottom`
`report.suppressed_msgs=true\|false`	Determines whether reports include suppressed messages. Default: `false`
`report.test_params=true\|false`	Determines whether reports include test parameter details. Default: `false`
`report.test_suites_only=true\|false`	Determines whether the Test Suite Summary report section only lists the .tst files (with this option enabled) or displays a tree-like view of the individual tests in each .tst file (with this option disabled). SOAtest only Default: `true`
`report.ue_coverage_details_htmls=[coverage_type]`	Determines whether a test's HTML report links to another report that includes source code annotated with line-by-line coverage details. The following values can be used for [coverage_type]: LC - for line coverage
`report.xml.param{n}.key=[`	`id]`	Specifies a
`tasks.source.control.details=true\|false`	This setting specifies if additional information from source control, such as revisions and comments, is included in the report.

DTP Settings

custom parameter ID to be added to the xml report root element. The ID must be unique. Both `report.xml.param{n}.key` and `report.xml.param{n}.value` (where `{n}` is the same number) must be specified for the custom parameter to be added. For example, the following configuration specifies that an attribute with the given key and value will be added to the xml report root element: `report.xml.param1.key=customId` `report.xml.param1.value=12345`
`report.xml.param{n}.value=[value]`	Specifies a custom parameter value to be added to the xml report root element. Both `report.xml.param{n}.key` and `report.xml.param{n}.value` (where `{n}` is the same number) must be specified for the custom parameter to be added. For example, the following configuration specifies that an attribute with the given key and value will be added to the xml report root element: `report.xml.param1.key=customId` `report.xml.param1.value=12345`
`session.tag=[name]`	Specifies a session tag used to label these results. The tag is an identifier of the module checked during the analysis process. Reports for different modules should be marked with different tags. Default: `${config_name}`
`tasks.source.control.details=true\|false`	This setting specifies if additional information from source control, such as revisions and comments, is included in the report.

DTP Settings

Setting	Purpose
`dtp.autoconfig=true\|false`	Enables auto-configuration using settings stored in DTP. This setting does not apply to the GUI and is ignored during import (see "-settings" or "-property" on the CLI Options page for more information about that process). Default: `false`
`dtp.enabled=true\|false`	Determines whether SOAtest or Virtualize is connected to DTP. Default: `false`
`dtp.url=[url]`	Specifies the URL for the DTP server. Remember to include the `https://` protocol; DTP does not support `http://` connections. If DTP is deployed to a location other than the root of the host server, the URL should include a context path (a relative path from the host name; for example: `https://server.company.com:8443/contextPath`). This may be the case if your organization uses a reverse proxy. Refer to the DTP documentation on https://docs.parasoft.com for additional information about reverse proxy server configuration and context path configuration
Setting	Purpose
`dtp.autoconfig=true\|false`	Enables auto-configuration using settings stored in DTP. This setting does not apply to the GUI and is ignored during import (see "-settings" or "-property" on the CLI Options page for more information about that process). Default: `false`
`dtp.enabled=true\|false`	Determines whether SOAtest or Virtualize is connected to DTP. Default: `false`
`dtp.url=[url]`	Specifies the URL for the DTP server. Include the protocol and host name or IP address and, if appropriate, the port number and context path.
`dtp.user=[username]`	Specifies the username for DTP user authentication.
`dtp.password=[password]`	Specifies the password for DTP user authentication. We strongly recommend encoding your password to ensure successful authentication and a secure connection. You can encode your password by running a command line instance of SOAtest with the `-encodepass` flag. The command line tool will generate an encoded string that you can use in the configuration file. See CLI Options for additional information.
`report.dtp.publish=true`	Enables/disables publishing test result data to DTP.
`dtp.project=[project_name]`	Specifies the name of the DTP project to which you want these results linked. If the project does not exist in DTP and the user specified in `dtp.user` has sufficient permissions to create projects, the project will be automatically created. For more details on general projects, see Connecting to DTP. Default: `Default Project`

...

Setting	Purpose
`soatest.license.use_network=true\|false`	Enables/disables network-based licenses. Set to `true` and configure either the License Server setting (`license.network.url`) or the Parasoft DTP Settings to use a network license. Set to `false` and configure the `soatest.license.local.password` setting to use a local license. Example: `soatest.license.use_network=true` Default: `true`
`license.network.url=[url]]`	Specifies the License Server URL. Remember to include the `https://` protocol; License Server does not support `http://` connections. If License Server is deployed to a location other than the root of the host server, the URL should include a context path (a relative path from the host name; for example: `https://server.company.com:8443/contextPath`). This may be the case if your organization uses a reverse proxy. Refer to the License Server documentation on https://docs.parasoft.com for additional information about reverse proxy server configuration and context path configuration. Specifies the License Server URL. Include the protocol and host name or IP address and, if appropriate, the port number and context path. Example: `https://10.9.1.63:8443`
`license.network.user=[username]`	Specifies the username for authentication on the secondary DTP server Licenses Server specified with the `license.network.url` option. This options option requires the `licenselicense.network.use.specified.server` and `license.network.auth.enabled` options to be set to `true`. Example: `license.network.user`=`JohnDoe`
`license.network.password=[password]`	Specifies the password for authentication on the secondary DTP server License Server specified with the `license.network.url` option. This option requires the `license.network.use.specified.server` and `license.network.auth.enabled` options to be set to `true` and and the the `license.network.user` to be configured. We strongly recommend encoding your password to ensure successful authentication and a secure connection. You can encode your password by running a command line instance of SOAtest with the `-encodepass` flag. The command line tool will generate an encoded string that you can use in the configuration file. See CLI Options for additional information.
`license.network.use.specified.server=true\|false`	This option enables SOAtest to connect to either DTP and License Server, or two instances of DTP simultaneously. Set to `false` if you want to retrieve a license from the DTP server specified with Parasoft DTP Settings. If set Set to `true`, SOAtest will if you want to retrieve a license from the server specified with the the `license.network.url` option.
`license.network.auth.enabled=true\|false`	Enables or disables authentication on the secondary DTP server License Server specified with the `license.network.url` option. This option requires the `license.network.use.specified.server` option to be set to `true`.
`soatest.license.network.edition=[edition_name]`	Specifies the type of license to retrieve from License Server. `[edition_name]` can be `server_edition`. To use a custom edition, do not set anything after the `"=";` simply leaving the value empty. Example: `soatest.license.network.edition=desktop_edition` `soatest.license.network.edition=server_edition` Default: `custom_edition`
`soatest.license.autoconf.timeout=[seconds]`	Specifies the maximum number of seconds to wait for the license to be automatically configured from License Server. Default: `20`
`soatest.license.local.password=[password]`	Specifies the local password provided to you by Parasoft.
`soatest.license.wait.for.tokens.time=[time in minutes]`	Specifies how long to wait for a license if a license is not currently available. Example: `soatest.license.wait.for.tokens.time=3.` Default: `0`

...

Setting	Purpose
`tasks.clear=true\|false`	Clears existing tasks upon startup in cli mode. This prevents excessive time being spent "loading existing results." Default: `true`
`console.verbosity.level=low\|normal\|high`	Specifies the verbosity level for the Console view. Available settings are: `low`: Configures the Console view to show errors and basic information about the current step’s name and status (done, failed, up to date). `normal`: Also shows command lines and issues reported during test and analysis. `high`: Also shows warnings. Default: `normal`
`soatest.custom.rules.dir=[directory]`	Indicates where user-defined rules are saved.
`soatest.custom.configs.dir=[directory]`	Indicates where user-defined Test Configurations are saved.
`exec.env=[env1; env2; ...]`	Specifies a list of tags that describe the environment where a test session was executed. Tags could describe an operating system (for example, Windows, Linux), an architecture (for example, x86, x86_64), a compiler, a browser, and so on. These tags describe a complete test session; more environment details could be also added at the test suite, test, or test case levels via the services API.
`issue.tracking.tags=[value]`	Specifies custom issue tracking tags. Multiple tags can be separated by a comma. For example: `issue.tracking.tags=@custom,@pr ,@fr` For more details, see Indicating Code and Test Correlations.
`misc.hide.masked.variables=true\|false`	Enables or disables hiding masked environment variables from outputs including displayed traffic, reports, and monitoring events. See Masking a Variable Value for more information about masking environment variables. Default: `false`
`parallel.mode=Manual\|Auto\|Disabled`	Determines which of the following modes is active: Auto: SOAtest controls parallel processing settings. Manual: Allows you to manually configure parallel processing settings to suit your specific needs. Disabled: Use only one of the available CPUs. For more details on this and other parallel processing options, see Configuring Parallel Processing. Default: `Auto`
`parallel.max_threads=<number>`	Specifies the maximum number of parallel threads that can be executed simultaneously. The actual number of parallel threads is determined based on the number of CPUs, available memory, and license settings. Default: [available_processors]
`parallel.free_memory_limit=<percentage>`	Specifies the amount of memory that should be kept free in low memory conditions (expressed as a percentage of the total memory available for the application). This is used to ensure that free memory is available for other processes. Default: `25`
`parallel.no_memory_limit=true\|false`	Indicates that you do not want to place any restrictions (beyond existing system limitations) on the available memory. Default: `false`
`usage.reporting.enabled=true\|false`	Enables or disables collecting anonymous usage information and sending it to Parasoft. Read our privacy statement to learn more at https://www.parasoft.com/privacy-policy. Default: `false`

Anchor
AddOptions
AddOptions
Additional Options for SOAtest and Virtualize

Setting	Purpose
`datasources.jdbc.classpath=[path1];[path2];[path3] ...`	Specifies the location of JDBC driver jar files and class folders. Special characters (spaces, slashes, colons, and so forth) must be escaped, for instance: %20 = SPACE %3A = : %5C = \ %7B = { %7D = } %24 = $ If listing multiple jars, use \n as a delimiter. For example, `C:\temp\withspace\${example}\jar.jar` becomes `C%3A%5Ctemp%5Cwith%20space%5C$2 4%7Bexample%7D%5Cjar.jar\n`
`scripting.jython.path`	Used to add a list of directories to search for python modules that are not already included with Jython. Multiple paths can be listed using the OS default path separator (";" for Windows and ":" for Linux and macOS).
`scripting.timeout.minutes`	Specifies the number of minutes after which the product will attempt to stop an unresponsive script and log an error message.
`system.properties.classpath=[path1];[path2];[path3] ...`	Specifies which jar files and class folders are in the classpath. For example: `system.properties.classpath=C\:\\myjars\\myLib1.jar;C\:\\myjars\\myLib2.jar`
`xml.conversion.data.model.directories`	Registers data models that specify how to convert fixed-length data to and from XML. Enter a semicolon-separated list of directories that contain the appropriate data models.
`browsertesting.chrome_executable_path`	Specifies the path to the Chrome executable.
`browsertesting.firefox_executable_path=[path]`	Specifies the path to the Firefox executable.
`browsertesting.proxy_port=[port]`	Specifies the proxy port. See Proxy Configuration Details for more information and tips.
`browsertesting.browser_communication_port=[port]`	Specifies the browser communication port.
`browsertesting.startup_timeout=[seconds]`	Specifies the length of delay (in seconds) after which SOAtest should stop waiting for browser startup and consider it to be "timed out."
`browsertesting.user_action_timeout=[seconds]`	Specifies the length of delay (in seconds) after which SOAtest should stop waiting for a user action and consider it to be "timed out."
`browsertesting.page_load_timeout=[seconds]`	Specifies the default length of delay (in seconds) after which SOAtest should stop waiting for a page to load and consider it to be "timed out."
`browsertest-` `ing.asynchronous_request_timeout=[seconds]`	Specifies the default length of delay (in seconds) after which SOAtest should stop waiting for an asynchronous request and consider it to be "timed out."
`browsertesting.element_timeout=[seconds]`	Specifies the default length of delay (in seconds) after which SOAtest should stop waiting for an element and consider it to be "timed out."
`browsertesting.dialog_timeout=[seconds]`	Specifies the default length of delay (in seconds) after which SOAtest should stop waiting for a dialog to open and consider it to be "timed out."
`browsertesting.http_traffic_timeout=[seconds]`	Specifies the default length of delay (in seconds) after which SOAtest should stop waiting for traffic to complete loading and consider it to be "timed out."
`browsertesting.print_debug_info=true\|false`	During recording of a browser functional test scenario, it is possible that an action taken is not recorded by SOAtest. Enabling this option will allow messages to be printed to the console during recording, with information about what events SOAtest handled, any locators that may have been generated, and if applicable, any exceptions that took place during recording.
`browsertest-` `ing.allowable_binary_extensions=[extensions]`	Allows binary files with the specified extensions to be used in the Traffic Viewer and output. By default, only text files will be allowed. Extension lists are comma-separated.
`browsertest-` `ing.allowable_binary_mimetypes=[mime_types]`	Allows binary files with the specified MIME types to be used in the Traffic Viewer and output. By default, only text files will be allowed. MIME type lists are comma-separated.
`browsertesting.content_fetch_mode=all.con-tent\|non.hidden.iframes`	Enables you to determine whether the contents of hidden frames are displayed in the pre- and post-action HTML viewer.
`security.trust.all.certificates`	Indicates that you want to accept any certificate. This is useful if you want to load pages whose certificates are not "trusted."
`security.use.default.java.cacerts`	Indicates that you want to accept only certificates from the standard list of Java trusted certificate vendors.

...

Setting	Purpose
`parasoft.broker.default.use.jms`	The Virtualize server publishes events and statistics through WebSockets by default. To restore the legacy behavior and publish them through the legacy JMS provider (Parasoft Builtin Provider), set this value to `true`. Default is `false`.
`server.startup`	Determines whether the server is automatically started upon Virtualize startup.
`server.port.http`	Specifies the port that the Virtualize Server uses for HTTP.
`server.port.https`	Specifies the port that the Virtualize Server uses for HTTPS.
`server.port.monitoring`	Specifies the port that the Virtualize Server uses for monitoring.
`traffic.wizard.xpath.ignores`	Exclusions are specified in the format: `traffic.wizard.xpath.ignores=[element name 1]:[value pattern 1];[element name 2]:[value pattern 2];[element name 3]:[value pattern 3]` For example, `traffic.wizard.xpath.ignores=*:[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)?;uuid:[a-fA-F0-9]{8}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{4}-[a-fA-F0-9]{12}` Note that when the backslash character (\) is used in the regular expression, it needs to be escaped. For example, the regex [\d], which represents a single digit, would be entered as [\\d].

...

Code Block

# REPORTS
 
#Determines whether reports are emailed to developers and to the additional recipients specified with the cc setting.
#Remember that if the team is using CVS for source control and each developer's email address matches his or her CVS username + the mail domain, each developer that worked on project code will automatically be sent a report that contains only the errors/results related to his or her work.

report.mail.enabled=true
 
#Exclude developers emails (true/false) 
report.mail.exclude.developers=false
 
# Append developers errors to manager emails (true/false) 
report.developer_errors=true
 
# Send reports to developers (true|false) 
report.developer_reports=true
 
# Append suppressed messages (true|false) 
report.suppressed_msgs=false
 
#Determines where to mail complete test reports.
#This setting is typically used to send reports to managers or architects.
#It can also be used to send reports to developers if developer reports
#are not sent automatically (for example, because the team is not using CVS). 
[email protected]; ${env_var:USERNAME} @domain.com
 
# mail target for unknown developer errors 
[email protected]
 
#Specifies the mail server used to send reports. 
report.mail.server=mail_server.domain.com
 
#Specifies the mail domain used to send reports. 
report.mail.domain=domain.com
 
#Specify mali from 
report.mail.from=nightly
 
#Specifies any email addresses you do not want to receive reports.
#This setting is used to prevent from automatically sending reports to someone that worked on the code, but should not be receiving reports. This setting is only applicable if the team is using CVS for source control and developer reports are being sent automatically.
report.mail.exclude=developer1;developer2
 
# Specifies the subject line of the emails sent.
report.mail.subject= ${tool_name} Report - ${config_name}
 
# Report test params include (true|false) 
report.test_params=true
 
# SCOPE
 
#code authorship based on CVS 
scope.sourcecontrol=true
 
#code authorship based on author tag 
scope.author=false
 
#code authorship based on local user 
scope.local=false
 
# LICENSE
 
#override license settings
#soatest.license.autoconf.timeout=40
soatest.license.use_network=true
soatest.license.network.url=httphttps://license_server.domain.com:22228443
soatest.license.network.edition=server_edition
 
# SOURCE CONTROL
 
scontrol.rep1.type=cvs
scontrol.rep1.cvs.root=:pserver:developer@cvs_server.domain.com:/home/cvs/scontrol.rep1.cvs.pass=mypassword

Page tree

Versions Compared

Old Version 1

New Version 2

Key

DTP Settings

DTP Settings

Anchor
AddOptions
AddOptions
Additional Options for SOAtest and Virtualize

Page tree

Page History

Versions Compared

Old Version 1

New Version 2

Key

DTP Settings

DTP Settings

AnchorAddOptionsAddOptionsAdditional Options for SOAtest and Virtualize

Anchor
AddOptions
AddOptions
Additional Options for SOAtest and Virtualize