Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
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
13 changes: 8 additions & 5 deletions docs/building-your-own.md
Original file line number Diff line number Diff line change
Expand Up @@ -217,11 +217,14 @@ The same round trip adds a few dozen lines of defaults across the reports:
They change nothing — a deploy from the source without them succeeds — and they make a
report definition longer without making its intent clearer.

The dashboards also come back with two properties *rewritten* rather than added:
`<expandOthers>` flips to `false` and `<showTotal>` is dropped altogether. Neither applies
to a Bar component; Salesforce is normalising settings that were never doing anything.
That is worth knowing when you write a new component — those two do nothing on a bar chart
— but it is not worth taking a two-hundred-line reformat to find out.
The dashboards used to come back with two properties *rewritten* rather than added:
`<expandOthers>` flipped to `false` and `<showTotal>` was dropped altogether. Neither
applies to a bar or column component; Salesforce was normalising settings that were never
doing anything. The committed dashboards no longer carry either element on Bar, Column or
ColumnStacked components. They stay on the three Donut components, where they mean
something: `<showTotal>` puts the total in the centre of the ring, and `<expandOthers>`
decides whether the small slices grouped as "Others" can be opened. When you write a new
component, add those two only for a donut or pie.

The general rule, and it is the same one as everywhere else in this document: a deploy
tells you whether the source is *sufficient*. A retrieve tells you what the org chose to
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -38,12 +38,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Anomalies</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Emissions_by_Asset_and_Year</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>false</showValues>
<sortBy>RowLabelAscending</sortBy>
<title>Scope 1 by Asset and Year (tCO2e)</title>
Expand All @@ -60,12 +58,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Anomalies</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Orphaned_Carbon_Footprints</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowLabelAscending</sortBy>
<title>Orphaned Footprints by Year</title>
Expand Down Expand Up @@ -107,12 +103,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Completeness</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Footprints_by_Year_and_Stage</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowLabelAscending</sortBy>
<title>Stationary Footprints by Year and Stage</title>
Expand Down Expand Up @@ -154,12 +148,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Fleet completeness</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Fleet_Footprints_by_Year_and_Stage</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowLabelAscending</sortBy>
<title>Fleet Footprints by Year and Stage</title>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Stationary gaps</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Stationary_Assets_Missing_Footprints</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Assets Missing Footprints</title>
Expand All @@ -35,12 +33,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Stationary gaps</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Stationary_Assets_Missing_Energy_Use</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Assets Missing Energy Use</title>
Expand All @@ -57,12 +53,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Fleet gaps</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Fleet_Assets_Missing_Footprints</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Fleet Missing Footprints</title>
Expand All @@ -76,12 +70,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Fleet gaps</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Fleet_Assets_Missing_Energy_Use</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Fleet Missing Energy Use</title>
Expand All @@ -98,12 +90,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Orphans</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Orphaned_Carbon_Footprints</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Orphaned Footprints by Year</title>
Expand All @@ -117,12 +107,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Orphans</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Orphaned_Stationary_Energy_Uses</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Orphaned Energy Uses by Fuel</title>
Expand All @@ -136,12 +124,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Orphans</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Orphaned_Fleet_Footprints</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Orphaned Fleet Footprints</title>
Expand All @@ -155,12 +141,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Orphans</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Orphaned_Vehicle_Energy_Uses</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Orphaned Vehicle Energy Uses</title>
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -16,12 +16,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Emissions trend</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Emissions_by_Reporting_Year</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowLabelAscending</sortBy>
<title>Scope 1 by Reporting Year (tCO2e)</title>
Expand All @@ -38,12 +36,10 @@
<drillEnabled>false</drillEnabled>
<drillToDetailEnabled>false</drillToDetailEnabled>
<enableHover>true</enableHover>
<expandOthers>true</expandOthers>
<header>Fuel mix</header>
<legendPosition>Bottom</legendPosition>
<report>NZC_Reports/Fuel_Consumption_by_Fuel_Type</report>
<showPercentage>false</showPercentage>
<showTotal>false</showTotal>
<showValues>true</showValues>
<sortBy>RowValueDescending</sortBy>
<title>Stationary Fuel by Type</title>
Expand Down
Loading