Skip to content

docs(spec): a count tile over an aggregating report sums its count measure #50

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
delchev wants to merge 1 commit into
base: main
Choose a base branch
from
Open

docs(spec): a count tile over an aggregating report sums its count measure #50

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
8 changes: 7 additions & 1 deletion docs/spec/presentation.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -119,9 +119,15 @@ reports:
dimensions: [Product]
measures: ["sum(quantity)", "sum(total)"]
widget: { kind: list, limit: 5, label: Sales by Product }

- name: RequestsByStatus
source: VacationRequest
dimensions: [Status]
measures: ["count(*)", "sum(days)"] # count(*) is what the count tile sums
widget: { kind: count, label: Vacation Requests }
```

- `kind: count` (default) — the number of records the report yields.
- `kind: count` (default) — the number of records the report yields. An **aggregating** report (one declaring `measures`) yields one row per group, so its record count is its `count(*)` measure summed over those rows — a report dimensioned by status shows the fourteen requests, not the four statuses they fall into. Such a report must declare that measure; an aggregating report with a count tile and no `count(*)` is rejected at generation, because the only number left to show is the number of groups. A report that does not aggregate needs nothing: one of its rows is one record.
- `kind: value` — one aggregate cell: `value` names a measure; `at` pins dimension columns. The `now` token resolves at view time, type-aware (current `YYYYMM` on a `month(x)` dimension, current year on `year(x)`, today on a date column).
- `kind: list` — the report's first `limit` rows (default 5) as a compact table tile.

Expand Down