まず、PowerBIを埋め込むには2つのモードがあることを知っておく必要があります-user owns data
app owns data
。最初のモードでは、埋め込み時に、ユーザーは独自のPower BI Proアカウントを使用して自分自身を認証します。つまり、各ユーザーにはPowerBIProライセンスが必要です。後者の場合、認証に使用される「マスターアカウント」は1つだけ必要です。実装の違いはそれほど大きくないので、app owns data
について説明します。 。
次のことを行う必要があります:
-
アプリケーションを登録します-
dev.powerbi.com/apps にアクセスします ネイティブアプリケーションを登録します。付与する権限を選択します(不明な場合は、最初のテストですべてを付与するだけです)。 GUIDをコピーします-これはアプリID、別名クライアントIDです。 -
次のステップは、アプリケーションから認証し、アクセストークンを取得することです。 Azure Active Directory認証ライブラリ( ADAL) そのために-
acquireToken
のいくつかを呼び出しますAuthenticationContext
のメソッド クラス。 -
このアクセストークンを使用して、Power BI REST APIを呼び出し、
embedUrl
を取得します 埋め込みたい要素の例: レポート 。 -
PowerBIJavaScriptクライアント を使用します この要素を実際に埋め込みます。 1つの
埋め込み構成クラス を初期化する必要があります 要素タイプ(レポート、ダッシュボード、タイル)、その場所(embedUrl)、認証(アクセストークン)、その他の構成オプション(フィルターペインの表示または非表示、ナビゲーションなど)、適用するフィルター、およびすぐ。上記で取得したアクセストークンを使用する場合は、 tokenType
を設定してください。AAD
になる 。このトークンには多くの権限があるため、セキュリティ上の理由から、Embed
を使用することをお勧めします 代わりにトークン。この場合、アクセストークンを使用してREST APIを再度呼び出します(例:レポートGenerateTokenInGroup 。 -
powerbi.embed
を呼び出す JavaScriptクライアントのメソッドは、埋め込まれた構成を渡して、アプリでこのPowerBI要素を視覚化します。
ここにあなたが読むべきいくつかのリソースがあります:
- チュートリアル:Embed Power顧客向けのアプリケーションへのBIコンテンツ
- チュートリアル: PowerBIコンテンツを組織のアプリケーションに埋め込む
- 埋め込みの基本
- Power BI Embedded Playground
- PowerBI開発者サンプル