In this section:
You can send test results analyzed by Selenic to Parasoft DTP, which aggregates, processes, and generates visualizations of the data. DTP applies advanced development and test analytics to the data it collects so that development managers and project members can assess the state of their software. See Viewing Results in DTP for information on viewing the data sent to DTP.
Run the selenic_analyzer.jar from the command line to send test results to DTP (see Command Line).
A connection to DTP must be configured in the selenic.properties file (see Licensing) to send data to DTP. If you use a network license served from DTP, Selenic will report test results to the same instance of DTP you connect to in order to retrieve a license. If you do not wish to use a network license from DTP, you can configure a local license to enable Selenic functionality, but a connection to DTP must still be configured to send test results.
Connecting to the Project in DTP
In addition to configuring the connection to DTP, you will also need to specify which DTP project should receive the data. Open the selenic.properties file located in the Selenic installation directory and specify the name of your project in the DTP SERVER SETTINGS section:
Enabling Reports to DTP
report.dtp.publish property in the REPORTING section to
report.dtp.publish option is enabled, Selenic will also publish copies of test code source files to DTP by default. See Publishing Source Files to DTP for details about changing this behavior.
Publishing Source Files to DTP
report.dtp.publish option is enabled, Selenic will publish copies of the JUnit or TestNG source files by default. Publishing the sources to DTP enables you to view them alongside test details in the Test Explorer view. Refer to the DTP documentation for additional information about using the Test Explorer view.
If your test files are stored in source control, you can alternatively enable DTP to display sources by configuring Selenic to share your source control settings with DTP. See Configuring Source Control Settings for details.
Specify a publishing mode with the
report.dtp.publish.src setting in the REPORTING section to control how sources are published to DTP:
You can specify the following modes:
|All source code from the specified scope is published to DTP. This is the default setting when the |
|The minimal amount of source code is published. In most cases, auto-generated code and other source code without source control references will be published.|
|Source code is not published to DTP.|
By default, Selenic will check for source files in the current directory. If your source files are stored in another directory, use the
-source option when running the selenic_analyzer.jar file specify the location of your sources. See Command Line for usage details.
Setting Custom Build IDs
Each test execution is associated with a build ID, which is a unique identifier used to group a set of test runs. Refer to the DTP documentation for additional information about build IDs. By default, the project name and date of the execution are used as the build ID, but you can uncomment the
build.id property and specify your own value:
Setting a Session Tag
You can differentiate between execution environments, tested modules, etc., by uncommenting the
session.tag property and specifying a value:
By default, the DTP Project name and execution environment (operating system and architecture) are used.
Session Tag versus Session ID
Do not confuse the session tag with the session ID. The session tag is an identifier used to segment data in DTP reporting interfaces, whereas the session ID is a used by the Selenic analyzer to differentiate between test run data collected by the Selenic agent.
Publishing Results from the Command Line
You can also use the
-publish flag in your command line to configure Selenic to publish results to DTP for each execution of the selenic_analyzer.jar file (see Command Line). You must still configure the connection to DTP, however, as well as the
dtp.project property in the selenic.properties file.