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

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

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

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

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

コード サンプルの仕様

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

• .NET Framework
• .NET Core
• React TypeScript

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

• 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 Framework
  • React TypeScript

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

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

    • Visual Studio

    • Visual Studio Code

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 ワークスペースを作成する

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

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

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

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

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

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

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

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

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

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

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

   

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

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

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

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

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

クライアント ID

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

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

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

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

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

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

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

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

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

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

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

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

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

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

ワークスペース ID

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

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

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

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

   

レポート ID

テナント 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 のサンプル アプリケーションでサポートされるのは、" 顧客向けの埋め込み " ソリューションのみです。

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

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

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

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

関連するコンテンツ