After test execution, C++test generates a prioritized task list , organized by error categories and severities. For tests run in the GUI, tasks are organized into the following categories in the Quality Tasks view:
For tests run from the command line interface, tasks are reported in the Test Generation and Test Execution section of the report. If results were sent to Team Server, you can import results can be imported into the GUI as described in the Importing Results into the UI. They will then be available in so that they appear in the Quality Tasks view—as if the tests were run from the GUIview.
Viewing Test Configurations
that Trigger Tasks
You can view Test configurations that trigger tasks can be opened from the Quality Tasks view: Right-click by right-clicking on a task in the Quality Tasks view and choose choosing View Test Configuration.
Quickly accessing test configuration from the from the Quality Tasks view is useful for group architects who are customizing tests and want to quickly disable settings that aren’t applicable. Developers importing results from a server-based run may also need to open and review test configurations that trigger tasks.
To review one of the lines of code referenced in the stack trace, double-click the node that shows the line number, or right-click that the node and choose Go to from the shortcut menu. The editor will then open and highlight the designated line of code.
Any test case with reported post conditions can automatically be automatically validated for use in regression testing. Verification changes the *_POST_CONDITION_* macros into assertions that will fail if a subsequent test does not produce the expected (validated) value. This is especially useful for automated generation of of a regression base for legacy code. For details on verification, see Verifying Test Cases for Regression Testing.
Within each category, tasks are organized according to severity to help you identify and focus on the most serious issues.
If you want the Quality Tasks view to display the severity of each task, go to the pull-down menu in the Quality Tasks view, then choose Configure Contents and set it to show Severity
The Test Case Explorer helps you manage a a project’s test cases, test suites, and related data sources. It provides detailed test statistics (executed/passed/failed/skipped) and allows you to search/filter the test case tree.
The By default, the Test Case Explorer is open by default, in the left side of the UI. If it is not available, you can open it by choosing Parasoft> Show View> Test Case Explorer.
For details on the Test Case Explorer, see the Exploring the C++test UI.
Reviewing Test Case Details
To view test case details, enable the Show> Details option from the Test Case Explorer menu. This configures C++test to report the following additional information
The following information will be displayed in the Test Case Explorer tree:
- Information about the function tested by a given test case (. This information is collected from the CPPTEST_TEST_CASE_CONTEXT comment). Such comments are always added by comments, which C++test always adds for automatically-generated test cases and test cases created using Test Case Wizard.
- Information about the test case description (. This information is collected from the CPPTEST_TEST_CASE_DESCRIPTION comment). Such comments can be added by comments, which C++test always adds for automatically-generated test cases (see General tab) and test cases created using Test Case Wizard (see Test Case Configuration Tips).
- Information about the test execution details. Depending on test configuration (see Runtime tab Execution Tab Settings - Defining How Tests are Executed), this can include:
- Test case reports / messages
- Information about reported tasks (e.g., exceptions, failed assertions, unverified outcomes)
- Information about checked and passed assertions
Opening the Source Code for a Test or Test Suite
To open the source code for a test suite or test case in the Test Case Explorer, right-click its Test Case Explorer node, then choose Open. Or, double-click its Test Case Explorer node.
Correlating Test Case Explorer Nodes to Quality Tasks View Results
To view detailed information about executed data source test cases, enable Show > Data source tests from the Test Case Explorer menu. This will make C++test display information about each executed iteration of the data source test case.
The data source test case element of the tree presents statistics information about executed iterations (e.g., number of passed and failed iterations). Statistics shown for all parent nodes of the data source test case also include information about particular data source test case iterations.
Obtaining Traceability Details
There are several ways to create a report containing the maximum amount of unit test execution and traceability information:
|Scroll Table Layout|
|From here...||Perform these steps...|
|Generating test cases automatically|
|Creating test cases using Test Case Wizard|
|Generating reports from the command line|
Traceability Reporting Tips
- To report additional messages from test cases, use test case report macros (see Test Case Report Macros).
- For data source test cases, reported messages might be read from the data source. For example,
CPPTEST_REPORT_CSTR("Requirement number", CPPTEST_DS_GET_CSTR("req_no"))
- If a test case description or test case message contains valid URLs (e.g. http:// or ftp://), they will be added into the generated HTML report as links.
Responding to Reported Tasks
Different types of findings require different response strategies. The following table lists the categories used to classify C++test’s test execution findings, and links to sections that will help you understand and respond to them.
|Scroll Table Layout|
|Category||Subcategory||Description and Recommended Response|
|Fix Unit Test Problems||Assertion Failures||See Assertion Failures and Timeouts|
|Runtime Exceptions||See Runtime Exceptions|
|Review Unit Test Outcomes||Unverified Outcomes||See Unverified Outcomes|
- Select the problems you want to apply the action to.
- Right-click the selection, then choose the command for the desired response (for example, Verify All Outcomes).
Generating Test Execution Details Reports
The Test Execution Details report is an additional report you can generate from your regular report. It contains details about the following information:
- about tested files
- toolchain used for building test harnesses
- additional configuration files
- test suites
- test cases (including Test Case Definition and Test Case Execution Log sections)
See Generating the Test Execution Details Report for details.