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

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

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

• 埋め込み環境を設定する。
• "組織向けの埋め込み" ("ユーザー所有データ" ともいう) サンプル アプリケーションを構成する。

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

組織向けの埋め込みソリューションは、通常、企業や大規模な組織によって、内部ユーザーのために使われます。

重要

国/地域内クラウド向けのコンテンツを埋め込む場合は、このチュートリアルの最初のいくつかの手順が異なります。 詳細については、国/地域内クラウド向けのコンテンツの埋め込みに関するページを参照してください。

コード サンプルの仕様

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

• .NET Framework
• .NET Core
• React TypeScript

注意

.NET Core と .NET Framework のサンプルを使うと、エンド ユーザーは Power BI サービスでアクセスできる任意の Power BI ダッシュボード、レポート、またはタイルを表示できます。 React TypeScript のサンプルを使うと、エンド ユーザーが Power BI サービスで既にアクセスできるレポートを 1 つだけ埋め込むことができます。

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

• Microsoft Edge
• Google Chrome
• Mozilla Firefox

前提条件

このチュートリアルを始める前に、次の Power BI とコード両方の依存関係があることを確認します。

• Power BI の依存関係

  • 独自の Microsoft Entra テナント。

    • 次のいずれかのライセンス:

      • Power BI Pro

      • Premium Per User (PPU)

    注意

    運用環境に移行するには、次のいずれかの構成が必要です。

    • Pro ライセンスを持つすべてのユーザー。
    • PPU ライセンスを持つすべてのユーザー。
    • F64 SKU と同等以上の SKU。 この構成を使用すると、すべてのユーザーが無料ライセンスを持つことができます。

• コードの依存関係

  .NET Core

  • .NET Core 3.1 SDK (またはそれ以降)

  • 統合開発環境 (IDE)。 次のいずれかの IDE を使うことをお勧めします。

    • Visual Studio

    • Visual Studio Code

  .NET Framework

  • .NET Framework 4.8

  • Visual Studio

  React TypeScript

  • テキスト エディター

  • コマンド ライン ターミナル (または PowerShell)

---

Method

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

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

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

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

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

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

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

Microsoft Entra ID にアプリケーションを登録すると、アプリの ID を確立できます。

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

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

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

ヒント

既にワークスペースがある場合は、この手順を省略できます。

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

1. Fabric にサインインします。
2. ワークスペースを選択します。
3. + 新しいワークスペースを選択します。
4. ワークスペースに名前を付けて、 [保存] を選択します。

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

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

ヒント

レポートがあるワークスペースが既に存在する場合は、この手順を省略できます。

サンプル レポート (Direct Lake 対応ではない) をダウンロードしてワークスペースに発行するには、次の手順に従います。

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

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

   

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

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

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

コンテンツを埋め込むには、いくつかのパラメーター値を取得する必要があります。 パラメーターの値は、使用するサンプル アプリケーションの言語によって異なります。 以下の表には、各サンプルに必要なパラメーター値が一覧表示されています。

パラメーター	.NET Core	.NET Framework	React TypeScript
クライアント ID
クライアント シークレット
ワークスペース ID
レポート ID

クライアント ID

ヒント

適用対象:.NET Core .NET Framework React TypeScript を

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

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

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

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

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

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

ヒント

適用対象:.NET Core .NET Framework React TypeScript を

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

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

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

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

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

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

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

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

注意

クライアント シークレットの値が最初に表示されときに、必ずそれをコピーしてください。 このページから移動すると、クライアント シークレットは表示されなくなり、その値を取得できなくなります。

ワークスペース ID

ヒント

適用対象:.NET Core .NET Framework React TypeScript を

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

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

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

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

   

レポート ID

ヒント

適用対象:.NET Core .NET Framework ReactTypeScript

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

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

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

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

   

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

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

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

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

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

   

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

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

   • .NET Core
   • .NET Framework
   • React-TS

   注意

   "組織向けの埋め込み" サンプル アプリケーションでサポートされるのは、上の一覧で示されているフレームワークのみです。 Java、Node JS および Python のサンプル アプリケーションでサポートされるのは、" 顧客向けの埋め込み " ソリューションのみです。

.NET Core

Microsoft Entra アプリを構成する

1. サインイン、 Azure ポータルします。

2. [アプリの登録] を選択します。 このオプションが表示されない場合は、検索してください。

3. 「手順 1 - Microsoft Entra アプリケーションを登録する」で作成した Microsoft Entra アプリケーションを開いてください。

4. [管理] メニューから [認証] を選択します。

5. "プラットフォーム構成" で、 [Web] プラットフォームを開き、 [リダイレクト URI] セクションで https://localhost:5000/signin-oidc を追加します。

   注意

   Web プラットフォームがない場合は、[プラットフォームを追加] を選び、[プラットフォームの構成] ウィンドウで [Web] を選びます。

6. 変更を保存します。

埋め込みサンプル アプリを構成する

1. [組織向けの埋め込み] フォルダーを開きます。

2. これらのいずれかの方法を使用して、"組織向けの埋め込みサンプル アプリ" を開きます。

   • Visual Studio を使用する場合は、UserOwnsData.sln ファイルを開きます。

   • Visual Studio Code を使用する場合は、UserOwnsData フォルダーを開きます。

3. appsettings.json を開き、次のパラメーター値を入力します。

   • ClientId - クライアント ID の GUID を使用します

   • ClientSecret - クライアント シークレットを使用します

サンプル アプリを実行する

1. 適切なオプションを選択してプロジェクトを実行します。

   • Visual Studio を使用する場合は、 [IIS Express] (再生) を選択します。

   • Visual Studio Code を使用する場合は、[実行] > [デバッグの開始] の順に選択します。

2. 埋め込みサンプル アプリケーションにサインインします。

   注意

   最初のサインイン時に、アプリに対する Microsoft Entra アクセス許可を許可するように求められます。

3. 埋め込みサンプル アプリケーションが読み込まれるとき、埋め込む Power BI コンテンツを選択し、 [埋め込む] を選択します。

   

.NET Framework

Microsoft Entra アプリを構成する

1. サインイン、 Azure ポータルします。

2. [アプリの登録] を選択します。 このオプションが表示されない場合は、検索してください。

3. 「手順 1 - Microsoft Entra アプリケーションを登録する」で作成した Microsoft Entra アプリケーションを開いてください。

4. [管理] メニューから [認証] を選択します。

5. [プラットフォームの構成] で、次のオプションを構成します。

   1. [Web] プラットフォームの [リダイレクト URI] セクションで、https://localhost:44300/ を追加します。

      注意

      [Web] プラットフォームがない場合は、 [プラットフォームを追加] を選択し、 [プラットフォームの構成] ウィンドウで [Web] を選択します。

   2. [Implicit grant and hybrid flows](暗黙的な許可およびハイブリッド フロー) で、 [ID トークン] オプションを有効にします。

6. 変更を保存します。

埋め込みサンプル アプリを構成する

1. [組織向けの埋め込み] フォルダーを開きます。

2. Visual Studio を使用して、UserOwnsData.sln ファイルを開きます。

3. Web.config を開き、次のパラメーター値を入力します。

   • clientId - クライアント ID の GUID を使用します

   • clientSecret - クライアント シークレットを使用します

サンプル アプリを実行する

1. [IIS Express] (再生) を選択して、プロジェクトを実行します。

2. 埋め込みサンプル アプリケーションにサインインします。

   注意

   最初のサインイン時に、アプリに対する Microsoft Entra アクセス許可を許可するように求められます。

3. 埋め込みサンプル アプリケーションが読み込まれるとき、埋め込む Power BI コンテンツを選択し、 [埋め込む] を選択します。

   

React TypeScript

Microsoft Entra アプリを構成する

1. サインイン、 Azure ポータルします。

2. [アプリの登録] を選択します。 このオプションが表示されない場合は、検索してください。

3. 「手順 1 - Microsoft Entra アプリケーションを登録する」で作成した Microsoft Entra アプリケーションを開いてください。

4. [管理] メニューから [認証] を選択します。

5. "プラットフォーム構成" で、 [Web] プラットフォームを次のように構成します。

   1. [リダイレクト URI] で、https://localhost:3000 を追加して [構成] を選びます。

      注意

      Web プラットフォームがない場合は、[プラットフォームを追加] を選び、[プラットフォームの構成] ウィンドウで [Web] を選びます。

   2. [Implicit grant and hybrid flows](暗黙的な許可およびハイブリッド フロー) で、次の両方のオプションを有効にします。

      • アクセス トークン
      • ID トークン

6. 変更を保存します。

埋め込みサンプル アプリを構成する

1. [組織向けの埋め込み]>UserOwnsData>src フォルダーの順に開きます。

2. テキスト エディターを使用して、Config. ts ファイルを開き、次のパラメーター値を入力します。

   • clientId - クライアント ID の GUID を使用します

   • workspaceId - ワークスペース ID を使用します

   • reportId - レポート ID を使用します

3. ファイルを保存します。

サンプル アプリを実行する

1. ターミナルを開き、[組織に埋め込む]>UserOwnsData に移動します。

2. 次のコマンドを入力して、必要な依存関係をインストールします。

   npm install

3. 次のコマンドを入力して、アプリケーションを実行します。

   npm run start

   注意

   最初のサインイン時に、アプリに対する Microsoft Entra アクセス許可を許可するように求められます。

自分のアプリケーションを開発する

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

ユーザーのアクセス許可を更新する

ユーザーには、レポートが含まれる Power BI フォルダーにアクセスするためのアクセス許可が必要です。 フォルダーにアクセスするためのアクセス許可をユーザーに付与する場合、通常、変更はそのユーザーが Power BI ポータルにログインした後でのみ有効になります。 新しいアクセス許可をすぐに有効にするには、Embedded シナリオで、起動時に RefreshUser Permissions REST API を明示的に呼び出します。 この API 呼び出しにより、アクセス許可が更新され、新しく付与されたアクセス許可を持つユーザーに対する承認エラーが回避されます。

関連するコンテンツ

• チュートリアル: "顧客向けの埋め込み" サンプル アプリケーションを使用して Power BI コンテンツを埋め込む
• ページ分割されたレポートを埋め込む

Power BI コミュニティに質問する