ダッシュボード タイルを埋め込む
ヒント
ダッシュボード タイルを埋め込むか、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。 ダッシュボード API を使用して、この ID を取得できます。 次に 2 つの例を示します。embedUrl
- 埋め込むダッシュボード タイルの URL。 この URL は、埋め込みダッシュボード タイルを含む HTMLiframe
要素のソースになります。 具体的には、API によって URL が .の属性iframe
にsrc
割り当てられます。 ダッシュボード API を使用して、この URL を取得できます。 次に 2 つの例を示します。id
- 埋め込むダッシュボード タイルの ID。 ダッシュボード 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);