To use the content sharing features in ArcGIS for Power BI, your Microsoft account should include a Power BI Pro or Premium plan with capabilities to publish reports. Users without this plan cannot embed or publish reports to the web.
You can embed a map-enabled ArcGIS for Power BI report containing private, secure, or proprietary ArcGIS data in a secure website or app. Viewers of the report must sign in to an ArcGIS account to view it.
Sharing reports containing private, secure, or proprietary data requires viewers to sign in to their ArcGIS account. If the report contains public data only, see the Publish a map-enabled report to the web workflow.
After you create a map-enabled report, use the Embed report option to embed it in a secure website or app outside the Microsoft Power BI environment. Although users typically use Power BI Desktop to create reports, this workflow is also available in the Power BI service (powerbi.com).
Requirements
To embed a map-enabled report, the following requirements must be met:
- It is very important to note that the Power BI data used to create the ArcGIS for Power BI map must use latitude and longitude coordinates for locations or Esri JSON or GeoJSON in the Location field well. If the Location field well contains addresses or standard boundaries, you can't embed a map-enabled report, and the whole map will need to be re-created.
- You must be signed in to a valid ArcGIS account with a user type and role that has been granted appropriate permissions by your account administrator to publish content.
Note:
For ArcGIS users, both user role and type, should be Creator or higher when you want to edit the map and save the changes.
To embed or publish to the web, you must create and save a map with an ArcGIS Online or ArcGIS Enterprise Creator or higher account.
- An embedded map can contain a maximum of 30,000 locations.
- You must run the ArcGIS for Power BI embed check before generating an embed code for the report.
Create and validate a map-enabled report
Use Power BI Desktop or the Power BI service (powerbi.com) to create a map-enabled report. Before you can embed the report, run the embed and publish validation in the ArcGIS for Power BI visualization to ensure that all requirements are met.
To create and validate a map-enabled report for embedding in a website or app, complete the following steps:
- Sign in to your ArcGIS account and create and save a Microsoft Power BI report that includes an ArcGIS for Power BI map.
- From the map tools, click Embed
.The Embed pane appears with the Embed and publish validation tab visible by default.
- The embed check verifies that all requirements for embedding the map have been met, including whether the Power BI location data is in latitude and longitude coordinates or Esri JSON and GeoJSON.
- If there are no errors, you will see a
Ready to embed message in the pane.Items that do not meet the requirements appear with a red cross
.
Embed the validated map-enabled report
Once you create and validate the map-enabled report, you can publish it to the Power BI service. The report must be in the Power BI service (powerbi.com) to enable embedding. You generate an embed link associated with the report and copy the resulting code to your site or app.
You must open the report in the Power BI service and save the report before you can publish it to the web or embed it in a website, whether you're working with a new or existing report. This allows ArcGIS for Power BI to verify that the requirements for publishing or embedding are met.
Learn more about embedding a report web part in SharePoint Online
Learn more about embedding a report in a secure portal or website
To view the embedded content, viewers must sign in to Power BI. If the report contains secure content from ArcGIS, they must also sign in to an ArcGIS account.
Embed blocking page
The blocking page appears in the following scenarios:
- Your credentials expired when trying to embed a report, or you are signed out.
- You added unsupported location data.