Customize NDepend Report
|
If you are new to NDepend reporting, before digging into report customization, it is recommended to:
- Consult standard Reports made by NDepend on popular open-source projects.
- Download NDepend trial, analyze your code base, and explore the report produced (from downloading NDepend trial, until report exploration, this won't take more than 5 minutes ).
|
▲▲ Go to Top ▲▲
Report Sections
Report can be customized through the VisualNDepend or VS addin > Project Properties > Report sub-panel.
You can choose to activate many pre-defined sections like, Application and Assemblies metrics, some diagrams (dependencies, metrics, abstractness vs.instability…), CQL rules violation, and more.
▲▲ Go to Top ▲▲
Reporting CQL Rules violation
On the main page, the report contains a section titled Summary of CQL Rules violated.
For each CQL rule you can choose whether you want to display violation in report (Active tickbox).
In case of violation you can choose if you want to display list of items selected in report, statistics about this list of items, and a selection view of items selected.
The fourth check button is related to making a CQL rule critical or not.
Here is what a CQL rule violated looks like in report:
▲▲ Go to Top ▲▲
Reporting groups of CQL Queries
Reporting the set of rules violated is useful, but it is also interesting to report some result sets of a few CQL queries.
For example, you might want to write CQL queries to ask for methods and types added or refactored since the last release.
And you might want to list these methods and types added or refactored in the report.
To do so, NDepend make possible to append extra report sections that lists these CQL queries.
In the CQL Query Explorer panel, a particular CQL group reported is bordered with an orange rectangle.
And here are the extra report sections:
▲▲ Go to Top ▲▲
Avoiding too large report
It is recommended to de-activate the Type Metrics and Type Dependencies sections since they can become pretty large if you have more than a thousand types in your application.
Typically, browsing type metrics and dependencies is a scenario better addressed through the interactive UI.
By default, NDepend sets a few flags on Project Properties to avoid too large reports:
▲▲ Go to Top ▲▲
Report Xml files
You can choose to build your own customized report by providing your own XSL sheet.
It can be inspired from the one in $NDepend Install Dir$/BuildProcessResources/ReportXsl/NDependReport.xsl.
Input information can be taken from the following XML files outputted by the analysis in the $AnalysisResultDir$ folder:
- ApplicationMetrics.xml
- AssembliesBuildOrder.xml
- AssembliesDependencies.xml
- AssembliesMetrics.xml
- NamespacesMetrics.xml
- NamespacesDependencies.xml
- TypesDependencies.xml
- TypesMetrics.xml
- InfoWarnings.xml
- CQLRuleResult.xml
- CQLRuleCriticalResult.xml
- CQLQueryResult.xml
The tickbox VisualNDepend or VS addin > Project Properties > Analysis > Keep XML files used to build reports and store warnings must be ticked, else these XML files get deleted by NDepend after the report is built.
▲▲ Go to Top ▲▲
|
|
NDepend is also available
for
Java and C++
Customers
Full Visual Studio Integration
 |
|