'Historical' reports display graphical and numerical data relating to sets of coverage data collected over time for the project.
When you view the report you should see a picture similar to the screenshot below, although it is likely that the graphs that you produce will contain different values.
- Like the 'current' report, the historical report begins with a header containing relevant project information. This includes the report title, the project metrics and the period for which history points are included in the report. (A history point is a snapshot of code coverage and metrics data for the project at a particular point in time.)
- Below this header is the Project Overview Chart which shows the branch, statement, method and total coverage percentages for the project for the most recent history point included in the report.
- The 'Coverage over time' graph shows the percentage values of branch, statement, method and total coverage for each history point and plots them against time in an easy-to-read chart.
- The 'Metrics over time' graph shows the project statistics for each history point plotted against time. It is therefore possible to observe changes in metrics such as the number of methods. In the example below, the number of methods can be seen shown in green.
- The final section, 'Movers', displays classes that have increased or decreased in coverage by more than a specified percentage point threshold over a particular time interval, the default being 1 percentage point over the two latest history points. In this case there have not been any classes which have lost more than 1 percentage point coverage, hence the only item displayed here is the Money package which has gained 10.6 percentage points coverage over the two latest history points.
The tutorial discusses how you can customise many aspects of the historical report.