內嵌儀錶板磚
提示
請嘗試在 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);