內嵌儀錶板磚
提示
請嘗試在 Power BI Embedded Analytics 遊樂場的 探索 API 區段中內嵌儀錶板磚或實驗用戶端 API。
本文涵蓋在應用程式中內嵌儀錶板磚的步驟。 深入瞭解 Power BI 設計工具儀錶板磚簡介中的儀錶板磚 ,。
如何內嵌儀錶板磚
當您在應用程式中內嵌 Power BI 內容時,您可以使用組態物件來定義您要內嵌的內容,以及指定內容的設定。 然後將該對象傳遞至 API。
當您內嵌儀錶板磚時,請使用類型 為 ITileLoadConfiguration的組態物件:
interface ITileLoadConfiguration {
accessToken: string;
dashboardId: string;
embedUrl: string;
id: string;
tokenType?: models.TokenType;
type: string;
}
此介面包含下列屬性:
accessToken
- 可讓您存取您要內嵌的 Power BI 數據令牌。 若要深入瞭解存取令牌,請參閱 瞭解不同的內嵌解決方案。dashboardId
- 儀錶板的標識符,其中包含您要內嵌的磚。 您可以使用 儀錶板 API 來取得此識別碼。 兩個範例包括:embedUrl
- 您要內嵌之儀錶板磚的 URL。 此 URL 會成為包含內嵌儀錶板磚的 HTMLiframe
項目來源。 具體來說,API 會將URL指派給iframe
的src
屬性。 您可以使用 儀錶板 API 來取得此 URL。 兩個範例包括:id
- 您要內嵌之儀錶板磚的識別碼。 您可以使用 儀錶板 API 來取得此識別碼。 兩個範例包括:tokenType
- 可讓您存取所內嵌之 Power BI 數據的令牌類型。- 如果您要內嵌組織(使用者擁有數據),請使用
models.TokenType.Aad
。 - 如果您要為客戶內嵌
models.TokenType.Embed
(應用程式擁有資料)。
如需詳細資訊,請參閱 瞭解不同的內嵌解決方案。
- 如果您要內嵌組織(使用者擁有數據),請使用
type
- 您要內嵌的內容種類。 針對儀錶板磚使用'tile'
。
例
下列範例示範如何內嵌單一儀錶板磚:
// Set up the configuration object that determines what to embed and how to embed it.
let embedConfiguration = {
accessToken: anAccessToken,
dashboardId: aDashboardId,
embedUrl: anEmbedUrl,
id: aTileId,
tokenType: aTokenType,
type: 'tile'
};
// Get a reference to the HTML element that contains the embedded dashboard tile.
let tileContainer = $('#tileContainer')[0];
// Embed the dashboard.
let tile = powerbi.embed(tileContainer, embedConfiguration);