====Regenerating Bulk Reports====

In some cases - particularly when you're using a library such as [[mplreport:kpicapture|KPICapture]] to record KPIs and analytic values - you might want to re-generate a number of past reports.

The reporting addon provides this through the **backgen** endpoint. 

Note that this does not create new reports that are saved to your report history - these are simply created and immediately discarded to refresh any metadata or analytics you're capturing as part of the report process.

===Triggering a Back-Generation===

To back-generate, open the URL in your browser....

    http://<servername>/s/<sitename>/reportlist/backgen?report=<reportname>&range=14&hours=24&offset=0

The function takes the following parameters...

^Parameter^Default^Desc^
|report|//None//|The 'short name' of the report|
|range|7|The number of **periods** to travel back|
|hours|24|The number of hours per **period**|
|offset|0|The number of periods to skip|

===Examples===

For example, the following...

   ?report=myreport&range=7&hours=24&offset=0

...will produce 7 reports covering 24-hours each, starting 7 days ago and ending today.


   ?report=random&range=30&offset=7

...will produce 30 reports, starting from 7 days ago. If run on the 7th of the month, this would normally generate reports for the previous calendar month.