In this section:
Overview
The Test Explorer provides detailed information about unit and functional tests, such as test traces, history of runs, and coverage information. Click on a unit or functional test widget from the Report Center dashboard to access the Test Explorer (see Widgets). You can also access the test explorer from the Coverage Explorer (see Coverage Explorer). The test explorer is divided into four panels:
- Search panel; see Using the Search Panel.
- Search results table; see Viewing Search Results.
- Source panel; Viewing Source Code.
- Actions panel; Resolving Test Failures.
Using the Search Panel
The Test Explorer opens using the settings of the unit or functional test widget you clicked as search parameters, but you can easily change the search to learn about the state of coverage in your application.
- Click Change Search to open the Search Options overlay.
- Choose a filter from the Filter drop-down menu (see Creating and Managing Filters, to learn more about filters in Report Center).
- Choose a build ID from the Build drop-down menu (see DTP Concepts to learn more about build IDs in DTP).
- Choose your search parameters. You can also click the File Name option and enter a file name in the search bar to find a specific file.
- Click Search.
Viewing Search Results
The search results panel shows tests based on the parameters entered in the search overlay.
You can perform the following actions:
- Click on a row to view additional information in the actions panel; see Resolving Test Failures.
- Click on a column header to sort results
- Click and drag a column header to the area labeled Drag a column header and drop it here to group by that column to create grouped views of the search results. By default, the table is grouped by test file name.
Resolving Test Failures
The actions panel provides information about the tested file and its tests to help you understand defects in your software. The panel also provides an interface for assigning test metadata to help you resolve test failures. Click on a tab in the actions panel to view information or assign tests with metadata to place it into a remediation workflow.
Prioritization Tab
Click on the Prioritization tab to access several actions to help you remediate unit and functional test failures.
You can perform the following actions:
- Add comments
- Assign a user by entering a user name in the Assigned To field.
- Set the priority by choosing an option from the Priority drop-down menu.
- Define an action for the assignee by choosing an option from the Action drop-down menu.
- Actions are strings of metadata that you can use to define how you choose to remediate test failures. DTP ships with set of predefined actions: None, Fix, Reassign, Review, Suppress, and Other. You can edit or remove the predefined action types (except for the None type) using the API. For details on configuring actions, choose API Documentation from the Help drop-down menu in the Report Center navigation bar.
- Associate a business risk or impact to the test by choosing an option in the Risk/Impact drop-down menu.
- Assign a due data by entering a date in the Due Date field or by using the date picker
- Assign a reference number to the test be entering a value in the Reference # field
Click Apply to save the test metadata.
Permissions Must be Configured to Update Test Metadata and View Sources
Users must have permissions to set unit and functional test metadata (prioritize), as well as view sources. Permission can be granted for all tests or limited to tests owned by the user. The following table describes a project membership scenario and how permissions may be assigned (see Assigning Native Permissions, for additional information):
User Type Additional Permission Access Granted Admin Leader Member Non-member 1 No access Non-member 2 project Non-member 3 project, prioritizeOwner Non-member 4 project, viewSources
Modification History Tab
Click on the Modification History tab to show when test metadata was updated.
If you want to filter for comments, you can enable the Only show comments option.
Test History Tab
Click on the Test History tab to show when tests were ran and the status of each run. You can click on a column header to sort the contents of the table.
Traces Tab
When viewing unit test data, the Traces tab shows stack traces for failed and incomplete tests. If you are viewing functional or manual tests, the tab shows error messages for test failures.
Unit Test View
Click on an entry under an error message to show the test in the source code in the source panel; see Viewing Source Code.
Functional and Manual Test View
The message associated with the selected failure displays in the tab. The specific test failure is highlighted in the source panel.
Click the Show Traffic button to view the data requested during the test and the application’s response.
Viewing Test Coverage Information
The coverage panel shows a hierarchical view of the files associated with the tests. Each node in the hierarchy shows how much of each file or directory is covered in brackets. Coverage information is not currently available for functional tests.
- Click on the disclosure triangle to expand the coverage tree
- Click on file nodes to view it in the source code panel; see Viewing Source Code.
Details Tab
Click the Details tab to view information about the test.
Viewing Source Code
If DTP is integrated with your source control system, then you can view the tested source code in an explorer view. If integration with your source control system has not been configured, you can still view sources tested by DTP Engines by setting the report.dtp.publish.src setting to full or min when configuring the engine. This instructs the engine to transfer client source code to DTP when generating the report. See the DTP Engines for Java, C/C++, or .NET user manuals for additional information.
Users must also have permissions to view source code. See the note above about permissions for additional information.
When viewing functional or manual tests, the source code panel shows a hierarchical view of the test suite data collected. No additional permissions are required to view functional test data. See Viewing Functional and Manual Test Sources for information on viewing functional test data.
Viewing Unit Test Source Code
Click on a file link in the Traces or Coverage tab to load the contents of a source file into the sources panel. This enables you to view test and coverage information in the context of the code. Displayed sources are marked with color coded flags for at-a-glance coverage information after clicking links in the Coverage tab of the actions panel. Lines with green flags are covered. Lines with red flags are uncovered.
Clicking on links in the Traces tab also loads sources into the sources panel. Lines of code where the fail occurred are flagged so you can easily find the test in the trace stack.
When you make a selection in the tests table, the file name and the component that opened the file appears in the code panel.
Viewing Functional and Manual Test Sources
Click on a test in the search results panel to view functional tests performed with SOAtest 9.x or later in the Test Explorer. SOAtest 9.9.2 or later is required to view test authorship and parameterized tests. Data Collector parses the XML report file generated by SOAtest and displays the .tst file data, so the .tst file does not need to be published to DTP or stored in source control.
The selected test suite is highlighted in the panel. You can click on the disclosure triangles to navigate the test data. Each node shows how much of the test suite was executed successfully. Failed test suites are displayed in red.
