...
| Table of Contents | ||
|---|---|---|
|
Overview
The Change Explorer provides an interface for understanding the code changes and how they affect the application under development. You can access the Change Explorer by clicking on the Files - Changed widget or by clicking on a link in the Reviews Report or Review Findings Report.
...
- Search panel - see Using the Search Panel
- Search results table - see Viewing Search Results
- Baseline panel - see Reviewing Changes
- Changed panel - see Reviewing Changes
- Summary panel - see Viewing Summary Information
- Reviews and Violations panel - see Reviewing Findings
Using the Search Panel
The Change Explorer shows data according to the filter, baseline build, and target build specified in the widget you clicked to open the explorer. You can easily change the search scope to view specific information.
...
- Change the filter: Choose a new filter from the menu. See Configuring Filters for more information.
- Specify the baseline build: Choose a baseline build from the menu. A baseline build is a snapshot of the code at a previous state.
- Specify the target build: Choose a target build from the menu. The target build contains the updated files as compared to the baseline build.
- Specify the review ID: Choose a review ID from the menu to show information associated with a specific review. Reviews are tied to the specific comparison of baseline and target builds. For example, if you add a review when viewing changes from baseline build A and target build B, a review ID is generated. If you compare build A with target build C, the ID will not be available as a search criterion.
- Specify the scope of files: Click the Include File Pattern Exclude File Pattern option and specify file paths to refine the scope of the search. Ant-style patterns are supported. See Using File Patterns in DTP for more information about configuring file patterns.
- Click Search when your search parameters are set to load the results in the search results panel.
Viewing Search Results
The search results panel returns the files within the scope of the search organized by module. Results are color-coded to indicate coverage. Green file names are files that were added since the baseline build. Red file names are files that have been removed since the baseline build.
...
Choose your options and click OK to apply the filter(s) or click Cancel to close the menu without filtering. Click Clear to remove all applied filters.
Reviewing Changes
You can review and annotate code changes in the margins of the baseline and target build panels. Differences between the versions of the file are highlighted. See Reviewing Findings for more information.
...
An icon will also appear in the margin if the file contains static analysis violations. You can click on this icon to view details about the violation. Click on the Violation ID link to view it in the Violations Explorer.
Viewing Summary Information
You can view information about file changes between the baseline build and the target build in the Summary panel.
...
Click on the Violations Summary tab for an overview of the static analysis violation changes from the baseline build to the target build.
Reviewing Findings
The Reviews panel is an interface for reviewing code changes and adding findings. Reviews are associated with a specific combination of filter ID, baseline build, and target build (see Using the Search Panel). Findings are individual annotations associated with a review.
...
Click on the Violation ID to view it in the Violations Explorer.
Adding Reviews
If there are no reviews associated with the search parameters, you must create one before annotating the code with findings.
- Click the link to create a review:
- A review name and assignee are required. Comments, status, and severity are optional.
- Click Apply to save the review.
Adding Review Findings
You can attach findings to the code within the context of reviewing changes.
...