了解您在應用程式中內嵌 Power BI 內容時必須採取的步驟。

Microsoft 最近宣佈 Power BI Premium,這是一種新容量授權模型,可提高使用者如何存取、共用和散發內容的彈性。 此供應項目也會提供 Power BI 服務的額外延展性和效能。

透過引進 Power BI Premium,Power BI Embedded 和 Power BI 服務將合力促進如何將 Power BI 內容內嵌到應用程式中。 這表示,在內嵌內容時,您會有一個 API 介面、一組一致的功能以及最新 Power BI 功能的存取權 (例如儀表板、閘道和應用程式工作區)。 接著,您將可以開始使用 Power BI Desktop 並移至具有 Power BI Premium 的部署,而這會在 2017 年第二季正式上市。

本文將探討如何內嵌 Power BI 使用者和非 Power BI 使用者的 Power BI 內容。 兩者的步驟類似。 對非 Power BI 使用者進行內嵌的特定步驟時,將會進行圖說文字。

您需要使用應用程式執行幾個步驟,來達成這項作業。 我們將探討可讓您在應用程式內建立和使用已內嵌內容所需的步驟。

注意:

Power BI API 仍然將應用程式工作區稱為群組。 任何對群組的引述都表示您處理的是應用程式工作區。

步驟 1︰設定內嵌的分析開發環境

在您開始將儀表板和報表內嵌到應用程式之前,需要確定環境設定成允許進行內嵌。 在安裝時,您必須執行下列作業。

注意:

開發應用程式時,不需要 Power BI Premium。 應用程式開發人員必須擁有 Power BI Pro 授權。

Azure Active Directory 租用戶

您需要有 Azure Active Directory (Azure AD) 租用戶,才能內嵌 Power BI 中的項目。 此租用戶必須至少要有一個 Power BI Pro 使用者。 您也必須在租用戶內定義 Azure AD 應用程式。 您可以利用現有 Azure AD 租用戶,或特別針對內嵌用途建立新的 Azure AD 租用戶。

您必須判斷要使用的租用戶設定。

  • 使用現有的公司 Power BI 租用戶嗎?
  • 您的應用程式使用不同的租用戶嗎?
  • 每個客戶都使用個別租用戶嗎?

如果您決定建立應用程式或每個客戶的新租用戶,請參閱建立 Azure Active Directory 租用戶如何取得 Azure Active Directory 租用戶

注意:

如果您將針對非 Power BI 使用者進行內嵌,則建議建立新的 Azure AD 租用戶。

建立 Power BI Pro 使用者帳戶

您只需要單一 Power BI Pro 帳戶,就能內嵌內容。 不過,您可能想要有幾個不同的使用者具有項目的特定存取權。 以下探討租用戶內可能要考慮的使用者。

下列帳戶必須存在於您的租用戶內,並且獲指派 Power BI Pro 授權。

注意:

這些帳戶必須擁有 Power BI Pro 授權,才能使用應用程式工作區。

組織/租用戶系統管理員使用者

建議您的組織/租用戶全域管理員使用者不應該用作應用程式所使用的帳戶。 這會將應用程式帳戶在組織內的存取權最小化。 建議管理員使用者是基於內嵌而建立之所有應用程式工作區的管理員。

將建立內容之分析師的帳戶

您可能有多位使用者建立 Power BI 的內容。 針對每位建立內容並將其部署至 Power BI 的分析師,您都需要有其 Power BI Pro 帳戶。

非 Power BI 使用者的應用程式 master 使用者帳戶

這是應用程式將在內嵌非 Power BI 使用者內容時使用的帳戶。 這真的是您組織內唯一需要的帳戶。 它也可以用作系統管理員和分析師帳戶,但不建議這麼做。 應用程式後端將會儲存此帳戶的認證,並使用它取得 Azure AD 授權權杖以與 Power BI API 搭配使用。 這個帳戶將用來產生應用程式用於非 Power BI 使用者的內嵌權杖。

這個帳戶必須是正用於內嵌之應用程式工作區的管理員。

應用程式註冊和權限

您必須在 Azure AD 中註冊應用程式,才能進行 REST API 呼叫。 如需詳細資訊,請參閱註冊 Azure AD 應用程式以內嵌 Power BI 內容

建立應用程式工作區

如果您要為非 Power BI 使用者 (應用程式擁有資料) 內嵌儀表板及報表,則必須將這些儀表板及報表放在應用程式工作區內。 如需如何建立應用程式工作區的相關資訊,請參閱建立應用程式工作區

重要事項:

上面所提及的 master 帳戶需要是應用程式工作區的管理員。

建立和上傳報表

您可以使用 Power BI Desktop 建立報表和資料集,接著將這些報表發佈到應用程式工作區。 發佈報表的一般使用者必須有 Power BI Pro 授權,才能發佈至應用程式工作區。

步驟 2︰內嵌內容

在應用程式內,您必須向 Power BI 進行驗證。 如果您要內嵌非 Power BI 使用者的內容,這將需要您將 master 帳戶的認證儲存在應用程式內。 如需詳細資訊,請參閱 Authenticate users and get an Azure AD access token for your Power BI app (驗證使用者,並為 Power BI 應用程式取得 Azure AD 存取權杖)。

驗證完成後,請在應用程式中使用 Power BI 及 JavaScript API,將儀表板及報表內嵌至應用程式中。

針對 Power BI 使用者 (使用者擁有資料) 的內嵌功能,請參閱下列資源:

針對通常用於 ISV 案例的非 Power BI 使用者 (應用程式擁有資料) 內嵌,請參閱下列資源:

為非 Power BI 使用者 (應用程式擁有資料) 內嵌時,需要內嵌權杖。 若要深入了解,請參閱 GenerateToken

步驟 3:將解決方案升階至生產環境

當您準備好進入生產環境時,必須執行下列作業。

Power BI 使用者 (使用者擁有資料)

如果您要對 Power BI 使用者進行內嵌,則只需要讓人員知道如何到達您的應用程式。

若群組 (應用程式工作區) 提供進階容量,免費使用者就可以取用從該工作區內嵌的內容。 您必須將免費使用者列為群組 (應用程式工作區) 成員,否則會收到 401 未經授權的錯誤。

非 Power BI 使用者 (應用程式擁有資料)

如果您要對非 Power BI 使用者進行內嵌,則會想要執行下列作業。

  • 雖然您可以使用組織生產租用戶,但是建議為生產環境建立新內嵌的分析環境。 如需詳細資訊,請參閱上方的步驟 1。

  • 如果您要使用不同的租用戶進行開發,則必須確定生產環境中具有應用程式工作區、儀表板和報表。 您也必須確定已在 Azure AD 中建立生產租用戶的應用程式,並獲指派適當的應用程式權限,如步驟 1 所示。

  • 購買符合您需求的容量。 您可以使用下表來了解您可能需要的進階容量 SKU。 如需詳細資料,請參閱內嵌的分析容量規劃白皮書。 當您準備好購買時,可以在 Office 365 系統管理中心內進行。

節點容量 核心總數
(後端 + 前端)
後端核心 前端核心 DirectQuery/即時連線限制 尖峰時間的頁面呈現上限 可用性
EM1 1 個 v 核心 .5 個核心,3GB RAM .5 個核心 1-300 2017 年 7 月
EM2 2 個 v 核心 1 個核心,5GB RAM 1 個核心 301-600 2017 年 7 月
EM3 4 個 v 核心 2 個核心,10GB RAM 2 個核心 601-1,200 2017 年 7 月
P1 8 個 v 核心 4 個核心,25GB RAM 4 個核心 每秒 30 個 1,201-2,400 高可用性
P2 16 個 v 核心 8 個核心,50GB RAM 8 個核心 每秒 60 個 2,401-4,800 高可用性
P3 32 個 v 核心 16 個核心,100GB RAM 16 個核心 每秒 120 個 4,801-9600 高可用性
注意:

您必須是租用戶內的全域或帳務管理員,才能購買 Power BI Premium。 如需如何購買 Power BI Premium 的資訊,請參閱如何購買 Power BI Premium

  • 在進階下,編輯應用程式工作區,並將它指派給進階容量。

  • 將更新過的應用程式部署至生產環境,然後開始從 Power BI 服務內嵌報表。

管理員設定

全域管理員 (或稱 Power BI 服務系統管理員) 可以開啟或關閉使用 REST API 的能力。 管理員可以為整個組織或個別安全性群組進行此設定。 依據預設,會為整個組織啟用這個設定。 這會透過 Power BI 管理入口網站完成。

後續步驟

內嵌在 Power BI 之中
如何將 Power BI Embedded 工作區集合內容移轉至 Power BI
何謂 Power BI Premium
如何購買 Power BI Premium
JavaScript API Git 存放庫
Power BI C# Git 存放庫
JavaScript 內嵌示範
內嵌的分析容量規劃白皮書
Power BI Premium 技術白皮書

有其他問題嗎? 嘗試在 Power BI 社群提問