Configure PowerBI.com integration with D365FO
Configure PowerBI.com integration
05/12/2020
Overview
Users can pin tiles, dashboards, and reports from their own PowerBI.com account to application workspace.
This functionality requires a one-time configuration of your environment. An administrator must do this step to enable Microsoft Power BI to communicate and authenticate correctly.
For a workspace to show a Power BI tile, the server must contact the Power BI service on behalf of a user and access the visualization. It must then redraw the visualization in the application workspace. The fact that the server contacts the Power BI service "on behalf of a user" is important. When a user, such as[email protected]
By completing this configuration step, you enable to contact the PowerBI.com service.
Things you must know before you start
- You must be a system administrator in the application. This option is available on theSystem administrationmenu.
- You must have a PowerBI.com account. You can create a trial account if you don't have an account. (A Pro license isn't required for this configuration step.)
- You must have at least one dashboard and one report in your Power BI account. Although the dashboard and report aren't required for this configuration step, you might not be able to validate the configuration if you don't have any content in your PowerBI.com account.
- You must be an administrator for your Microsoft Azure Active Directory (Azure AD) account. If you aren't the administrator, an administrative user must perform this configuration step for you.
- The Azure AD domain that is configured must be the same domain that you used for your PowerBI.com account. For example, if you provisioned the application in the Contoso.com domain, you must have Power BI accounts in that domain, such as
[email protected].
Registration process
- Sign in tohttps://portal.azure.com/using an Azure tenant admin account.
Note
The user who completes this procedure must have Admin rights for the tenant to register applications.
-
Go toAzure Active Directory>App registrations>New application registration.
-
Enter the following values:
- Name- Your app name.
- Application type- Web app/API
- Sign-on URL- The base URL of your client. For example,
https://contosoax7.cloud.dynamics.com.
Note
Depending on your version, you may need to add /oauth as a suffix to the URL, or use http instead of https as the protocol, such as:https://contosoax7.cloud.dynamics.com/oauthorhttp://contosoax7.cloud.dynamics.com/oauth.
-
ClickCreate.
-
Copy theApplication ID. This will be used to connect to the PowerBI.com service.
-
ClickSettings>Required permissions>Add>Select an API>Power BI Service (Power BI).
-
ClickSelect.
-
Enable Access and clickSelect.
-
ClickDoneand then clickGrant Permissions.
-
ClickSettings>Keys.
-
Enter a value forKey descriptionandExpires, and then clickSave.
Make a note of theApplication IDandApplication Key. You will use these values in the next procedure.
Specify Power BI settings in Finance and Operations
-
In the client, open thePower BI configurationpage.
-
SelectEdit.
-
Set theEnabledoption toYes.
-
In theApplication IDfield, enter theApplication IDvalue that you got from Power BI in the previous procedure.
-
In theApplication Keyfield, enter theApplication Keyvalue that you got from Power BI in the previous procedure.
You can apply the company filter only if your Power BI content has a table that is namedCompanyand a column that is namedID. Ready-made Power BI content that is released uses this convention.
-
ClickSave.
Complete the steps in the next section to verify the changes and enable PowerBI.com integrations.
Pin tiles to a workspace
- To validate the PowerBI.com configuration, clickGet started.
Note
You may need to refresh the browser to apply the changes.
If you're starting Power BI from the application for the first time, you're prompted to authorize sign-in to Power BI from the client. SelectClick here to provide authorization to Power BI.
Users must complete this step the first time they pin Power BI content.
-
The Azure AD consent page asks for your consent. User consent is required for the application to access PowerBI.com on behalf of the user. SelectAccept.
-
Because you're already signed in to Azure AD, you don't have to enter your credentials again. A new tab appears, where you're prompted to authorize the connection between the application and Power BI. Authorize the connection, and then return to the original tab.
-
A list of tiles from your PowerBI.com account appears. Select one or more tiles to pin to the selected workspace.
Troubleshooting common errors
In the procedure above, after you clickAccept, you might receive the following error message if the process is unsuccessful. Note that the details of the error appear at the bottom of the message. Additional technical information provides clues that can help you determine what went wrong.
Some common issues and the resolution steps
| Error | Resolution |
|---|---|
| The Power BI service is unavailable. | This issue doesn't occur very often, but the Power BI service might sometimes be unreachable. You don't have to re-register. Try to pin a tile to a workspace later. |
| You can't access the application. | You probably didn't select all the check boxes underStep 8 in the Registration processduring the registration process. Start Power BI, and re-run the registration process. |
| The Power BI tiles page is empty (no content is shown). | Your PowerBI.com account might not have a dashboard or any tiles. Add a dashboard, such as a sample dashboard, and try to pin a tile again. |
| Error when authorizing Power BI | On the Azure Admin dashboard, underUsers and Groups > User settings, make sure that theUsers can consent to apps accessing company data on their behalfoption is set toYes. |