在應用程式內顯示 Power BI 磚的控制項。
沒有 Power BI？ 註冊。
Description
在應用程式內顯示 Power BI 磚 ，以利用現有的資料分析和報告。 在選項面板的 [資料] 索引標籤中設定其 [工作區]、[儀表板] 和 [磚] 屬性，以指定您要顯示的磚。
備註
- Power BI 磚控制項不適用於 GCC High 和 DoD 環境。
- Power BI 磚控制項在中國不可用。
- 如需內嵌 Power BI 磚時的授權需求，請參閱 授權。
共用與安全性
當您共用包含 Power BI 內容的應用程式時，您不僅必須共用應用程式本身，還必須共用磚的 來源儀表板 。 否則，即使開啟應用程式的使用者也不會顯示 Power BI 內容。 包含 Power BI 內容的應用程式會遵循該內容的許可權。
Performance
不建議在應用程式內同時載入三個以上的 Power BI 磚。 您可以設定 LoadPowerBIContent 屬性來控制磚載入和卸載。
嵌入選項
內嵌在 Power BI API 版本之間有所不同。 由於新的 Power BI API 驗證配置，您的磚可能無法在行動裝置或其他內嵌案例 （Teams 或 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。
儀表板 – 磚的來源 Power BI 儀表板。
LoadPowerBIContent – 設定為 True 時，會載入並顯示 Power BI 內容。 設定為 False 時，會卸載 Power BI 內容，這會釋放記憶體並優化效能。
PowerBIInteractions - 設定為 True 時，可以與 Power BI 內容互動，但不會觸發 Power Apps OnSelect 事件。 當設定為 False 時，無法與磚互動，但選取磚時會觸發 Power Apps OnSelect 事件。
磚 – 您要顯示的 Power BI 磚名稱。
工作區 – 磚的來源 Power BI 工作區。
其他屬性
BorderColor – 控制項框線的色彩。
BorderStyle – 控制項的框線是 Solid、 Dashed、 Doted 還是 None。
BorderThickness — 控制項邊框的粗細。
DisplayMode – 控制項是否允許使用者輸入 （編輯） 、只顯示資料 （檢視） 或停用 （已停用） 。
高度 – 控制項頂部和底部邊緣之間的距離。
OnSelect — 使用者選取控制項時要執行的動作。 根據預設，與磚相關聯的 Power BI 報表會開啟。
TileUrl – 從 Power BI 服務要求磚的 URL。 若要將查詢字串篩選新增至您的 URL，請參閱上方的 篩選 區段。
可見 — 控制項是否顯示或隱藏。
寬度 – 控制項的左右邊緣之間的距離。
X – 控制項的左邊緣與其父容器的左邊緣之間的距離 （螢幕 - 如果沒有父容器）。
Y — 控制項的頂端邊緣與父容器的頂端邊緣之間的距離 （畫面 - 如果沒有父容器）。
Example
在 [插入 ] 索引標籤上，開啟 [圖表] 功能表，然後新增 Power BI 磚 控制項。
不知道如何 新增和設定控制項？
在選項面板的 資料 索引標籤上，針對 工作區 設定選取 我的工作區。
在儀表板清單中選取儀表板，然後在磚清單中選取磚。
控制項會轉譯 Power BI 磚。
協助工具指導方針
Power BI 磚只是 Power BI 內容的容器。 瞭解如何使用這些 Power BI 協助工具秘訣來建立協助工具的內容。
如果 Power BI 內容沒有標題，請考慮使用 Label 控制項新增標題，以支援螢幕助讀程式。 您可以將標籤緊接在 Power BI 磚之前。