# SmartVisuals Scoreboard for Power BI

> SmartVisuals Scoreboard plays any two teams, plants or measures as a match in Power BI: live scores, leads, game clock, events feed and league table. Free.

- Page: https://www.smartvisuals.io/visuals/scoreboard
- Fields and settings: https://www.smartvisuals.io/visuals/scoreboard/settings
- Microsoft Marketplace: https://marketplace.microsoft.com/en-us/product/smartvisuals.smartvisuals-scoreboard?tab=overview
- Package: https://www.smartvisuals.io/downloads/smartvisuals-scoreboard-1.0.1.1.pbiviz
- Sample report (zipped .pbip): https://www.smartvisuals.io/samples/smartvisuals-scoreboard-sample-1.0.1.1.zip
- Price: Free, every feature, no licence.
- Certified by Microsoft: yes
- Version: 1.0.1.1
- GUID (visualType and publicCustomVisuals): `scoreboard6FC0350F8A5F4EF5A6DF7ABB6E32C274`

## What is free

- **A real match page**: Face-off with logos, codes, colours and huge scores, a period linescore, a momentum strip, a share-of-total bar, mirrored stats for extra measures and an events feed, newest first.
- **Two measures can play each other**: No side field? Actual vs Target or This year vs Last year becomes a match, with sensible business codes like TY / LY and ACT / TGT that you can edit.
- **Rules business needs**: Lower is better per measure, a tie margin (absolute or percent), the lead as an amount, a percent or both, scoring by measures won, and ratios that are averaged, not added.
- **Four layouts and a boardroom style**: Match centre, TV score bug, stadium LED board and league table, picked automatically by data and size, plus a calm boardroom style with no segments, glow or animation.
- **Made for wall screens**: Pages through fixtures, a game clock with countdown, match minute and FULL TIME, scores that roll only when data changes, one gentle goal celebration and an OLED burn-in guard.
- **Logos with no web calls**: Team or plant logos from base64 image data URIs built in Power Query; web addresses are never loaded and refused values are named in the format pane.
- **Native Power BI behaviour**: Sides, periods, events and table rows cross-filter the report, highlights dim what is left out, tooltips work on touch, and four themes come with every colour adjustable.

## Fields

| Field | Internal name | Takes | Needed | What it is for |
| --- | --- | --- | --- | --- |
| Side | `side` | Column | Optional | Each value is a competitor: plant, team, region, person. Leave empty and bind two measures to play them against each other. |
| Score | `score` | Measure | Optional, up to 8 | The first measure is the score; more measures are compared as stats. With no Side, two or more measures are the sides (This year vs Last year). |
| Match | `matchup` | Column | Optional | Groups sides into matches (fixtures, weeks, rounds). The board pages between matches and the league table is built from their results. |
| Period | `period` | Column | Optional | Quarters, months, weeks or halves: the linescore columns and the current period on the clock. |
| Event | `eventLabel` | Column | Optional | Each row with an event is a goal in the events feed: a deal, an order, a shipment. |
| Event Time | `eventTime` | Column | Optional | When the event happened (date/time or text). Sorts the events feed, newest first. |
| Start | `start` | Measure | Optional | Start of the competition (a date measure). With End, the clock shows the match minute. |
| End | `end` | Measure | Optional | End of the competition (a date measure): countdown to the whistle, then FINAL. |
| Logo | `logo` | Column | Optional | A picture per side: a base64 image data URI (data:image/png;base64,...), for example a Power Query column. Web addresses are never loaded: the visual makes no external calls. |
| Tooltips | `tooltips` | Measure | Optional, up to 8 | Extra measures shown in the tooltip. |

## Format pane

Each card is a key under `visual.objects` in a PBIR visual.json; each setting is a property of it. Toggles take `true`/`false`, choices and text a value in single quotes (`'auto'`), numbers a `D` suffix (`12D`).

### Theme (`theme`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Theme | `selectedTheme` | `smartvisuals` (SmartVisuals), `dark` (Dark), `clean` (Clean), `slate` (Slate) |
| Transparent Background | `transparentBg` | On / off |
| Use Report Theme Colors | `useReportTheme` | On / off |

### Layout (`layout`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Layout | `layout` | `auto` (Auto), `match` (Match centre), `bug` (Score bug), `led` (LED board), `table` (League table) |
| Style | `style` | `scoreboard` (Scoreboard), `boardroom` (Boardroom (plain)) |
| Side Order | `sideOrder` | `data` (As in the data), `leader` (Leader first), `name` (Alphabetical) |
| Show Period Linescore | `showLinescore` | On / off |
| Periods Shown (0 = All That Fit) | `maxPeriods` | Number |
| Show Share Bar | `showShare` | On / off |
| Show Momentum Strip | `showMomentum` | On / off |
| Show Stats Comparison | `showStats` | On / off |
| Show Events Feed | `showEvents` | On / off |
| Events Shown | `eventCount` | Number |
| Show Short Codes | `showCodes` | On / off |

### Match Rules (`match`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Score | `scoring` | `first` (First measure), `won` (Measures won) |
| Tie Margin Type | `tieMode` | `abs` (Absolute), `pct` (Percent of the higher score) |
| Tie Margin | `tieMargin` | Number |
| Show Lead Text | `showLead` | On / off |
| Lead Shown As | `leadAs` | `amount` (Amount (1,250)), `pct` (Percent (5.6%)), `both` (Both (1,250 / 5.6%)) |
| Lead Word | `leadWord` | Text |
| Tied Word | `tiedWord` | Text |
| Points For A Win | `pointsWin` | Number |
| Points For A Draw | `pointsDraw` | Number |
| Points For A Loss | `pointsLoss` | Number |
| Form Guide Length | `formLength` | Number |
| Top Zone Rows | `topZone` | Number |
| Top Zone Label | `topZoneLabel` | Text |
| Bottom Zone Rows | `bottomZone` | Number |
| Bottom Zone Label | `bottomZoneLabel` | Text |

### Header (`header`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Header | `show` | On / off |
| Title | `title` | Text |
| Subtitle | `subtitle` | Text |
| Title Size (%) | `titleSize` | Number |
| Clock | `clockMode` | `auto` (Auto), `off` (Off), `period` (Current period), `countdown` (Countdown to End), `minute` (Match minute (Start to End)), `time` (Time of day) |
| Time Format | `clockFormat` | `24` (24-hour (14:05)), `12` (12-hour (2:05 PM)) |
| Match Length (Minutes) | `regulation` | Number |
| Show Clock Caption | `showCaption` | On / off |
| Show Header Rule | `showRule` | On / off |

### Sides (`sides`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Color | `color` | Colour |
| Short Code | `abbrev` | Text |

### Measures (`measures`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Label | `label` | Text |
| Lower Is Better | `lowerIsBetter` | On / off |
| Combine Periods By | `combine` | `auto` (Auto), `sum` (Sum), `avg` (Average), `latest` (Latest), `max` (Maximum), `min` (Minimum) |
| Show As | `showAs` | `auto` (Auto (a ratio as a percentage)), `percent` (Percentage), `number` (Number, as in the model) |

### Logos (`logos`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Show Logos | `show` | On / off |
| Logo Size (%) | `size` | Number |

### Numbers (`numbers`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Display | `display` | `full` (Full (1,240)), `compact` (Compact (1.2K)) |
| Decimals | `decimals` | `auto` (Auto), `0`, `1`, `2` |

### Text (`text`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Score Font | `font` | `auto` (Follow the theme), `barlow` (Broadcast (Barlow Condensed)), `led` (LED seven-segment), `ui` (Segoe UI) |
| Name Case | `letterCase` | `auto` (Follow the theme), `upper` (UPPER CASE), `asis` (As in the data) |
| Score Size (%) | `scoreSize` | Number |
| Name Size (%) | `nameSize` | Number |
| Label Size (%) | `labelSize` | Number |

### Animation (`animation`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Animate Score Changes | `animate` | On / off |
| Roll Duration (ms) | `duration` | Number |
| Celebrate New Events | `celebrate` | On / off |
| Celebration Word | `celebrateText` | Text |
| Celebration Seconds | `celebrateSeconds` | Number |

### Paging and Screen (`paging`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Page Through Matches | `autoPage` | On / off |
| Seconds Per Match | `seconds` | Number |
| Show Page Indicator | `showIndicator` | On / off |
| Pause On Hover | `pauseOnHover` | On / off |
| Burn-In Guard (Shift 1 px) | `pixelShift` | On / off |

### Colors (`colors`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Background | `bg` | Colour |
| Panel | `panel` | Colour |
| Text | `ink` | Colour |
| Captions | `muted` | Colour |
| Score Digits | `scoreInk` | Colour |
| Accent (Lead Marker, Rule) | `accent` | Colour |
| Clock Box | `clockBg` | Colour |
| Clock Text | `clockInk` | Colour |
| LED Digits | `ledOn` | Colour |
| LED Clock And Messages | `ledAlt` | Colour |
| Celebration Band | `celebrate` | Colour |
| Row Stripes | `panelAlt` | Colour |
| LED Housing | `ledBg` | Colour |
| LED Unlit Segments | `ledGhost` | Colour |
| LED Printed Captions | `ledCaption` | Colour |
| Win | `win` | Colour |
| Draw | `draw` | Colour |
| Loss | `loss` | Colour |

### Accessibility (`accessibility`)

| Setting | Internal name | Type or options |
| --- | --- | --- |
| Reduce Motion | `reduceMotion` | `system` (Follow system setting), `always` (Always reduce), `off` (Off (always animate)) |
| Focus Outline Color | `focusColor` | Colour |
| Focus Outline Width (px) | `focusWidth` | Number |
| Minimum Text Size (px, 0 = Off) | `minFontSize` | Number |