The Rollup plugin repeats computations spread over a number of wiki pages and compares the results to those stored in a previously computed rollup.
The rollup is guided by a dataset captioned "Material Summary". Each row corresponds to a wiki page that can recompute the quantities on that page. One column, titled Material, names those pages. The remaining columns provide quantities that are computed on those pages.
In our example we will provide a Material Summary dataset that refers repeatedly to the same page, one used in the About Method Plugin example. This dataset has been constructed to show both data that agrees with that found in the example, and some rows that disagree. The example computes verses from the "Bottles of Beer" song.
The computations used by the beer song expect reference data to be provided somewhere nearby. When normally viewed, this data appears on the same page as the calculation. However, here we will provide reference data directly to the Rollup plugin as this is the context where rollup computations take place.
This is where we place the sample Rollup plugin. The plugin renders as a table of results to be recomputed. (In this example we are computing the same beer song verses over and over.)
Computation commences immediately. Pages are fetched five per second. Results are displayed in a color code as they are completed. Details are available in hover text.
green means the new results agreed to four places to the right of the decimal.
yellow means the new results agreed only to the left of the decimal, the whole number part.
red means the new results disagreed in the whole number part when rounded to a whole number. This could still be a small difference as in 9.501 vs 9.499.
Page names appear as hyperlinks at the beginning of each row. A red x appears by the name if any problems are encountered calculating. Hover over the x for details. Click the link to investigate.
The Rollup plugin will assign a Rank to each result based on a Total Score reported by each calculation. The largest score has the lowest rank: 1. If the previous rollup has these columns then they will be displayed and colored using the same color code.
Rank ordering waits until all computations are complete before it begins.