Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Projector requires a specific setup of PowerBI in order to show dashboards within our platform. It must meet the following requirements:

  1. PowerBI Pro - at least one user needs to be on a Pro account.

    Warning
    titleTwo Factor Authentication

    Two-factor authentication must be OFF for this user

    .


  2. Microsoft Azure - you have an Azure subscription


  3. App Owns Data PowerBI instance tied to Azure - if you don't already have

    one

    a PowerBI instance tied to Azure you can create one using this link https://app.powerbi.com/embedsetup/

    appownsdataAfter creating your application note the Application ID and Workspace ID

    appownsdata 

    Tip

    If you already have an application you can get the application ID from https://portal.azure.com/#blade/Microsoft_AAD_RegisteredApps/ApplicationsListBlade. You can get the workspace ID by logging into https://app.powerbi.com and opening the workspace tied to your Azure application. Look in the URL for the workspace ID.

     

     If you aren't sure if your PowerBI is tied to an App Registration, it's easiest to follow the link above and create a new one. You can publish your existing reports to the new space.


    1. When creating your application request API permissions for the following


      Image Added

    2. After creating your application note the Application ID and Workspace ID

  4. API Access Enabled - under your App Registrations in Azure, open your application and go to API Permissions. If there are currently no permissions you requested permissions as suggested above you'll want to choose PowerBI Embedded PoC. Then Delegated Permissions. You'll need the following permissions at a minimum (tbd). Finally, you'll need to grant Admin Consent to your Azure account.need an administrator to grant them. If you already have an app, grant the permissions by click Add a permission | Delegated permission | Select the Read permissions | click Grant admin consent for

     
    Image Added
  5. User set to Admin - If the user accessing content via the API isn't already a workspace Admin, make them one at https://app.powerbi.com | Workspaces | Access.
    Image Added

Create PowerBI Content

If you do not already have content in your PowerBI instance, create at least one report. If everything is configured correctly you should see that reports are owned by the application and not by a specific user. In the screenshot below the name of our registered application is Power BI Embed PoC. If you don't have any published reports, or don't know how to get to this screen, we'll cover that in the next few sections.Image Removed

You can author PowerBI content on either their website at https://app.powerbi.com or via their desktop software.

Image Added


Point Projector at PowerBI Instance

...

  1. Enter your application ID - if you do not know your ID see https://docs.microsoft.com/en-us/power-bi/developer/embed-sample-for-your-organization#application-id
  2. Click Set Credentials and enter your username and password - requires the use of a Master Account with a PowerBI Pro license. Enter the master account's case-sensitive username and password here. Two-factor authentication is not supported
  3. Restart Management Portal

Get PowerBI

To author PowerBI content you will need to install their desktop software.


Pull Projector Data into PowerBI

Tip

PowerBI pulls data from Projector's reports tab. If you don't already have a Projector report accessible over the web, make one.

The following examples use PowerBI's desktop software.

Use Get Data | Web to connect to your Projector data. 

...

Log into Projector Web as the user. On My Home Page you should see your PowerBI dashboard displayed.


Filters

Projector can dynamically filter displayed content. For example, you might have a dashboard that shows holidays balances for all your resources. But when displayed on My Home Page you only want to display data about the current resource. This is where filters come in.