Grand total of the column across the whole visual.
| Field | Value |
|---|---|
| Category | Context and filter |
| Type | Aggregation (operates on a set of rows) |
| Arity | 1 argument (fixed) |
| Compiles to SQL (calculated column) | No |
| Version | Formula engine v3. |
Aliases#
Canonical name: SUMTOTAL. Accepted aliases (case-insensitive): (nenhum).
Syntax#
SUMTOTAL(coluna)The 1st argument is the name of a column (bare identifier); the others are expressions.
Returns#
Number (the visual's grand total).
Null handling#
When there is no row in the changed context, it returns blank (never zero) — a blank is more honest than a made-up zero.
Evaluation context#
Sums over the whole visual (allRows).
Differences from DAX#
- DAX equivalent: —
- Compatibility: No direct DAX equivalent
- Note: There is no single DAX function; it is equivalent to the visual's CALCULATE(SUM(column); ALLSELECTED()).
Examples#
SUMTOTAL(receita)Example with values#
Input: group SP; visual total = 100.
SUMTOTAL(receita) → 100Expected result: 100
Business example#
Comparative measure — share of total, ranking, change versus another period.
Common errors#
Typos in a column name, an incompatible type, or an invalid argument become a friendly message (pt-BR) — the engine never silently returns a wrong number.