次の方法で共有


チュートリアル:"組織向けの埋め込み" サンプル アプリケーションを使用して 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 とコード両方の依存関係があることを確認します。


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 を使用して独自のレポートを作成してから、ワークスペースにそれを発行することができます。 ワークスペースにサンプル レポートをアップロードすることもできます。

ヒント

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

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

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

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

    GitHub の Power BI Desktop サンプルの 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/ の間にある数値です。

    Power BI サービス URL にワークスペース ID GUID を示すスクリーンショット

レポート ID

ヒント

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

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

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

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

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

    Power BI サービスの URL のレポート ID GUID を示すスクリーンショット

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

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

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

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

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

    GitHub の Power BI 開発者向けサンプルの ZIP ダウンロード オプションを示すスクリーンショット

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

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

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

    注意

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

Microsoft Entra アプリを構成する

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

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

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

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

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

    注意

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

  2. 変更を保存します。

.NET Core アプリ サンプルのアプリ認証の構成と Web リダイレクト URI を示す Azure portal のウィンドウのスクリーンショット。

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

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

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

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

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

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

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

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

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

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

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

    Note

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

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

    Power BI 埋め込みサンプル アプリのスクリーンショット。

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

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

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

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

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