Skip To Content

配置 ArcGIS for Power BI

您必须是 ArcGIS for Microsoft 管理员,才能使用本主题中描述的工作流。

配置 ArcGIS Enterprise 跨域资源共享

ArcGIS Enterprise 支持跨域资源共享 (CORS) 以允许不同域上的 web 应用程序访问其资源,但是出于安全考虑,需要将门户和服务器配置为仅允许受信任域。

注:

在某些情况下,当您使用 ArcGIS Enterprise 账户登录到 ArcGIS for Power BI 时,有效 ArcGIS Enterprise URL 未连接,并显示无效 URL 错误。 此错误仅适用于 ArcGIS Enterprise 账户。 默认情况下,ArcGIS Enterprise 门户允许使用跨域资源共享 (CORS) 的跨域请求。 这意味着,JavaScript 客户端(例如在任何域中托管的 web 应用程序)可以连接至门户资源。

ArcGIS Enterprise 登录错误消息

要限制来自 JavaScript 应用程序特定域的请求,ArcGIS Enterprise 管理员可以通过将这些域名添加至 ArcGIS Enterprise 门户安全设置中的允许源列表,将门户配置为仅允许某些指定的域。 这样可降低未知应用程序向 web 服务发送恶意命令的风险。

根据 ArcGIS Enterprise 的版本和正在使用的 Power BI 连接,ArcGIS Enterprise 管理员可能需要启用并配置 CORS,ArcGIS for Power BI 才会正常工作。

Power BI 服务的允许源 (app.powerbi.com)

ArcGIS Enterprise 管理员必须配置允许源设置,才能配置组织成员从 Power BI 服务 (app.powerbi.com) 登录到 ArcGIS Enterprise

必须包含以下域:

  • https://arcgis.com
  • https://app.powerbi.com
  • https://powerbi.com

“允许源”设置

有关详细信息,请参阅限制对您的门户的跨域请求

Power BI Desktop 的允许源

ArcGIS Enterprise 管理员必须配置允许源设置,才能设置从 Power BI Desktop 登录到 ArcGIS Enterprise 的组织成员用户权限。

必须包含以下域:

  • https://arcgis.com
  • https://app.powerbi.com
  • https://powerbi.com
  • http://pbi.microsoft.com
  • https://pbi.microsoft.com
  • ms-pbi://pbi.microsoft.com
  • https://ms-pbi.pbi.microsoft.com

用于执行此配置的步骤将有所不同,具体取决于您使用的 ArcGIS Enterprise 版本。

美国政府云配置

在美国政府云中使用 ArcGIS for Power BI 的组织具有特定的域权限。 ArcGIS Enterprise 管理员必须配置允许源设置,才能在美国政府云中设置从 Power BI Desktop 登录到 ArcGIS Enterprise 的组织成员用户权限。

必须包含以下域:

  • https://arcgis.com
  • https://app.powerbigov.us
  • https://powerbigov.us
  • http://pbi.microsoft.com
  • https://pbi.microsoft.com
  • ms-pbi://pbi.microsoft.com
  • https://ms-pbi.pbi.microsoft.com

更新 ArcGIS Enterprise 10.8.1 至 10.9 的设置

ArcGIS Enterprise 10.8.1 更新到 10.9 时,ArcGIS Enterprise 管理员必须配置允许源设置。 要更新允许源设置,请完成以下步骤:

  1. 验证您是否已登录 ArcGIS Enterprise 组织,以及是否具有管理组织的权限。
  2. 使用 https://webadaptorhost.domain.com/webadaptorname/sharing/rest URL 登录到 Sharing API。

    注:
    要完成此步骤,必须启用对 Sharing API 的 HTML 访问。 在许多安全环境中,对 Sharing API 的 HTML 访问受到限制。 要启用对 Sharing API 的 HTML 访问,https://webadaptorhost.domain.com/webadaptorname/portaladmin/security/config 下的 disableServicesDirectory 属性必须设置为 false

  3. 登录后,请转至 https://webadaptorhost.domain.com/webadaptorname/sharing/rest/portals/self
  4. 在页面底部,单击更新
  5. 在新加载的页面上,找到允许的源文本框。

    源将由逗号分隔,没有任何空格、引号或方括号。

  6. 将以下文本复制到允许的源文本框以添加 Power BI 源:

    https://arcgis.com,https://app.powerbi.com,https://powerbi.com,http://pbi.microsoft.com,https://pbi.microsoft.com,ms-pbi://pbi.microsoft.com,https://ms-pbi.pbi.microsoft.com

  7. 单击更新组织

Power BI 起点将被添加到允许的起点中。 更改内容将立即生效,无需重新启动门户。

更新 ArcGIS Enterprise 10.9.1 及更高版本的设置

要配置 ArcGIS Enterprise 10.9.1 及更高版本的允许源设置,请按照限制对门户的跨域请求中的说明进行操作。 不需要登录 Sharing API。

系统要求

请查看以下部分以了解所需的软件、ArcGIS 版本、受支持的浏览器以及每个组件使用的地理坐标系。

所需的软件和访问权限

要使用 ArcGIS for Power BI,需要满足以下软件要求:

组成部分所需软件或订阅

ArcGIS for Power BI

Microsoft Power BI for Desktop、Pro 和 Premium,均包含 ArcGIS for Power BI。 某些功能需要更高级别的用户许可。

ArcGIS 版本

有关 ArcGIS 组织账户和用户权限的详细信息,请参阅账户

ArcGIS for Microsoft 支持以下 ArcGIS 版本:

  • ArcGIS Online 当前版本
  • ArcGIS Enterprise 10.9.111.011.1 或更高版本。 有关详细信息,请参阅 ArcGIS Enterprise 产品生命周期
    • 通过物理硬件或虚拟环境进行本地部署

注:

ArcGIS for Power BI 仅在在线环境中进行了测试,未在离线环境中运行。

WebGL 要求

ArcGIS for Power BI 将作为核心可视化部署到 Microsoft Power BI Desktop 和 Power BI 服务 (powerbi.com) 中。 为使 ArcGIS for Power BI 正常工作,Esri 假设已实现这些应用程序的操作配置。 Esri 仅在通过认证的受 Microsoft Power BI 支持的软件环境下测试 ArcGIS for Power BI;并非所有 Power BI 支持的环境均已进行测试或通过认证。

最新版本的最常见桌面浏览器都内置有 WebGL 技术。 使用打开 WebGL,测试浏览器是否已启用 WebGL。 要解决与 WebGL 相关的问题,请访问 WebGL 疑难解答。 由于 WebGL 技术在不断发展,每一浏览器版本都会融入改进的成果,而 ArcGIS for Power BI 正是使用这些改进才能实现最佳性能,因此,您的浏览器需为最新版本。

了解如何验证您的浏览器是否满足 WebGL 要求

受支持的浏览器

ArcGIS for Power BI 支持所有现代浏览器和以下浏览器的最新版本:

受支持的浏览器(最新版本)对于 Standard 用户,随附在 Power BI具有 ArcGIS EnterpriseArcGIS Online 的 ArcGIS 账户
Chrome

Firefox

Safari

Edge

是*

*要将 ArcGIS for Power BIArcGIS Enterprise 配合使用,您必须配置旧版本的 Microsoft Edge(Chromium 之前版本)浏览器以允许该应用程序能够正常运行。 ArcGIS for Power BI 需要 Internet 访问权限;它不能在断开连接的环境中运行。 macOS 仅在在线环境中与 Power BI 兼容。

ArcGIS for Power BI 加密协议

ArcGIS for Power BI 支持以下加密协议:

ArcGIS for Power BI 环境SSL 1.0SSL 2.0SSL 3.0TLS 1.0TLS 1.1TLS 1.2TLS 1.3

Power BI 服务 (powerbi.com)

Power BI Desktop

ArcGIS for Power BI 支持的服务和应用程序

ArcGIS for Power BI 在以下服务和应用程序中可用:

服务和应用程序可用空间

Power BI Desktop

Power BI 服务 (powerbi.com)

Power BI 移动应用程序

是。 可以查看使用访客用户账户创建的地图。 包含 ArcGIS 中高级内容的地图在移动环境中不受支持。

Power BI 发布到 web

是,具有发布报表功能、已登录有效 ArcGIS 账户且具备Power BI Pro 或 Premium 计划ArcGIS for Microsoft 用户。

Power BI 已嵌入

是,具有发布报表功能、已登录有效 ArcGIS 账户且具备Power BI Pro 或 Premium 计划ArcGIS for Microsoft 用户。

Power BI 服务嵌入 (powerbi.com)

否。

Power BI 报表服务器

可用,通过 Report Server 登录到有效的 ArcGIS Enterprise 账户。 这仅适用于在线环境。 不支持离线环境或通过 ArcGIS Online

注:

使用 ArcGIS for Power BI 访问 Report Server 将消耗 ArcGIS 配额

ArcGIS for Power BI 不可用的服务或应用程序中,可视化将显示为具有 Power BI 徽标的空白可视化。

ArcGIS for Power BI 安全网络

ArcGIS for Power BI 可视化依靠多个主机服务器和外部 URL 来执行各种操作,包括对地址进行地理编码、搜索感兴趣点、添加参考图层等。

要确保 ArcGIS for Power BI 在稳定安全的企业级网络中正常运行,需要将以下 URL 添加到您的网络可访问的地址列表中。 HTTPS 连接需要打开 443 端口。

  • https://www.arcgis.com
  • https://basemaps.arcgis.com
  • https://lacdn.arcgis.com
  • https://services1.arcgis.com
  • https://services.arcgis.com
  • https://static.arcgis.com
  • https://utility.arcgis.com
  • https://*.tile.openstreetmap.org
  • https://tiles.arcgis.com
  • https://geocode.arcgis.com
  • https://route.arcgis.com
  • https://geoenrich.arcgis.com
  • https://*amazonaws.com

注:

部分参考图层可以托管在非 Esri 服务器上,如果与非 Esri 服务器的连接被阻止,则这些参考图层可能不可用。

受支持语言

ArcGIS for Power BI 可支持下列语言。

组件语言

阿拉伯语、保加利亚语、加泰罗尼亚语、简体中文、繁体中文(台湾)、克罗地亚语、捷克语、丹麦语、荷兰语、英语、爱沙尼亚语、芬兰语、法语、德语、希腊语、希伯来语、印度尼西亚语(巴哈萨语)、意大利语、日语、韩语、拉脱维亚语、立陶宛语、挪威语、波兰语、葡萄牙语(巴西)、葡萄牙语(葡萄牙)、罗马尼亚语、俄语、塞尔维亚语、西班牙语、瑞典语、泰语、土耳其语、乌克兰语、越南语。

注:

对于 ArcGIS for Power BI,本地 Power BI 环境决定了使用的语言。 在 Power BI 服务 (powerbi.com) 中,ArcGIS for Power BI 使用与服务相同的语言。 在 Power BI Desktop 中,ArcGIS for Power BI 使用安装软件的语言。 如果使用不受支持的语言,则可视化将使用英语。

Windows 版加载项中使用的语言取决于操作系统的语言设置。 如果使用不受支持的语言设置,则加载项将使用英语。

帮助语言

帮助文档提供简体中文版、英语版、法语版、德语版、日语版、俄语版和西班牙语版。