In this section:
Introduction
The Parasoft Findings Plugin for Bamboo is designed to integrate functional and unit test reports generated by Parasoft tools into your Bamboo project. It provides a Parasoft Report Parser task that converts Parasoft's XML reports into graphs to help you conveniently view the number of passed/failed tests and result details, as well as visualize test execution trending data in a graph. This task allows you to visualize test results from functional test reports generated by Parasoft SOAtest as well as unit test reports generated by Parasoft C/C++test, Parasoft dotTEST, and Parasoft Jtest. While viewing static analysis results is not part of the implementation for Parasoft Findings for Bamboo, see Viewing Static Analysis Reports to learn how Bamboo natively supports archiving static analysis reports as artifacts and how to view them.
The plugin can consume the following report types:
- Functional test reports generated by Parasoft SOAtest 2020.1+.
- Static analysis, metrics analysis, and unit test reports generated by 2020.2+ versions of C/C++test, Jtest, and dotTEST.
Requirements
- Bamboo version 5.14 or later.
Adding and Running Parasoft Report Parser
- Add the task to your build job.
- Specify the Report location pattern. You can also enable Pick up test results that were created outside of this build in the Advanced settings if reports were generated before the build plan starts.
- Run a build plan and view test results in the test tab.
Viewing Results
After running the tasks, results will be available in the project plan home page. You can drill down into the Test results page for additional information.
C/C++test Professional Unit Test Results
C/C++test reports for unit test results must be generated with the Overview of checked files and executed tests option enabled. You can enable this option on the command line by using the option -property report.contexts_details=true
or by setting the report.contexts_details=true
property in the settings file.
Starting with version 2024.1, you can also use the command line option -property report.additional.report.dir=<REPORT_DIR>
when generating the reports and use reports generated in this directory.
Test Results from Parasoft Test Cases
Associating Test Results with Individual Test Cases
Visualize Test Execution Trending Data
Viewing Static Analysis Reports
You can configure Bamboo to archive static analysis reports. To do so, complete the following in Bamboo:
Modify the job's script to include the following elements (as desired) in the command line that calls the cli:
-fail
Add this switch to cause the job to fail if there are static analysis violations. Optional. -report "<PATH>"
Specifies where the static analysis report will be created. - Go to Plan Configuration > Artifacts and create an artifact definition for the report.
- When setting the Copy pattern(s), remember to include at least
*.html
,*.jpg
and*.png
so images will be included in your reports. You can also include all file types by entering**
as the copy pattern. - When setting the Location, be sure it matches the path you set in the job's script.
- When setting the Copy pattern(s), remember to include at least
If you would like reports to open in a browser instead of being downloaded, go to Bamboo administration > Security > Security Settings and enable Allow artifacts to be embedded in Bamboo pages. You will only need to do this once.
Once you have configured Bamboo, the report will be created as an artifact as part of the build process. Click it from the Artifacts tab for the build to open its directory.
Third-Party Acknowledgements
The Parasoft Findings Plugin for Bamboo uses the following third-party software:
Apache Log4j
This software is used under an Apache License 2.0 with this notice.
Atlassian Bamboo API
This software is used under an Atlassian Software License Agreement.
Atlassian Bamboo Core
This software is used under an Atlassian Software License Agreement.
Atlassian Bamboo Web JAR
This software is used under an Atlassian Software License Agreement.
Atlassian Spring Scanner Annotations
This software is used under an Apache License 2.0 with this notice.
Guava
This software is used under an Apache License 2.0.
hawtbuf
This software is used under an Apache License 2.0 with this notice.
JetBrains Java Annotations
This software is used under an Apache License 2.0.
javax.inject
This software is used under an Apache License 2.0.
MXP1
This software is used under an XmlPullParser License.
Shared Application Access Layer SPI
This software is used under a 3-Clause BSD License.
Sisu-Inject-Bean
This software is used under an Apache License 2.0.
Streaming API for XML
This software is used under a CDDL Version 1.0 License.
XML Commons External Components XML APIs
This software is used under an Apache License 2.0 with this notice.