チュートリアル: "顧客向けの埋め込み" サンプル アプリケーションを使用して Power BI コンテンツを埋め込む

適用対象: アプリ所有データ ユーザー所有データ

埋め込み分析と Power BI Embedded (Azure プラン) を使用すると、レポート、ダッシュボードおよびタイルなどの Power BI コンテンツをアプリケーションに埋め込むことができます。

このチュートリアルでは、次の方法について説明します。

アプリケーションを使用するために、ユーザーが Power BI にサインインしたり、Power BI ライセンスを持つ必要はありません。

独立ソフトウェア ベンダー (ISV) や開発者 (サード パーティ向けのアプリケーションを作成する必要がある) の場合は、"顧客向けの埋め込み" 方法を使用して Power BI コンテンツを埋め込むことをお勧めします。

コード サンプルの仕様

このチュートリアルには、次のフレームワークのいずれかで "顧客向けの埋め込み" サンプル アプリケーションを構成する手順が含まれています。

• .NET Framework
• .NET Core
• Java
• Node JS
• Python

このコード サンプルでは次のブラウザーがサポートされています。

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

前提条件

このチュートリアルを開始する前に、以下に一覧表示されている Power BI とコードの両方の依存関係があることを確認してください。

• Power BI の依存関係

  • 独自の Microsoft Entra テナント。

  • Power BI に対してアプリを認証するには、次のいずれかが必要です。

    • サービス プリンシパル - Microsoft Entra ID がアプリを認証できるようにする Microsoft Entra サービス プリンシパル オブジェクト。

    • Power BI Pro ライセンス - これがマスター ユーザーになり、アプリでこれを使用して Power BI に対する認証を行います。

    • Power BI の Premium Per User (PPU) ライセンス - これがマスターユーザーになり、アプリでこれを使用して Power BI に対する認証を行います。

    注意

    運用を開始するには、容量が必要です。

• コードの依存関係

Method

"顧客向けの埋め込み" サンプル アプリを作成するには、これらの手順に従います。

1. 認証方法を選択します。

2. Microsoft Entra アプリケーションを登録する

3. Power BI ワークスペースを作成します。

4. Power BI レポートを作成して発行します。

5. 埋め込みパラメーター値を取得します。

6. サービス プリンシパル API アクセス

7. ワークスペース アクセスを有効にします。

8. コンテンツを埋め込みます。

手順 1 - 認証方法を選択する

埋め込みソリューションは、選択する認証方法によって異なります。 そのため、認証方法の違いを理解し、ソリューションに最適なものを決定することが重要です。

以下の表で、サービス プリンシパルとマスター ユーザーの認証方法のいくつかの主な違いについて説明します。

手順 2 - Microsoft Entra アプリケーションを登録する

Microsoft Entra ID にアプリケーションを登録すると、次のことが可能になります。

Microsoft Entra ID にアプリケーションを登録するには、アプリケーションの登録に関する手順に従います。

手順 3 - Power BI ワークスペースを作成する

Power BI により、レポート、ダッシュボード、およびタイルがワークスペースに保持されます。 これらのアイテムを埋め込むには、それらを作成してワークスペースにアップロードする必要があります。

ワークスペースを作成するには、次のようにします。

1. Power BI にサインインします。

2. [ワークスペース] を選択します。

3. [ワークスペースの作成] を選択します。

4. ワークスペースに名前を付けて、 [保存] を選択します。

手順 4 - Power BI レポートを作成して発行する

次の手順では、レポートを作成してワークスペースにアップロードします。 Power BI Desktop を使用して独自のレポートを作成してから、ワークスペースにそれを発行することができます。 ワークスペースにサンプル レポートをアップロードすることもできます。

サンプル レポートをダウンロードしてワークスペースに発行するには、これらの手順に従います。

1. GitHub の Power BI Desktop サンプル フォルダーを開きます。

2. [コード] を選んでから、 [ZIP のダウンロード] を選択します。

   

3. ダウンロードした ZIP を抽出し、Samples Reports フォルダーに移動します。

4. 埋め込むレポートを選択し、自分のワークスペースに発行します。

手順 5 - 埋め込みパラメーター値を取得する

コンテンツを埋め込むには、特定のパラメーター値を取得する必要があります。 以下の表には必須の値が表示されており、"サービス プリンシパル" 認証方法、"マスター ユーザー" 認証方法、あるいはその両方に適用できるかどうかが示されています。

コンテンツを埋め込む前に、以下に一覧表示されているすべての値があることを確認してください。 一部の値は、使用する認証方法によって異なります。

パラメーター	サービス プリンシパル	マスター ユーザー
クライアント ID
ワークスペース ID
レポート ID
クライアント シークレット
テナント ID		Node JS の場合のみ必要
Power BI ユーザー名
Power BI パスワード

Client ID

クライアント ID GUID ("アプリケーション ID" とも呼ばれます) を取得するには、これらの手順に従います。

1. Microsoft Azure にログインします。

2. [アプリの登録] を検索し、 [アプリの登録] リンクを選択します。

3. Power BI コンテンツを埋め込むために使用する Microsoft Entra アプリを選択します。

4. [概要] セクションで、 [アプリケーション (クライアント) ID] の GUID をコピーします。

ワークスペース ID

ワークスペース ID の GUID を取得するには、これらの手順に従います。

1. Power BI サービスにサインインします。

2. 埋め込むレポートを開きます。

3. URL から GUID をコピーします。 GUID は /groups/ と /reports/ の間にある数値です。

   

または、[管理ポータル] の設定で、ワークスペース名の横にある [詳細] を選択して、ワークスペース ID を見つけることもできます。

レポート ID

テナント ID GUID を取得するには、次の手順に従います。

1. Power BI サービスにサインインします。

2. 埋め込むレポートを開きます。

3. URL から GUID をコピーします。 GUID は /reports/ と /ReportSection の間にある数値です。

   

クライアント シークレット

クライアント シークレットを取得するには、これらの手順に従います。

1. Microsoft Azure にログインします。

2. [アプリの登録] を検索し、 [アプリの登録] リンクを選択します。

3. Power BI コンテンツを埋め込むために使用する Microsoft Entra アプリを選択します。

4. [管理] で、[証明書とシークレット] を選択します。

5. [クライアント シークレット] で、 [新しいクライアント シークレット] を選択します。

6. [クライアント シークレットの追加] ポップアップ ウィンドウで、アプリケーション シークレットの説明を入力し、アプリケーション シークレットの有効期限を選択し、 [追加] を選択します。

7. [クライアント シークレット] セクションで、新しく作成されたアプリケーション シークレットの [値] 列にある文字列をコピーします。 そのクライアント シークレットの値が "クライアント ID" です。

テナント ID

テナント ID GUID を取得するには、これらの手順に従います。

1. Microsoft Azure にログインします。

2. [アプリの登録] を検索し、 [アプリの登録] リンクを選択します。

3. Power BI コンテンツを埋め込むために使用する Microsoft Entra アプリを選択します。

4. [概要] セクションで、 [ディレクトリ (テナント) ID] の GUID をコピーします。

Power BI のユーザー名とパスワード

マスター ユーザーとして使用する Power BI ユーザーの "ユーザー名" と "パスワード" を取得します。 これは、Power BI サービスで、ワークスペースを作成してレポートをアップロードするために使用したものと同じユーザーです。

手順 6 - サービス プリンシパル API アクセス

Microsoft Entra アプリから Power BI コンテンツおよび API にアクセスできるようにするには、Power BI 管理者が Power BI 管理ポータルでサービス プリンシパル アクセスを有効にする必要があります。 テナントの管理者でない場合は、テナントの管理者に連絡し、 [テナント設定] を有効にしてもらってください。

1. "Power BI サービス" で、 [設定]>[設定]>[管理ポータル] の順に選択します。

   

2. [テナント設定] を選択してから、 [開発者の設定] セクションまで下にスクロールします。

3. [Power BI API の使用をサービス プリンシパルに許可] を展開し、このオプションを有効にします。

   

手順 7 - ワークスペース アクセスを有効にする

Power BI サービスでレポート、ダッシュボード、セマンティック モデルなどの Microsoft Entra アプリのアクセス オブジェクトを有効にするには、"サービス プリンシパル" または "マスター ユーザー" を "メンバー" または "管理者" としてご利用のワークスペースに追加します。

1. Power BI サービスにサインインします。

2. アクセスを有効にするワークスペースまでスクロールし、 [その他] メニューで、 [ワークスペース アクセス] を選択します。

   

3. [アクセス] ペインで、使用する認証方法に応じて、"サービス プリンシパル" または "マスター ユーザー" を [メール アドレスの入力] テキスト ボックスにコピーします。

   Note

   "サービス プリンシパル" を使用する場合、その名前は Microsoft Entra アプリに指定した名前になります。

4. [追加] を選択します。

手順 8 - コンテンツを埋め込む

Power BI の埋め込みサンプル アプリケーションを使用すると、Power BI の "顧客向けの埋め込み" アプリを作成できます。

Power BI レポートを埋め込むには、これらの手順に従って、"顧客向けの埋め込み" サンプル アプリケーションを変更します。

1. Power BI の開発者向けサンプル フォルダーを開きます。

2. [コード] を選んでから、 [ZIP のダウンロード] を選択します。

   

3. ダウンロードした ZIP ファイルを抽出し、PowerBI-Developer-Samples-master フォルダーに移動します。

4. アプリで使用する言語に応じて、次のいずれかのフォルダーを開きます。

   • .NET Core
   • .NET Framework
   • Java
   • Node JS
   • Python

   注意

   "顧客向けの埋め込み" サンプル アプリケーションでサポートされるのは、上記の一覧にあるフレームワークのみです。 React サンプル アプリケーションでサポートされるのは、" 組織向けの埋め込み " ソリューションのみです。

5. 顧客向けの埋め込みフォルダーを開きます。

アプリケーションの開発

"顧客向けの埋め込み" サンプル アプリケーションを構成して実行した後、独自のアプリケーションの開発を開始できます。

開発を開始し、Power BI Embedded のすべての新機能と更新プログラムに対応するには、Power BI 埋め込み分析プレイグラウンドをお試しください。

準備ができたら、運用開始の要件を確認します。 また、容量が必要であり、キャパシティ プランニングに関する記事を参照して、ニーズに最も適した SKU を確立する必要があります。

関連するコンテンツ

• 運用環境への移行
• 組織向けの埋め込み
• ページ分割されたレポートを埋め込む

他にわからないことがある場合は、 Power BI コミュニティでご質問ください。