In this section:
session.tag
This setting specifies a tag for signing results from the test session. The tag is a unique identifier for the specified analysis process made on a specified module. Reports for different test sessions should be marked with different session tags.
Acceptable Values
| [tag name] | A unique tag that identifies results from different sessions. |
|---|
Example Usage
The following configuration specifies the ut_linux tag:
session.tag=ut_linux
build.id
This setting 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.
Acceptable Values
| [id] | An id that is used to label results. The default is ${dtp_project}-yyyy-MM-dd. |
|---|
Example Usage
The default build ID includes the name of the project in DTP and the date of the build. For example, for the ATM project, the build ID included in the report may resemble the following: ATM2-2017-07-07.
The following configuration specifies the custom abc_project id:
build.id=abc_project
project.module
This setting specifies a custom name for the project's module. The setting may be used to describe unique runs. If unspecified, the tested module is detected automatically based on the analyzed code.
Acceptable Values
| [name] | A name of the project module. |
|---|
Example Usage
The following configuration specifies the custom XTests module name:
project.module=xTests
exec.env
This setting specifies a list of tags that describe the environment where the run was executed. Tags may describe the operating system (e.g., Windows, Linux), architecture (e.g., x86, x86_64), compiler, browser, etc. The exec.env tags enable the entire session to be described. A detailed description of the environment may also be included in the test suite, test, or test case levels via services API.
Acceptable Values
| [tag1;tag2...] | A list of tags that describe the execution environment separated with a semi-colon. |
|---|
Example Usage
The following configuration specifies three tags:
exec.env=Windows;x86;gcc_5_4
report.location
This setting specifies the directory where the report will be created.
Acceptable Values
| [path] | A path to the directory where the reports are created. |
|---|
Example Usage
The following configuration specifies the path to the new_reports directory:
report.location=C:\Users\user1\new_reports
report.format
This setting specifies the report format. Use a comma separated list of formats to reports in more than one format.
Acceptable Values
| xml | Default. Generates a report in the XML format. |
|---|---|
| html | Default. Generates a report in the HTML format. |
| Generates a report in the PDF format. | |
| csv | Generates a report in the CSV format. |
| custom | Generates a report in a custom format; see report.custom.extension and report.custom.xsl.file. |
Example Usage
The following configuration specifies the PDF report format:
report.format=pdf
report.custom.extension
This setting specifies the report file extension of the XSL file for a custom format. It requires the report.format option to be set to custom, as well as report.custom.xsl.file to be configured.
Acceptable Values
| [extension] | A custom extension of the XSL file. |
|---|
report.custom.xsl.file
This setting specifies the location of the XSL file for a custom format.
Acceptable Values
| [path] | A path to the XSL file. |
|---|
report.developer_errors
This setting specifies whether manager reports will include details about developer errors.
Acceptable Values
| true | Details about developer errors are included in the report. |
|---|---|
| false | Default. Details about developer errors are not included in the report. |
Example Usage
The following configuration enables including details about developer errors in the report:
report.developer_errors=true
report.developer_reports
This setting specifies whether the system generates detailed reports for all developers (in addition to the summary report for managers).
Acceptable Values
| true | Enables generating detailed reports for developers. |
|---|---|
| false | Default. Disables generating detailed reports for developers. |
Example Usage
The following configuration enables generating detailed reports for developers:
report.developer_reports=true
report.authors_details
This setting specifies whether the report includes an overview of the number and type of tasks assigned to each developer.
Acceptable Values
| true | Default. Reports include types and numbers of tasks assigned to each developer. |
|---|---|
| false | Reports do not include types and numbers of tasks assigned to each developer. |
Example Usage
The following configuration disables including details about numbers and types of tasks for each developer:
report.authors_details=false
report.contexts_details
This setting specifies whether the report includes an overview of the files that were checked or executed during analysis.
Acceptable Values
| true | Default. Reports include a list of files that were checked. |
|---|---|
| false | Reports do not include a list of files that were checked. |
Example Usage
The following configuration disables including a list of files that were checked.
report.contexts_details=false
report.suppressed_msgs
This setting specifies whether the report includes suppressed messages.
Acceptable Values
| true | Suppressed messages are included in the report. |
|---|---|
| false | Default. Suppressed messages are not included in the report. |
Example Usage
The following configuration enables including suppressed messages:
report.suppressed_msgs=true
report.metadata
This setting specifies whether additional metadata about findings should be downloaded from DTP. Only the findings that are already available on DTP are affected. The DTP server must also support the metadata service for this setting to take effect.
Acceptable Values
| true | Default. Metadata about findings are downloaded from DTP. |
|---|---|
| false | Metadata about findings are downloaded from DTP. |
Example Usage
The following configuration disables downloading additional metadata from DTP:
report.metadata=false
report.scontrol
This setting specifies if and how much additional information from source control is included in the report.
Acceptable Values
| off | Default. Information from source control is not included in the report. |
|---|---|
| min | The report includes information about repositories, file paths, and revisions. |
| full | The report includes information about repositories, file paths, and revisions, as well as task revisions and comments. |
Example Usage
The following configuration enables including information about repositories, file paths, and revisions in the report:
report.scontrol=min
report.associations
This setting enables or disables showing requirements, defects, tasks, and feature requests associated with a test in the report.
Acceptable Values
| true | Default. Requirements, tasks and feature requests are included in the report. |
|---|---|
| false | Requirements, tasks and feature requests are not included in the report. |
Example Usage
The following configuration disables showing requirements, tasks and feature requests in the report:
report.associations=false
issue.tracking.tags
This setting specifies a list of issue tracking tags.
Acceptable Values
| [tag] | A comma-separated list of tags. The following tags are supported by default: |
|---|
Example Usage
issue.tracking.tags=fr,high,task
report.assoc.url.[tag]
This setting generates a link to an association inside the HTML report. The URL is a query string containing an [%ID%] placeholder for the PropertyAttribute value.
Acceptable Values
| [URL] | The link to the association that will be included in the HTML report. |
|---|
report.active_rules
This setting specifies if the report contains a list of the rules that were enabled during analysis.
Acceptable Values
| true | Default. The list of active rules is included in the report. |
|---|---|
| false | The report does not include the list of active rules. |
Example Usage
The following configuration disables showing the rules that were enabled during analysis in the report:
report.active_rules=false
report.rules
This setting specifies a directory for storing static analysis rules HTML files (retrieved by clicking the Printable Docs button in the Test Configuration's Static Analysis tab).
Acceptable Values
| [URL] | The location where the HTML static analysis rule files are stored. |
|---|
Example Usage
Example 1:
report.rules=file:///C:/parasoft/gendoc/
Example 2:
report.rules=../gendoc/
report.test_params
This setting specifies whether the report includes test parameter details.
Acceptable Values
| true | Default. The parameter details are included in the report. |
|---|---|
| false | The parameter details are not included in the report. |
report.coverage.images
This setting specifies a set of tags that will be used to create coverage images in DTP. DTP supports up to 3 coverage images per report.
Acceptable Values
| [tag] | A comma-separated list of tags that will be used when coverage images are created in DTP. |
|---|
report.coverage.limit
This setting that specifies the lower coverage threshold. Coverage results lower than the specified value are highlighted in the report.
Acceptable Values
| [value] | A value that represents the lower coverage limit. The default value is |
|---|
Example Usage
The following configuration sets the lower coverage value to 50:
report.coverage.limit=50
report.metrics.attributes
report.archive
report.graph.start_date
report.graph.period
report.mail.enabled
report.mail.server
report.mail.port
report.mail.security
report.mail.subject
report.mail.username
report.mail.password
report.mail.realm
report.mail.domain
report.mail.time_delay
report.mail.from
report.mail.attachments
report.mail.compact
report.mail.format
report.mail.cc
report.mail.include
report.mail.exclude
report.mail.exclude.developers
report.mail.unknown
report.mail.on.error.only
report.setup.problems
report.setup.problems.category_limit
report.setup.problems.display_limit
report.setup.problems.console
report.ue_coverage_details_htmls
report.separate_vm.xmx
report.separate_vm
report.separate_vm.launch.file
dupcode.sorting.mode
report.coverage.version
report.dtp.publish
This setting determines whether the current installation of the product reports results of local analysis to the DTP server.
Acceptable Values
| true | The results are published to DTP. |
|---|---|
| false | Default. The results are not published to DTP. |
Example Usage
The following configuration enables sending local analysis results to DTP.
report.dtp.publish=true
Related
report.dtp.publish.src
This setting specifies whether the tested source code is published to the DTP server.
Acceptable Values
| off | Source code is not published to DTP. Default when the report.dtp.publish option is enabled. |
|---|---|
| min | The minimal part of the source code is published (in most cases, source code without reference to source control, for example, auto-generated code, is published. |
| full | All of the source code from the specified scope is published to DTP. Default when the report.dtp.publish option is enabled. |
Example Usage
The following configuration enables partial publishing of source code to DTP.
report.dtp.publish.src=min
