- 03 Apr 2023
- 4 Minutes to read
- Print
- DarkLight
- PDF
Power BI Extract
- Updated on 03 Apr 2023
- 4 Minutes to read
- Print
- DarkLight
- PDF
SysAid’s Power BI Extract integration allows you to regularly export your SysAid SR data to your storage method of choice;
Option 1: Display your SR data as a JSON file and store it in your OneDrive, where Microsoft Power BI will read it and build the reports.
Option 2: Use our API that allows you to securely access the URL with your saved JSON file.
Power BI Extract video
Licensing
You can contact your account manager to purchase a license or a 30-day trial license for this Add-on.
Set up the Power BI Extract Add-on
Steps
- From the SysAid Marketplace, get the Power BI Extract Add-on.
- On the main My Apps page, in the Power BI Extract icon, click
.
- Register the application in Azure
- In the Azure dashboard, click App Registrations.
- Click View All Applications.
- Click New Registration.
- In the Name field, enter a name for the application (for example "SysAid BI").
- Click Register.
- Get the Tenant ID
- Hover over the Directory (tenant) ID field and click
.
- Back in SysAid, paste the copied text into the Tenant Name field.
- Hover over the Directory (tenant) ID field and click
- Get the Client ID
- Hover over the Application (Client) ID field and click
.
- Back in SysAid, paste the copied text into the Client ID field.
- Hover over the Application (Client) ID field and click
- Get the Secret Key
- From the Left-menu, click Certificates & Secrets.
- Click New client secret.
- Add a description (e.g. "SysAid Power BI Extract").
- In the Expires area, select Never.
- Click Add.
- In the entry you just created, click
.
- Back in SysAid, paste the copied text into the Secret Key field.
- In the Email address field, enter the email address for the administrator's MS OneDrive account.
- Enter the name you want for the JSON file that will be created with the BI data from SysAid. Make sure the file name includes the extension .json (for example, "SysAidData.json").
- Configure API Permissions
- In Azure, navigate to select API Permissions.
- Click Add a permission.
- Click Select an API > Microsoft Graph.
- Click Application.
- Select the following permissions
- ReadWrite.All
- Files.ReadWrite.All
- Select the respective type for each permission.
- Enable the following permissions:
- Click Save Changes.
- Click the slider to activate the Add-on.
- Click Test Connection to ensure that everything has been configured correctly. The results appear at the top of the screen.
- (Optional) You can click
to manually import BI Data to the JSON file.
- The Last Updated field indicates when the file was last updated.
Import SysAid Storage data to Power BI
Steps
1. Create a Blank query in Power BI
2. Open the Query's Advanced Editor
3. Paste the Query script inside the Editor
let Source = Table.FromColumns({Lines.FromBinary(Web.Contents("Paste the URL from POWER BI Extract addon", [Headers=[clientid="Clientid from POWER BI Extract addon", accountid="Your SysAid account id", authorization="The Token from Power BI Extract addon"]]))}), #"Parsed JSON" = Table.TransformColumns(Source,{},Json.Document), #"JSON to List" = #"Parsed JSON"{0}[Column1], #"List To SysAid Table List" = Table.FromRecords({#"JSON to List"}), #"Expanded SysAid" = Table.ExpandListColumn(#"List To SysAid Table List", "SysAid"), #"Extract Headers" = Record.FieldNames(#"Expanded SysAid"[SysAid]{0}), #"Merge Data To Table" = Table.ExpandRecordColumn(#"Expanded SysAid", "SysAid", #"Extract Headers") in #"Merge Data To Table"
4. Select all cells and click on "Detect Data Type"
5. Close the Editor and apply your changes
Click here to download a ready-to-go Power BI Template file that you can use to generate dashboards with your SysAid data.
If you encounter any issues with loading this template, ensure that "Application language" in your Power BI Regional Settings is set to English (United States). For any other issues importing your data into Power BI, we recommend referring to the Power BI community.
Map additional SysAid fields to Power BI
The BI Analytics Settings section allows you to map additional fields to be included in your Power BI data extract.
When you map a field to one of the Target BI Fields, that field can be accessed by Power BI Extract. By default, only the List fields are available (as "cust_list 1" and "cust_list 2) in Power BI Extract. To access additional fields, contact your account manager.
Changes made here take affect on new data collected by Power BI Extract from the time you make the changes and onward. To apply new field-mapping on historical data, please contact SysAid Support.
To map a field to Power BI Extract
- Locate the field in the Source Field column in the dropdown list corresponding to its field type.
- Select the field from the list.
- Click Save Changes.
Export data to SysAid Cloud
The SysAid Storage functionality allows you to export your data to SysAid Cloud and obtain secured access for it.
This is done by adding three headers to the URL and, one of which is a token that is valid for three months.
Import data from a webpage
You can choose the option in Power BI to import data from a webpage, using the parameters highlighted below;
These can be edited or added in Settings > Monitoring > Notifications