ダッシュボード タイルを埋め込む

  • [アーティクル]

先端

ダッシュボード タイルを埋め込むか、Power BI Embedded Analytics Playgroundの「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 - 埋め込むタイルを含むダッシュボードの ID。 Dashboards API を使用して、この ID を取得できます。 2 つの例を次に示します。

  • embedUrl - 埋め込むダッシュボード タイルの URL。 この URL は、埋め込みダッシュボード タイルを含む HTML iframe 要素のソースになります。 具体的には、API によって、iframeの src 属性に URL が割り当てられます。 Dashboards API を使用して、この URL を取得できます。 2 つの例を次に示します。

  • id - 埋め込むダッシュボード タイルの ID。 Dashboards API を使用して、この ID を取得できます。 2 つの例を次に示します。

  • tokenType - 埋め込む Power BI データへのアクセスを提供するトークンの種類。

    • 組織用に埋め込む場合 (ユーザーがデータを所有している) 場合は、models.TokenType.Aad を使用します。
    • 顧客用に埋め込む場合 (アプリがデータを所有している) 場合は、models.TokenType.Embed を使用します。

    詳細については、「さまざまな埋め込みソリューション を理解する」を参照してください。

  • type - 埋め込むコンテンツの種類。 ダッシュボード タイルに 'tile' を使用します。

例

次の例は、1 つのダッシュボード タイルを埋め込む方法を示しています。

// 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);

関連コンテンツ