Skip to content

Commit 2ca4a3c

Browse files
isobelthompsonyantantether
authored andcommitted
Changed PBI and layout sections to DRAFT status
new branch containing content still being worked on added filters section added filters images added kpi-cards section to drafts test push kpi cards
1 parent 05dc77b commit 2ca4a3c

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

94 files changed

+1556
-0
lines changed
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,13 @@
1+
---
2+
layout: collection
3+
title: "Report and dashboard layout"
4+
description: "Layout standards for reports and dashboards at the NHSBSA"
5+
status: DRAFT
6+
tags: data-viz-home
7+
order: 20
8+
collection_tag: dv-dashboard-layout
9+
pagination:
10+
data: collections.dv-dashboard-layout
11+
size: 50
12+
alias: articles
13+
---
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,108 @@
1+
---
2+
layout: article
3+
title: "Layout of a dashboard: Information"
4+
description: "Overview of the information pages to include in NHSBSA reports"
5+
status: DRAFT
6+
tags: dv-dashboard-layout
7+
order: 1
8+
---
9+
## Information pages
10+
11+
The information pages are a rough wireframe to be used as a guide to the features that could be included. The idea is that a dashboard developer has a rough template to use any features they see fit. The template can be used across the organisation.
12+
13+
Benefits of information pages include:
14+
15+
- Encouraging data literacy, and a user’s understanding of what is being shown.
16+
- Encouraging interactivity with dashboards.
17+
- Encouraging confidence and self-sufficiency within users to use our dashboards and analyses to the full extent.
18+
- Informing users of important relevant information.
19+
- A standardised and reliable approach across dashboards, enabling a user’s ease-of-use.
20+
21+
The information pages are designed to compliment the reporting pages, with an initial Dashboard information page, followed by the reporting pages, and with any other complimentary dashboard information pages at the end of the report for consultation by the user if needed. The pages mentioned in this example are:
22+
23+
- Info: Dashboard information
24+
- Summary/highlights
25+
- Insight 1
26+
- Insight 2
27+
- Info: Data Details
28+
- Info: Updates
29+
- Info: How to use
30+
31+
The content of the dashboard should be automated wherever possible to minimise manual intervention.
32+
Please note, this dashboard does not consider a personalised or role-based user journey based on user access.
33+
34+
### General layout
35+
36+
The information pages have the following features present across each page:
37+
38+
- The NHS Business Services Authority logo in the top left corner.
39+
- The Report/Dashboard Title and name of the page, alongside the reporting month and year.
40+
- Information in the main body of the page.
41+
- A footer to state who created the dashboard, and a link to the [Accessibility Statement][info 0]
42+
- The background is NHS Grey 5 (#F0F4F5). Please see the colour guidance for more details.
43+
44+
### Text content
45+
46+
Your content should follow the corporate NHS Business Services Authority Content Design Standards.
47+
Please note: [this link to the NHSBSA Content Design Standards][info 1] leads to an internal folder. This will be updated once the relevant content is added to the playbook.
48+
49+
Some important notes in relation to your text content:
50+
51+
- A Header 1 should be used on each page to help navigate a screen reader, Header 1 should be size 16px.
52+
- The body of the text should be size 12px. [Source - Accessible print publications][info 2]
53+
- Frutiger or Arial should be used as the font throughout the report. The core NHS font is Frutiger and the secondary font is Arial. [Source - NHS identity guidelines; Fonts][info 3]
54+
55+
### Dashboard information section
56+
57+
The Dashboard Information section has been designed as an introduction to the dashboard, to allow the users to check the reporting period and refreshed date of the data. It clearly states the purpose of the dashboard to the user to give context.
58+
It also benefits the perceived performance of the dashboard being the initial page a user is directed to as charts and data can load on other pages whilst the user checks the details shown.
59+
60+
It includes:
61+
62+
- In addition to the usual information page layout the Dashboard Information page has a title bar, more clearly stating the organisation name, and dashboard report title.
63+
- Dashboard version number is included in the top right, this enables the user and developer to ensure they are working from the same dashboard version should an issue arise.
64+
- Data last refreshed date is included in the top right to ensure the user can quickly check when the data was last refreshed.
65+
- Latest reporting period is included in the top right as another key piece of information, this ensures that the user knows when the data will display up until, even if the data was refreshed more recently.
66+
- The purpose of the report should give context to how the report came about, and what it hopes to achieve.
67+
- A nudge theory box directing the user, to encourage the user to next access the summary page or help direct the user’s journey within the dashboard.
68+
- The customer area should clearly state who the main users are and their interest in the data.
69+
- A contact section for users in case of queries, feedback, training needs or technical support.
70+
- An insight generator for users to ask questions and generate insights from the data.
71+
72+
### Data details section
73+
74+
The Data Details section has been designed to inform the user further on the details of the data, enabling data literacy and aiding understanding and therefore use of the report.
75+
76+
It includes the following:
77+
78+
- Methodology, for example, around the collection of data, or data included in the report.
79+
- Any assumptions made to the datasets.
80+
- Data source details, including various data sources, the date the data was last refreshed, the latest reporting period and number of records (which is useful to see if there are any issues, for example, if less records are showing than expected).
81+
- Data Dictionary details, and a link so that users can see definitions of the data and formats. This helps users to see the data lineage and understand the metadata behind the reports.
82+
- Glossary details around the terminology used, and a link so that users can access and understand relevant terminology included in the report.
83+
84+
### Updates section
85+
86+
The Updates section is designed to help inform users on relevant news, release updates, and any other ongoing updates beneficial to the user.
87+
88+
It includes the following:
89+
90+
- Relevant news to help inform users on key events which could have had an impact on the data shown.
91+
- Links to relevant NHSBSA sites and news.
92+
- Release notes relating to the dashboard version numbers so that users are informed of new features, improvements, or bug fixes.
93+
- Announcements could be included in this section, for example if the NHSBSA has been made aware of an issue, and a fix is working to be put in place.
94+
95+
### How to use section
96+
97+
The How to use section is relevant especially for users who have limited technological literacy and may not be as familiar with the reporting software used. It aims to help guide users, limit support needed, maximise usage and optimise intake of the dashboard and information shown. Please see the [Power BI User Hints standards](../../power-bi/standards/user-hints/) as an example of information to include on a How to use page.
98+
99+
It includes the following:
100+
101+
- Dashboard functionality to give details on functions within the dashboard, for example, users may not be familiar with drill down functionality and how to access it, therefore might miss this feature and other insights if not prompted to look and use this function.
102+
- Links to relevant articles or training courses could be useful, for example, NHSBSA training courses sign up or Microsoft could be referenced for Power BI reports.
103+
- Accessibility hints could be included in this section, for example, how to change from a chart format to a table.
104+
105+
[info 0]: https://bsa2468.atlassian.net/wiki/spaces/CoP/pages/1559396709/STAGE+3+-+Accessibility+Statements
106+
[info 1]: https://nhsbsauk.sharepoint.com/sites/DigitalContentDesignTeam/SitePages/NHSBSA-digital-style-guide-and-standards.aspx
107+
[info 2]: https://www.gov.uk/government/publications/inclusive-communication/accessible-communication-formats#accessible-print-publications
108+
[info 3]: https://www.england.nhs.uk/nhsidentity/identity-guidelines/fonts/
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,29 @@
1+
---
2+
layout: article
3+
title: "Layout of a dashboard: Reporting"
4+
description: "Overview of the report pages to include in NHSBSA reports"
5+
status: DRAFT
6+
tags: dv-dashboard-layout
7+
order: 2
8+
---
9+
## Reporting pages
10+
11+
The layout of the reporting pages are used as a guide of what a layout could look like.
12+
13+
### General layout
14+
15+
Features of the reporting pages include the following:
16+
17+
- A filter section: in the example shown this is on the left. Filters as best practice should either be on the left-hand side or as a banner across the top of the page. Considerations on the real estate of the page are important to consider in placing filters. Global filters should be prioritised and included first in this section, with more specific filters following below. Specific filters relating to a singular chart should be placed close to the chart on the right-hand side opposite the title of the chart. Please consult the filter guidance for further information.
18+
- A separation line has been included to clearly define sections.
19+
20+
### Summary/highlights section
21+
22+
The summary/highlights section should be a straightforward summary page which informs the user of key insights and important insights to note.
23+
24+
The example template includes the following:
25+
26+
- KPI cards for some initial summary statistics.
27+
- A sensible header layout, following the visual hierarchy. For example, header 1 then header 2 within the same section.
28+
- Charts should help give further information to the summary statistics shown.
29+
- There should be a prompt to look further into the details of the data, helping to guide the user on their journey.
Loading
Loading
Loading
Loading
Loading
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
layout: article
3+
title: "Filters"
4+
description: "Standards for using filters at the NHSBSA"
5+
status: DRAFT
6+
tags: data-viz-home
7+
order: 80
8+
review:
9+
last_reviewed_date: 2024-12-20
10+
review_cycle: ANNUAL
11+
---
12+
## Filter purpose
13+
14+
Filters should only be used when needed and to add to the value of a dashboard. Due to this, the number of filters on a dashboard should be limited.
15+
If there are more than three filters on a dashboard this can take away the value and visual impact of the message and distract a user.
16+
17+
Features such as parameters can be created and used to change variables used within a chart. Slicers and filters can be included.
18+
19+
![Example report showing slicers and filters](filters-1.png)
20+
21+
To ensure data literacy in our end users, and developers, any filters applied should always be clearly stated on the dashboard or report. For example, on Oracle Analytics Classic a disclaimer may be added onto the dashboard.
22+
23+
![Example of an Oracle Analytics Classic disclaimer](filters-2.png)
24+
25+
## Placement of a filter
26+
27+
Filters as best practice should be positioned as a banner across the top of the page starting from the left, as focus naturally falls to the left, or on the left-hand side. Having the filters on the left-hand side can take up unnecessary space. Considerations on the real estate of the page are important to consider in placing filters.
28+
29+
::: details Source - dashboard design
30+
31+
[The Dos and Don'ts of Dashboard Design][filter 1]
32+
33+
:::
34+
35+
Icons can be used to hide filters if needed, if an icon is used the purpose of the icon should be stated for example, by accompanying text such as ‘Click the filter icon to filter the dashboard’. The icon should also have alternative text provided stating the purpose of the icon. If you have more than three filters on your page, using an icon can be a good way to hide the filters, and have the filters pop-out when the icon is clicked. This can offer usability and flexibility within your report.
36+
37+
Global filters should be prioritised and included at the top left of a dashboard, or first in a filter section, with more specific filters following below. Specific filters relating to a singular chart should be placed close to the chart in the right-hand side top corner opposite the title of the chart, aligned with the visualisation itself.
38+
39+
![Example of filter placement](filters-3.png)
40+
41+
Within some data visualisation tools filter panels can be included which may use less resource within your report. However, with a standard in-built filter you cannot customise the pane.
42+
43+
Visualisations themselves can also be used as a filter. Many data visualisation tools have this inbuilt functionality.
44+
45+
::: details Source - best practices
46+
47+
[Dashboard Design Best Practices][filter 2]
48+
:::
49+
50+
## Design of a filter
51+
52+
A filter should be used to enable functionality of a dashboard for a user, but not distract from the main content.
53+
54+
- The filter should clearly state its purpose. A label as a header, such as ‘Contact type filter’ is useful.
55+
- A user should always be able to clearly tell which filters are in place. To do this, use dynamic titles on your charts.
56+
- A ‘clear selection’ button in the top right-hand side of the screen is optional. This is to allow the user to quickly remove any filters applied and ensure that the report can be quickly set to be unfiltered should a user need this:
57+
58+
![Example of a 'clear selection' button](filters-4.png)
59+
60+
- A font size of 11px should be used to Header the filter.
61+
- Frutiger or Arial should be used as the font, consistent with the rest of your report.
62+
- Filters should be of equal widths and heights if possible.
63+
- No borders or shadow borders should be used on a filter so as not to distract the user with additional ink to look at.
64+
- Filters should have a white background.
65+
- If the filter includes a timeline, NHS Blue (#005EB8) should be used.
66+
67+
![Example of a timeline filter](filters-5.png)
68+
69+
[filter 1]: https://towardsdatascience.com/the-dos-and-donts-of-dashboard-design-2beefd5cc575
70+
[filter 2]: https://chartio.com/blog/dashboard-design-best-practices-the-dashboard-layout/
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,12 @@
1+
---
2+
layout: article
3+
title: "KPI cards"
4+
description: "Standards for using KPI cards at the NHSBSA"
5+
status: DRAFT
6+
tags: data-viz-home
7+
order: 85
8+
review:
9+
last_reviewed_date: 2025-01-10
10+
review_cycle: ANNUAL
11+
---
12+
## Layout
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Loading
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,92 @@
1+
---
2+
layout: article
3+
title: "Collaborative working"
4+
description: "Best practices for working collaboratively using Power BI"
5+
status: DRAFT
6+
tags: pbi-best-practice
7+
order: 10
8+
---
9+
## Version control
10+
11+
For dashboards which are being developed by more than one developer, it is possible for individuals to work on separate sheets in separate dashboards, likely a duplication of the dashboard (accessing to the same data set), developers would then copy the elements into a final dashboard. To do this, it is essential to manage the version control of dashboards, ensuring that dashboards are dated and the changes made to a dashboard are detailed for clarity when merging the dashboards.
12+
13+
## Git integration
14+
15+
[Power BI Desktop projects][link1] is currently in preview, which includes Git integration (a version control software). There are some pre-requisites to using Git included in the link provided. This allows changes to be merged using typical Git functionality. One of the advantages of Fabric is that it beings Git integration to Power BI which should allow more managed collaborative working once Fabric is more widely rolled out.
16+
17+
## Power BI Explorer
18+
19+
[Power BI Explorer is a free tool you can install on your machine][link2]. For dashboards which are being developed by more than one developer, you can create a copy of the dashboard and then compare changes, or compare changes of your report using Git. You can follow a tutorial within the tool itself.
20+
21+
### Comparing reports
22+
23+
Compare reports allows you to see two reports side by side and compare any changes between the two. The visuals and items each have a code which helps to track their changes across the dashboard versions.
24+
25+
You can point this at a Git repository to compare versions, meaning you would not need to keep multiple versions of the same file. For Git, Power BI Explorer knows if your file is in a Git repository which allows you to see changes from a point in time, for example, to compare an uncommitted report to a committed report.
26+
27+
- Select 'Compare report' from the Power BI Explorer landing page. It is the second box from the left in the centre of the screen.
28+
29+
![Power BI Explorer landing page](../images/exp1.png)
30+
31+
- Select the reports you wish to compare.
32+
33+
![Report comparison page](../images/exp2.png)
34+
35+
- Expanding Pages to see which pages have been added/removed/amended:
36+
37+
![Example of expanded Pages view](../images/exp3.png)
38+
39+
This section works like Git in that items highlighted in red have been removed, and items highlighted in green have been added.
40+
41+
- You can click on items under Visuals and see where they are positioned on the screen.
42+
43+
![Example report comparison page](../images/exp4.png)
44+
45+
- You can compare an overview of the pages included in each version.
46+
47+
![Example overview comparison](../images/exp5.png)
48+
49+
- You can refine what is shown and what you wish to compare in the drop down. Options for the refine and compare drop down box include: "Show added items", "Show deleted items", "Show modified items", "Show identical items", "Hide minor changes (tab order)", "Hide minor changes (positioning)".
50+
51+
![Example drop down box refining selection](../images/exp6.png)
52+
53+
![Example drop down options.](../images/exp7.png)
54+
55+
### Inspecting reports
56+
57+
This section gives a breakdown of pages and visuals.
58+
59+
- Select 'Inspect report' and load in your .pbix file. It is the leftmost box in the centre of the screen.
60+
61+
![Inspect report page](../images/exp8.png)
62+
63+
- The Summary page gives you information on: Pages, Visuals, Fields, Filters, Issues and Themes.
64+
65+
![Example summary page](../images/exp9.png)
66+
67+
- The Details tab gives further information. You can see a wireframe of the dashboard, and when you select a visual: dimensions, x/y/z coordinates and drilldown functionality.
68+
69+
![Example details page](../images/exp10.png)
70+
71+
Values such as dimensions, categories, series can be checked against the default values to see if any values have changed.
72+
73+
- Interactions between visuals can be shown.
74+
75+
![Example showing interactions between visuals](../images/exp11.png)
76+
77+
When you hover over some of the visuals the inbound and outbound interactions are highlighted between visuals. These interactions would otherwise be invisible on Power BI Desktop.
78+
79+
Inbound interactions are shown with yellow arrows pointing into the visual in question.
80+
81+
![Inbound interactions example](../images/exp12.png)
82+
83+
Outbound interactions are shown with blue arrows pointing out from the visual in question.
84+
85+
![Outbound interactions example](../images/exp13.png)
86+
87+
'Track usage' in the Data Model Explorer shows which variables are being used and where.
88+
89+
![Track usage pane example](../images/exp14.png)
90+
91+
[link1]: https://learn.microsoft.com/en-us/power-bi/developer/projects/projects-git
92+
[link2]: https://www.pbiexplorer.com/

0 commit comments

Comments
 (0)