How to create an App Registration: https://learn.microsoft.com/en-us/entra/identity-platform/quickstart-register-app
Power BI Service:
Dataset.Read.All
Report.Read.All
Workspace.Read.All
Setting up the integration:
1. On the left side menu, choose the Integration option.
2. Find the Power Bi Enterprise, and press the Configure button, to start the setup. Make sure its the Power BI Enterprise version.

3.Choose whether you want to run with Authorize with Microsoft or your own App Registration. Then click on Save.

4. The integration will then take you to the next step, but first you need to either authorize with your Microsoft account, or set up your app registration. To do so, press the Settings button.
5. It will then take you back to the settings, where you either press the Authorize button, and allow your Microsoft account to login, or if you choose to use the app registration fill in the field on the page. When finished, remember to press the Save button at the bottom of the screen.

6. When done with authorization, our service user with the name Q-Play PowerBi Integration will now be available, you then need to give it access to your shared workspace, otherwise the integration won’t work.
7. If you want to use static screenshots of your work, you then need to create a report in the integration of each specific work you want to show. Do this by going to settings, then pressing the + in the green bar in the middle of the screen.
8. Then in the Script dropdown menu, choose Report, now give your report a descriptive name so you can easily remember what that report is about. You will then need the Report ID and Workspace ID, to find these, all you need is your URL to the report.
Example of how to find your Report ID and Workspace ID from your URL.
Our sample URL will look like this:
The Report ID you will find after the /reports/, so in this case our Report ID is:
a0169bf5-c6d6-4b8b-8afe-cfba638d744b/2d4406d49bd9acade258
The Workspace ID you will find in between the /groups/ and the /reports/, so in this case our Workspace ID is:
a9351ad7-83a7-47be-b4a2-fe425a8c5c25
If this report is only going to be screenshots, then press the Enable screenshot functionality box.
You then need to choose your schedule type, you have two options:
- On-demand;
- This option is best suited if you want to show more than just this one report, in the same presentation. This option means that every time the presentation shows this report, the screenshot will get updated – within the Resource timeout limit. With a standard subscription, you can choose between 1 hour and 30 min. If you need a faster update time, please contact us to get the options unlocked.
- Scheduled;
- This option is best suited if you only want to show this one report, in your entire presentation. This option means that the integration will refresh the screenshot at a set time interval – with a standard subscription, you can choose 1 hour. If you need a faster update time, please contact us to get the options unlocked.
1. In a new page in your presentation, find the Power Bi Enterprise app, then press it to get an instance of it. Make sure you select the Enterprise version of the app, and not the standard version – otherwise your new Enterprise integration won’t work.
2. In the Template settings, choose whether you want Live – dashboard, or Screenshot – report.
3. Then choose which report or dashboard you want to show, by choosing in the dropdown menu – Embed is for live dashboard, Screenshot is for static reports.
4. You can then customize the app to your liking in the App Settings, and your new Power Bi Enterprise is all set up!
FAQ:
Q: I’m getting a 401-error when trying to run the script.
A: Make sure that the user who authorized with Microsoft, has a Power Bi Pro license, otherwise you will get the 401-error. Also, make sure that the Q-Play PowerBI Integration service user has access to the correct shared workspace.