您必须是 ArcGIS for Microsoft 管理员,才能使用本主题中描述的工作流。
配置 ArcGIS Enterprise 跨域资源共享
在某些情况下,当您使用 ArcGIS Enterprise 账户登录到 ArcGIS for Power BI 时,有效 ArcGIS Enterprise URL 未连接,并显示 URL 无效错误。
此错误仅适用于 ArcGIS Enterprise 账户。 默认情况下,ArcGIS Enterprise 门户允许使用跨域资源共享 (CORS) 的跨域请求。 这意味着,JavaScript 客户端(例如在任何域中托管的 web 应用程序)可以连接至门户资源。
要限制来自 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.7.1 的设置更新到 10.9
从 ArcGIS Enterprise 10.7.1 更新到 10.9 时,ArcGIS Enterprise 管理员必须配置允许源设置。 要更新允许源设置,请完成以下步骤:
- 验证您是否已登录 ArcGIS Enterprise 组织,以及是否具有管理组织的权限。
- 使用 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。 - 登录后,请转至 https://webadaptorhost.domain.com/webadaptorname/sharing/rest/portals/self。
- 在页面底部,单击更新。
- 在新加载的页面上,找到允许的源文本框。
源将由逗号分隔,没有任何空格、引号或方括号。
- 将以下文本复制到允许的源文本框以添加 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
- 单击更新组织。
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.1、11.0、11.1 或更高版本。 有关详细信息,请参阅 ArcGIS Enterprise 产品生命周期。
- 通过物理硬件或虚拟环境进行本地部署
注:
ArcGIS for Power BI 仅在在线环境中进行了测试,未在离线环境中运行。
受支持的浏览器
ArcGIS for Microsoft 支持所有现代浏览器以及最新版本的用于 macOS 的 Chrome、Firefox 和 Safari,以及用于 Microsoft Windows 操作系统的最新版本的 Chrome、Firefox 和 Edge¹。
¹ 要将 ArcGIS for Power BI 与 ArcGIS Enterprise 配合使用,您必须配置较低版本的 Microsoft Edge 浏览器以允许该应用程序正常运行。macOS 仅在在线环境中与 Power BI 兼容。
注:
在移动环境中,可以查看 Microsoft Power BI 随附的使用 ArcGIS for Power BI 可视化创建的地图。 包含 ArcGIS 中高级内容的地图在移动环境中不受支持。
对于 ArcGIS for Excel,某些功能(例如在搜索中使用当前位置)在在线使用 Excel 时和在 macOS 上不可用。
地理坐标系
ArcGIS for Microsoft 支持 WGS84 空间参考系。
ArcGIS for Power BI 加密协议
ArcGIS for Power BI 支持以下加密协议:
ArcGIS for Power BI 环境 | SSL 1.0 | SSL 2.0 | SSL 3.0 | TLS 1.0 | TLS 1.1 | TLS 1.2 | TLS 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
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 版加载项中使用的语言取决于操作系统的语言设置。 如果使用不受支持的语言设置,则加载项将使用英语。
帮助语言
简体中文、英语、法语、德语、日语、俄语、西班牙语