Power BI Mobile

Power BI Mobile 是 Microsoft 的移动端应用，用于在手机和平板上查看 Power BI 内容。Protocol Launcher 允许你生成 Power BI Mobile URL scheme 链接。

使用

有两种方式使用这个库：

• 按需从子路径导入，支持 tree-shaking 并保持 bundle 更小。
• 从根包完整导入，适合快速脚本或 demo，但会包含所有 app 模块。

生产构建建议使用按需导入；完整导入适合快速脚本或演示。

选择安装方式

按需加载

推荐使用。生产环境优化。

全量导入

使用便捷。适合快速脚本。

说明

本模块只封装 Microsoft 文档中用于已安装 Power BI Mobile 设备的 mspbi://app/ 移动端 deep-link 格式。Microsoft 还记录了单独的 redirect 和 report URL 格式；这些不属于这里的 mspbi:// helpers。

对于不在 My Workspace 中的内容，传入 groupObjectId，生成的 URL 会包含 Microsoft 的 GroupObjectId 参数。Report bookmark 只记录支持标准 36 位 GUID 值；不支持 BookmarkXXXXXXXXXXXXXXXXXXX 形式。

打开 App

打开 Power BI Mobile。

On-Demand

import { openApp } from 'protocol-launcher/power-bi-mobile'

const url = openApp()

打开 Power BI Mobile

打开 Dashboard

通过 dashboard object ID 打开指定 dashboard。

On-Demand

import { openDashboard } from 'protocol-launcher/power-bi-mobile'

const url = openDashboard({
  dashboardObjectId: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
  groupObjectId: 'ffffffff-5555-6666-7777-aaaaaaaaaaaa',
})

打开 Power BI Dashboard

打开 Tile

以 focus mode 打开 dashboard tile。

On-Demand

import { openTile } from 'protocol-launcher/power-bi-mobile'

const url = openTile({
  dashboardObjectId: 'aaaaaaaa-0000-1111-2222-bbbbbbbbbbbb',
  tileObjectId: 'cccccccc-2222-3333-4444-dddddddddddd',
  groupObjectId: 'ffffffff-5555-6666-7777-aaaaaaaaaaaa',
})

打开 Power BI Tile

打开 Report

打开指定 report。

On-Demand

import { openReport } from 'protocol-launcher/power-bi-mobile'

const url = openReport({
  reportObjectId: 'dddddddd-3333-4444-5555-eeeeeeeeeeee',
  groupObjectId: 'ffffffff-5555-6666-7777-aaaaaaaaaaaa',
})

打开 Power BI Report

打开 Report Page

打开指定 report page。

On-Demand

import { openReport } from 'protocol-launcher/power-bi-mobile'

const url = openReport({
  reportObjectId: 'dddddddd-3333-4444-5555-eeeeeeeeeeee',
  reportPage: 'ReportSection11',
})

打开 Power BI Report Page

使用 Context 打开 Report

给 report deep link 添加 context 参数。

On-Demand

import { openReport } from 'protocol-launcher/power-bi-mobile'

const url = openReport({
  reportObjectId: 'dddddddd-3333-4444-5555-eeeeeeeeeeee',
  groupObjectId: 'eeeeeeee-4444-5555-6666-ffffffffffff',
  context: 'SlackDeepLink',
})

使用 Context 打开 Power BI Report

官方文档

• Create a link to a specific location in the Power BI mobile apps