wiiki - TopsReportDefinitionLanguage

Multi-Nested Roll-Up Report Markup Language Proposal

I've done enough "multi-nested" reports with totals and subtotals with both row-wise and column-wise groupings, totals, averages, etc. that it feels like there should be a tool to make building and formatting such reports easier. The banded approach is no longer sufficient.

This is a rough attempt to explore a potential "report markup language" for such reports.

Here is a general example:

<datasource file="myFile.csv" filetype="CSV">
<row field="field_2" span="yes" align="center">
...Field 2 Title
...<row field="field_3">
......Field 3 Title
......<column list="2006,2007,2008" span="yes">
.........<column field="field_4" onNull="N/A">
.........Field 4 Title
.........</column>
.........<sum>Sub-Total</sum>
.........<average divzero="N/A">Avg.</average>
......</column>
...</row>
...<sum color="silver">Total</sum>
</row>

Sorry, I don't yet have a wiki-tized example result. (Dots to prevent TabMunging.)

Attribute and Tag Descriptions (Not all shown in example)

append (tag) - A kind of string-equivalent of "sum" where string items are appended to form a kind of list. A space is placed after the delemiter unless "space=no". (This seems like an odd feature, but quite useful.)
calc (tag) - To provide custom calculations. Can be used in conjunction with "hidden" and "name" to provide complex calculations. Example: <calc leftname="foo" rightname="bar" operator="*"> The order of "calc" and statistic tags determines calculation order (within a group).
count (tag) - Count for the group
delimiter - Character for delimiter if a list is given or appended to. Default is comma.
divzero - Value to display if division by zero would otherwise occur. Default is "div/0".
displayfield - Optional field used for display value if calculation field is not well-suited for display.
fillfrom - List values based on all values from the specified item (as specified by "name" attribute). Otherwise, only the current context is used. This can help provide consistently-repeating sub-items and zero- or blank-filling those not present. (Difficult to describe without an example.)
hidden - To suppress display of an item.
list - A list of values as an alternative to to a database column ("field"). If both a field and a list is specified, then both are used with the list values coming first.
onBlank - value to display if cell value is blank.
onNull - Value to display if cell value is null (blank is default).
onZero - Value to display if cell value is zero.
name - Used to reference a row or column by other tags or attributes.
span - Tells the value to span any inside columns if a grouped level. Otherwise, the value is repeated for each inner instance (if any).
suffix - Suffix appended to displayed value. Example "%" used indicate percent.
weightedavg (tag) - Similar to "average" tag, except it is a weighted average. (Perhaps the "calc" tag is good enough to avoid the need for this.) Example: <weightedavg scalefield="empcount">

Also, the location of the titles probably need a bunch of position option tags because there are various ways they can potentially be placed. Paper-based options also need to be addressed (no-page-span, keep-with-group, etc.)

Tags for statistics such as median, standard-deviation, etc. could also be included.

"Field" is used to refer to input table columns to avoid confusion with report "columns".

For now, the input table/sheet is assumed to be pre-sorted.

Actually, multi-nestedness is often a design smell in this day and age as click-able interactive "drill-down" web interfaces can be built rather than try to squeeze all combinations onto a single page. However, the boss/client/user sometimes wants things a certain way and it's not our job to stop them, beyond advice.

--top

This seems like a fine pursuit. I'm interested in developing something similar for user-configurable hovertext in an OCU. Hooking the RDL into the DataModel will probably require greater work, as will numeric formatting and measurement conversions (e.g. Celcius to Fahrenheit). -- GreenHat

But, ReportsSmell -- BlackHat

I don't believe so, but I'll take up my objections on that page.