在 Power BI 行動裝置應用程式中建立特定位置的連結

您可以使用連結直接存取特定的Power BI內容,例如特定報表、報表頁面、儀錶板、磚等。

使用連結來存取 Power BI 行動裝置應用程式中的內容有兩個主要案例:

  • 若要從 行動應用程式外部開啟Power BI,並登陸特定內容。 這通常是整合案例,您會從另一個應用程式開啟Power BI行動應用程式。

  • Power BI 內巡覽 。 當您想要在Power BI 中建立自定義導覽時,通常會這麼做。

本文涵蓋下列案例:

  • 使用連結從行動應用程式外部開啟特定的Power BI內容。 描述兩種連結格式。 一個使用重新導向方法,無論 Power BI 開啟的位置為何,都可以使用。 另一個直接在Power BI行動裝置應用程式中開啟,而且只能在已安裝行動應用程式的行動裝置上運作。

  • 使用 Power BI 內的連結瀏覽至特定的 Power BI 內容。

行動應用程式支援包含查詢字串參數的報告連結。 根據查詢字串中定義的條件,在行動應用程式中開啟這類連結會預先篩選。 如需使用查詢字串參數建立報表 URL 的詳細資訊,請參閱 在 URL 中篩選報表查詢字串參數。

行動應用程式也支援透過 URL 將參數傳遞至編頁報表。 如需詳細資訊,請參閱 在編頁報表 的 URL 中傳遞報表參數以取得詳細數據。

當您要從行動應用程式外部連結至 Power BI 中的特定專案時,有兩個選項,視要開啟連結的位置而定:

  • 如果您想要讓鏈接正確開啟,不論它是否在計算機瀏覽器或行動裝置上按兩下,您都可以建立一個連結,以確保無論按一下何處,都會正確開啟該連結。 此連結具有特殊的重新導向語法,可啟用此智能行為。

  • 如果您知道連結只會在已安裝 Power BI 行動應用程式的行動裝置上開啟,您可以避免上述方法的重新導向額外負荷,並使用另一個連結語法,直接在行動裝置上的 Power BI 行動裝置應用程式中開啟連結。 不過,請務必注意,雖然此連結可避免第一個方法的重新導向額外負荷,但如果在已安裝Power BI行動應用程式的行動裝置上以外的任何位置開啟,將無法運作。

本節所述的連結格式會使用重新導向,以確保無論按兩下連結的位置如何運作。

  • 如果單擊行動裝置上的連結,可確保裝置使用Power BI行動裝置應用程式來開啟連結。 如果行動應用程式未安裝在裝置上,建議使用者前往市集以取得它。

  • 如果單擊電腦上的連結,它會在Power BI入口網站中開啟相關專案。

鏈接必須以特殊前置詞開頭,後面接著查詢參數:

http://app.powerbi.com/Redirect?[QUERYPARAMETERS]

重要

如果您的內容裝載在政府、中國等特殊數據中心,則連結應以適當的 Power BI 位址開頭,例如 app.powerbigov.usapp.powerbi.cn

查詢參數如下:

參數 數值 Description
動作 (強制) OpenApp
OpenReport
OpenDashboard
OpenTile
應用程式識別碼 36 個字元 GUID 如果您要開啟屬於應用程式一部分的報表或儀錶板,則必須指定 。
範例: appId=baf4b16d-b5bd-4360-8a3a-51d11242c09b
groupObjectId 36 個字元 GUID 當您想要開啟不屬於 [我的工作區] 的報表或儀錶板時,指定工作區。
範例: groupObjectId=9a3841c6-74b3-46f1-85fd-bdd78f27b30e
dashboardObjectId 36 個字元 GUID 儀錶板物件標識碼(如果動作為 OpenDashboard 或 OpenTile)
範例: dashboardObjectId=033bb049-5b68-4392-b3ef-ae9a43738a4a
reportObjectId 36 個字元 GUID 報表物件識別碼 (如果動作為 OpenReport)
範例: reportObjectId=6114cec7-78e1-4926-88ff-0bc5338452cf
tileObjectId 36 個字元 GUID 磚物件識別碼(如果動作為 OpenTile)
範例: tileObjectId=a845dcb8-a289-43a8-94ea-67a8c0a068f9
reportPage ReportSection<num> 如果您想要開啟特定報表頁面,頁面名稱。 (如果動作是 OpenReport)
範例: reportPage=ReportSection6
bookmarkGuid 36 個字元 GUID 如果您想要開啟特定的書籤檢視,則為書籤標識符。 (如果動作是 OpenReport)
範例: bookmarkGuid=18e8872f-6db8-4cf8-8298-3b2ab254cc7f
注意:不支援 BookmarkXXXXXXXXXXXXXXXXXXXXXXXXX 格式的值
ctid 36 個字元 GUID 專案組織標識碼 (與 B2B 案例相關。如果項目屬於使用者組織,則可以省略此專案)
範例: ctid=5367c770-09d0-4110-bf6a-d760cb5ef681

注意

報表層級書籤沒有 bookmarkGUID 格式,目前無法傳遞為深層鏈接的參數。

範例:

在下列範例中,參數值的佔位元會以粗體反白顯示。 若要取得實際值,請移至 Power BI 服務,開啟您要連結的專案,並從專案的 URL 擷取所需的值。

  • 開啟應用程式

    https://app.powerbi.com/Redirect?action=OpenApp&appId=<appid-guid>&ctid=<ctid-guid>

  • 開啟屬於應用程式的儀錶板

    https://app.powerbi.com/Redirect?action=OpenDashboard&appId=<appid-guid>&dashboardObjectId=<dashboardid-guid>&ctid=<ctid-guid>

  • 開啟屬於 [我的工作區] 以外工作區一部分的報表

    https://app.powerbi.com/Redirect?Action=OpenReport&reportObjectId=reportid-guid>&groupObjectId=<groupobjectid-guid>&reportPage=ReportSection<num<>

對於 應用程式,以及屬於應用程式一部分的報表和儀錶板,取得連結最簡單的方式是移至應用程式工作區,然後選擇 [ 更新應用程式]。 這會開啟「發佈應用程式」體驗。 開啟 [許可權] 索引標籤並展開 [連結] 區段,以查看應用程式及其所有內容的連結。 您可以從 Power BI 外部使用這些連結,直接存取應用程式及其內容。

Screenshot of Power BI publish app links highlighted.

對於不屬於應用程式的報表和儀錶板,您需要從專案的URL擷取所需的物件標識碼。 若要這樣做,請移至 Power BI 服務,流覽至您要連結的專案,並尋找您在瀏覽器網址列中看到的 URL 中所需的值。

這些範例顯示您可以在您要連結之專案的 URL 中找到所需的識別碼。

  • 若要尋找 36 個字元的儀錶板物件識別碼,請流覽至您想要在 Power BI 服務 中連結的特定儀錶板,並在指示的位置尋找儀錶板物件標識碼和任何其他必要的標識碼:

    https://app.powerbi.com/groups/me/dashboards/<dashboard-object-id>?ctid=<org-object-id>

  • 若要尋找 36 個字元的報表物件識別碼,請流覽至您想要連結至 Power BI 服務 中的特定報表,並找到必要的標識符,如下所示。 此範例包含特定報表頁面和特定書籤的參考。

    https://app.powerbi.com/groups/me/reports/<report-object-id>/ReportSection<num>?bookmarkGuid=<bookmark-id>

  • 若要連結至 [我的工作區] 以外的工作區中的專案,您需要擷取群組對象標識碼。 此範例顯示 [我的工作區] 以外的工作區中的報表。

    https://app.powerbi.com/groups/<group-object-id>/reports/<report-object-id>/ReportSection<report-section-num>?ctid=<org-object-id>

本節所述的連結格式會連結到所有行動平臺上 Power BI 行動裝置應用程式內的特定位置:iOS、Android 裝置和 Windows。 此連結格式會直接開啟位置,而不需要上一節所述的方法所牽涉到的任何重新導向。 此格式只能在已安裝Power BI行動應用程式的行動裝置上開啟。

此格式的連結可以直接指向儀錶板、磚和報表。 深層連結的目的地會決定其格式。 請遵循下列步驟來建立不同位置的深層連結。

  • 開啟 Power BI 行動應用程式

    使用此連結在任何裝置上開啟 Power BI 行動應用程式:

    mspbi://app/

  • 開啟至特定儀錶板

    此連結會將 Power BI 行動應用程式開啟至特定儀錶本:

    mspbi://app/OpenDashboard?DashboardObjectId=<36-character-dashboard-id>

    若要取得 36 個字元的儀錶板物件標識碼,請流覽至 Power BI 服務 中的特定儀錶板,並從 URL 擷取它。 例如,儀錶板物件識別碼會在下列來自 Power BI 服務的 URL 中反白顯示:

    https://app.powerbi.com/groups/me/dashboards/<61b7e871-cb98-48ed-bddc-6572c921e270>

    如果儀錶板不在 [我的工作區] 中,您也必須在儀錶板標識碼之前或之後新增群組對象標識符。 顯示的深層連結已新增儀表板物件識別碼之後的群組物件識別碼參數:

    mspbi://app/OpenDashboard?DashboardObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248

    請注意兩個參數之間的連字元和 (&) 。

  • 開啟至焦點中的特定磚

    此連結會在 Power BI 行動裝置應用程式中以焦點模式開啟特定磚:

    mspbi://app/OpenTile?DashboardObjectId=<36-character-dashboard-id>&TileObjectId=<36-character-tile-id>

    若要尋找 36 個字元的儀錶板和磚物件識別碼,請流覽至 Power BI 服務 中的特定儀錶板,並以焦點模式開啟磚。 在此範例中,儀錶板和磚標識符會反白顯示。

    https://app.powerbi.com/groups/me/dashboards/3784f99f-b460-4d5e-b86c-b6d8f7ec54b7/tiles/565f9740-5131-4648-87f2-f79c4cf9c5f5/infocus

    若要直接開啟此圖格,連結會是:

    mspbi://app/OpenTile?DashboardObjectId=3784f99f-b460-4d5e-b86c-b6d8f7ec54b7&TileObjectId=565f9740-5131-4648-87f2-f79c4cf9c5f5

    請注意兩個參數之間的連字元和 (&) 。

    如果儀錶板不在 [我的工作區] 中,請新增 GroupObjectId 參數,例如 &GroupObjectId=<36-character-group-id>

  • 開啟至特定報表

    此連結會在 Power BI 行動裝置應用程式中開啟特定報表:

    mspbi://app/OpenReport?ReportObjectId=<36-character-report-id>

    若要尋找 36 個字元的報表物件識別碼,請流覽至 Power BI 服務 中的特定報表。 Power BI 服務的下列 URL 說明您需要擷取的報表標識碼。

    https://app.powerbi.com/groups/me/reports/df9f0e94-31df-450b-b97f-4461a7e4d300

    如果報表不在 [我的工作區] 中,您也必須在報表標識符之前或之後新增 &GroupObjectId=<36-character-group-id> 。 例如,在此情況下,深層連結會是:

    mspbi://app/OpenReport?ReportObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248

    請注意兩個參數之間的連字元和 (&) 。

  • 開啟特定報表頁面

    此連結會在 Power BI 行動裝置應用程式中開啟特定的報表頁面:

    mspbi://app/OpenReport?ReportObjectId=36-character-report-id>&reportPage=ReportSection<number<>

    報表頁面稱為 ReportSection,後面接著數位。 同樣地,若要尋找您需要的值,請在 Power BI 服務 中開啟報表、流覽至特定報表頁面,並從 URL 擷取所需的值。 例如,此 URL 的醒目提示區段代表您需要開啟至特定報表頁面的值:

    https://app.powerbi.com/groups/me/reports/df9f0e94-31df-450b-b97f-4461a7e4d300/ReportSection11

  • 以全螢幕模式開啟 (僅適用於 Windows 裝置)

    針對 Windows 裝置,您也可以新增 openFullScreen 參數,以全螢幕模式開啟特定報表。 下列範例會以全螢幕模式開啟報表頁面:

    mspbi://app/OpenReport?ReportObjectId=500217de-50f0-4af1-b345-b81027224033&openFullScreen=true

  • 新增內容 (選擇性)

    您也可以將內容新增至字串。 然後,如果您需要與我們連絡,我們可以使用該內容來篩選數據,以尋找與您的應用程式相關的內容。 若要新增內容,請將參數 context=<app-name> 新增至連結:

    例如,下列範例會顯示包含內容參數的連結:

    mspbi://app/OpenReport?ReportObjectId=e684af3a-9e7f-44ee-b679-b9a1c59b5d60&GroupObjectId=8cc900cc-7339-467f-8900-fec82d748248&context=SlackDeepLink

在Power BI行動裝置應用程式中,Power BI 中的連結就像在 Power BI 服務 中運作一樣運作。

如果您想要將連結新增至指向另一個 Power BI 專案的報表,您只要從瀏覽器網址列複製該專案的 URL 即可。 如需詳細資訊,請參閱 將超連結新增至報表中的文字框。

考量與限制

只有在 bookmarkGuid 參數的值具有標準 36 個字元 GUID 格式時,行動裝置應用程式中才支援具有 bookmarkGuid 參數之報表的深層連結。 不支援 bookmarkGuid 參數值具有 BookmarkXXXXXXXXXXXXXXXXXXXXXXXXXX 格式 的連結。

您的意見反應可協助我們決定未來要實作的內容,因此別忘了投票給您想要在Power BI行動裝置應用程式中看到的其他功能。