Guidelines Document
Introduction
This document provides guidelines on how to use Power BI as a presentation layer for Workbench data, leveraging Sharperlight as a secure querying tool. This setup ensures that all data accessed and displayed through Power BI is securely extracted, transformed, and delivered without exposing direct connections to the database.
Objective
To enable users to create dynamic reports and dashboards in Power BI while ensuring data security and system performance through the integration of Sharperlight.
System Architecture
Workbench Database: Contains all operational data.
Sharperlight: Acts as an intermediary that queries, transforms, and securely exposes data to Power BI.
Power BI: Used for visualising and analysing data provided by Sharperlight.
Getting Started
Setup Sharperlight:
Ensure Sharperlight is installed and properly configured to interact with the Workbench database.
Define and configure the data models within Sharperlight to align with the reporting requirements.
Data Security and Performance:
Use Sharperlight to manage data access permissions and ensure secure data handling practices.
Utilize Sharperlight’s capability to abort slow-running queries and to stage data for long-running operations to maintain system performance.
Methods to get data from Sharperlight
There are two ways to communicate between PowerBI and Sharperlight
Custom Connector (PQX) file
Using plain JSON Sharperlight Output. Recommended
The Custom Connector (PQX) is much more challenging to setup and maintain. We recommend using the JSON approach where possible. It allows end users to refresh to get the latest data from the Web and scheduled refresh can also be setup.
Both methods take snapshots of the query data and must be refreshed to get the latest report structure or data.
Connecting Power BI to Sharperlight:
The Power BI or JSON/Web URL can be accessed by either: Right-clicking in the Publisher query list or from the Links tab when you are inside a query.
JSON / Web connection:
In Power BI: Select “Get data from another source”.
Find & Select “Web” as datasource.
Enter the secure endpoint URL provided by Sharperlight that points to the required data model.
Choosing this option means:
You can only bring in one Sharperlight query per JSON link during initial setup.
End users can refresh themselves on the Web to get latest structure & data.
Can schedule refreshes (Up to 8 times per day).
Guidelines for Effective Use
Creating Reports in Power BI:
Use Power BI Query Editor to Expand query records: List -> To Table -> Expand:
Use the Power BI interface to drag and drop fields from the Sharperlight data source into the report canvas.
Apply filters, slicers, and other data visualisation tools available in Power BI to enhance your reports.
Data Transformation:
Perform necessary data transformations in Sharperlight before exposing the data to Power BI.
Use the standard data model provided by Sharperlight to ensure consistency and accuracy of the data transformations.
Publishing and Sharing Reports:
Once reports and dashboards are created, they can be published to the Power BI service for sharing with other users.
Ensure that access to published reports is managed according to the security policies defined in Sharperlight.
Maintaining and Updating Reports:
Regularly update the Sharperlight Workbench data model and Power BI reports to reflect any changes in the source systems or business requirements.
Monitor the performance of the reports and make adjustments to the Sharperlight queries as needed.
If a wrong authentication method is accidentally selected
Go into the "Data Source Settings" in Options & Settings.
Select the Data Source that you entered incorrectly.
Click “Clear Permissions” to clear that data source.
Re-do steps in Page 2 again.
Refreshing the Report
Once the report has been published, you can trigger a manual refresh or schedule a refresh from the web if you have connected the Data Source via JSON/Web. Attempting to refresh a Data Source via Power BI link on the Web will result in an error.
Before setting up a Scheduled Refresh, a Cloud Connection needs to be setup using your Sharperlight credentials as shown below:
Once the Cloud Connection has been created and selected, you can then define your Scheduled Refresh:
To view the report, click
Best Practices
Regularly Review Security Settings: Ensure that all data endpoints and transformations adhere to the latest security protocols.
Optimize Data Models: Regularly review and optimize Sharperlight data models for performance and accuracy.
Training and Support: Provide ongoing training and support to users creating reports in Power BI to ensure they are fully equipped to use the tools effectively.
Integrating Power BI with Sharperlight at Workbench enables a powerful, secure, and efficient way to handle custom reports. By following these guidelines, users can leverage the full capabilities of both platforms while ensuring data security and system performance.
Integrating Power BI with Sharperlight at Workbench enables a powerful, secure, and efficient way to handle custom reports. By following these guidelines, users will be able to leverage the full capabilities of both platforms while ensuring data security and system performance.