Power Apps 中的 Power BI 圖格控制項
顯示應用程式內 Power BI圖格的控制項。
沒有 Power BI？ 註冊。
描述
藉由顯示您的應用程式內的 Power BI 圖格，善用現有的資料分析和報表。 指明要顯示的圖格，方法是在選項面板的 Data 索引標籤中設定其 Workspace、Dashboard 和 Tile 屬性。
注意
- Power BI 圖格控制項無法在 GCC High 和 DoD 環境中使用。
- Power BI 圖格控制項無法在中國使用。
- 有關內嵌 Power BI 圖格時的授權要求，請參閱授權。
共用和安全性
當您共用包含 Power BI 內容的應用程式時，不僅必須共用應用程式本身，也必須共用圖格所在的 儀表板。 否則不會顯示 Power BI 內容，即使針對開啟應用程式的使用者也一樣。 包含 Power BI 內容的應用程式會採用該內容的權限。
績效
不建議同時在應用程式內載入三個以上的 Power BI 圖格。 您可以設定 LoadPowerBIContent 屬性控制圖格載入和卸載。
內嵌選項
不同 Power BI API 版本的內嵌有所差異。 由於新的 Power BI API 驗證配置，您的圖格在行動裝置或其他內嵌案例 (Teams or SharePoint) 中可能無法存取。
您可以使用 AllowNewAPI 屬性來控制 API 版本的使用。 如需更多資訊，請參閱關鍵屬性。
| AllowNewAPI 屬性值 | 行為 |
|---|---|
| 真 | 您可以從 Power BI 取得 內嵌 URL，並將其設為 TileUrl 值來內嵌儀表板、報表或圖格。 |
| 假 | 您可以透過內嵌 URL 並將其設為 TileUrl 值，或使用提供的圖形界面來內嵌儀表板圖格。 |
注意
行動版 Power Apps 不支援內嵌 Power BI URL (例如，在 IFrame 中)，因為行動播放程式不處理驗證 Power BI URL 要求。
篩選
不同 Power BI API 版本的篩選有所差異。 根據您設定控制項的方式，請參閱以下適當的章節。
使用新的 API 呼叫 Power BI 服務時
當 AllowNewAPI 屬性設為 "True" 時，您將使用新的 API 來呼叫 Power BI 服務。 如需更多資訊，請參閱使用 URL 中的查詢字串參數篩選報表。
使用原始 API 呼叫 Power BI 服務時
當 AllowNewAPI 屬性設為 "False" 時，您將使用原始 API 來呼叫 Power BI 服務。 在此案例中，透過傳遞應用程式的單一參數，您可以篩選 Power BI 圖格中顯示的結果。 但是目前只支援字串值和等值運算子，而且如果資料表名稱或欄位名稱包含空格，篩選可能無法運作。
若要傳遞單一篩選值，請修改 TileURL 屬性的值，語法如下：
"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"
若要到該值，請附加下列語法：
&$filter=<TableName>/<ColumnName> eq '<Value>'
例如，使用清單方塊中的值：
"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"
此參數會篩選出圖格源自的報表資料集中的值。 但是篩選功能有下列限制：
- 只能套用一個篩選。
- 只支援
eq運算子。 - 欄位類型必須是字串。
- 篩選只適用於釘選的視覺效果圖格。 不支援釘選報表。
- 無法篩選 R 和 Python 指令碼視覺效果。
您可以使用 Power BI 報表中的計算欄位將其他數值類型轉換為字串或結合多個欄位為一個。
索引鍵屬性
AllowNewAPI - 在呼叫 Power BI 服務時，是否要使用新的 API。 將此值設定為 True 將允許使用新的 Power BI API (不支援在行動和某些嵌入案例中使用)，但是允許某些更進階的篩選。 False 將使用原始 API。 預設值為 false。
Dashboard – 圖格源自的 Power BI 儀表板。
LoadPowerBIContent – 當設定為 True 時，會載入並顯示 Power BI 內容。 設定為 False 時，會卸載 Power BI 內容釋出記憶體並將效能最佳化。
PowerBIInteractions - 當設為 True 時，可與 Power BI 內容互動，但不會觸發 Power Apps OnSelect 事件。 設為 False 時，無法與圖格進行互動，但當選取圖格時，將觸發 Power Apps OnSelect 事件。
Tile – 要顯示的 Power BI 圖格名稱。
Workspace – 圖格源自的 Power BI 工作區。
其他屬性
BorderColor – 控制項框線的色彩。
BorderStyle – 決定控制項的框線為實線、虛線、點線或無。
BorderThickness – 控制項框線的粗細。
DisplayMode – 控制項是否允許使用者輸入 (Edit)、只顯示資料 (View) 或者已停用 (Disabled)。
Height – 控制項的頂端和底部邊緣之間的距離。
OnSelect – 在使用者選擇控制項時，要執行的動作。 預設情況下，與開啟圖格相關聯的 Power BI 報表。
TileUrl – 用來向 Power BI 服務要求圖格的 URL。 若要將查詢字串篩選新增至您的 URL，請參閱上述的篩選章節。
Visible – 控制項顯示或隱藏。
Width – 控制項左邊緣與右邊緣之間的距離。
X – 控制項左邊緣與其父容器 (若沒有父容器則為—畫面) 左邊緣之間的距離。
Y – 控制項頂部邊緣與其父容器 (若沒有父容器則為—畫面) 頂部邊緣之間的距離。
範例
在插入索引標籤上，開啟圖表功能表，然後新增 Power BI 圖格控制項。
不知道如何 新增和設定控制項 嗎？
在選項面板的Data 索引標籤上，選取Workspace 設定的我的工作區。
選取儀表板清單中的儀表板，然後選取圖格清單中的圖格。
控制項會轉譯 Power BI 圖格。
協助工具指南
Power BI 圖格只是 Power BI 內容的容器。 了解如何使用這些 Power BI 協助工具提示 建立可存取的內容。
如果 Power BI 內容沒有標題，請考慮使用**標籤l** 控制項新增標題來支援螢幕助讀程式。 您可以將標籤緊挨著 Power BI 圖格正前方。