次の方法で共有


Power BI のページ分割されたレポートを埋め込む

Power BI 埋め込み分析を使用すると、完全に統合された対話型アプリケーションにページ分割されたレポートが表示される Power BI コンテンツを作成できます。 最適なソリューションを使用してページ分割されたレポートを、顧客向けまたは組織向けに埋め込むことができます。

この記事では、埋め込みのサンプル チュートリアルを使用して、ページ分割されたレポートを埋め込む方法について説明します。

前提条件

開始するには、以下が必要です。

Azure サブスクリプションをお持ちでない場合は、始める前に無料アカウントを作成してください。

メソッド

サンプル アプリを使用してページ分割されたレポートを埋め込むには、次の手順に従います。

  1. ワークスペースを作成します

  2. 容量を作成します

  3. 容量にワークスペースを割り当てます

  4. ページ分割されたレポートを作成してアップロードします

  5. サンプル アプリケーションを使用してコンテンツを埋め込みます

ステップ 1 - ワークスペースを作成する

サービス プリンシパルを使ってアプリケーションにサインインしている場合は、ワークスペースを作成する必要があります。

また、サービス プリンシパルは、Power BI ワークスペースの管理者またはメンバーである必要があります。

ステップ 2 - 容量を作成する

埋め込み対象の改ページ対応レポートをインポートまたはアップロードする前に、レポートを含むワークスペースを容量に割り当てる必要があります。

必要な容量の種類を確認するには、Microsoft Fabric の概念 を参照してください。

ステップ 3 - 容量にワークスペースを割り当てる

容量を作成したら、アプリ ワークスペースをその容量に割り当てます。

サービス プリンシパルを使って容量をワークスペースに割り当てるには、Power BI REST API を使います。 Power BI REST API の使用時は必ずサービス プリンシパル オブジェクト ID を使ってください。

注意

Power BI REST API を使用して、ページ分割されたレポートをワークスペースにインポートすることもできます。

ステップ 4 - ページ分割されたレポートを作成してアップロードする

Power BI レポート ビルダーを使用して、ページ分割されたレポートを作成し、レポートをサービスにアップロードできます。

注意

改ページ対応レポートをアップロードするユーザーには、ワークスペースに発行するための Power BI Pro または Premium Per User (PPU) のライセンスが必要です。

ステップ 5 - サンプル アプリケーションを使用してコンテンツを埋め込む

顧客向けにコンテンツを埋め込む」チュートリアルの手順に従います。 「ステップ 4 - Power BI レポートを作成して発行する」をスキップし、チュートリアルで示したサンプル レポートの代わりに、アップロード済みの改ページ対応レポートを使います。

  • Power BI のセマンティック モデルをデータ ソースとして使用するには:

    • テナント設定 [XMLA エンドポイントとオンプレミスのデータセットによる "Excel で分析" の許可] が有効になっていることを確認します。
    • Power BI ポータルで、「Premium 容量の読み取り/書き込みを有効にするには」の説明に従って、[XMLA エンドポイント] [読み取り専用] または [読み取り/書き込み] に設定します。 エンドポイントを設定する必要があるのは、容量ごとに 1 回だけです。
    • 要求内に指定したデータセット ID読み込み専用 に設定した XmlaPermissions を使用し、マルチリソース埋め込みトークンを生成します。
  • シングル サインオン (SSO) が有効なデータ ソースを使うには:

    • データ ソースが改ページ対応レポートに直接接続する場合、改ページ対応レポートのデータ ソースである Power BI セマンティック モデルに接続する場合、Power BI は SSO 対応データ ソースをサポートします。
    • SSO 対応データ ソースを使って改ページ対応レポートを埋め込む場合は、DatasourceIdentityを生成するときに、データ ソースの ID BLOB を に指定する必要があります。

埋め込みトークンの詳細については、「埋め込み分析アクセス トークン」を参照してください。

考慮事項と制限事項

  • サポートされているデータセットとその認証方法の完全な一覧については、「Power BI のページ分割されたレポートでサポートされるデータ ソース」を参照してください。
  • サービス プリンシパルを使用する必要があります。 マスター ユーザーを持つことはできません。
  • Premium Per User (PPU) は使用できません。
  • Power BI セマンティック モデルを使って改ページ対応レポートを埋め込む場合、2 つの条件が適用されます。
    • 改ページ対応レポートと Power BI セマンティック モデルは、Premium Per Capacity または Embedded ワークスペースに存在する必要があります (2 つの異なるワークスペースに存在することができます)。
    • 埋め込みトークンを生成するユーザーには、レポートとセマンティック モデルの両方のワークスペースで、"書き込み" アクセス許可が必要です。
  • 現在、シングル サインオン (SSO) が有効な Azure Analysis Services に接続されている改ページ対応レポートを埋め込むことはできません。
  • 改ページ対応レポートでは、クライアント側のイベント (loadedrendered など) はサポートされていません
  • ページ分割されたレポートでは、クライアント側の setAccessToken API はサポートされていません (レポートを再読み込みせずにアクセス トークンを更新することはできません)。
  • リアルタイム データセット (プッシュ データセット) を使った改ページ対応レポートの埋め込みは、サポートされていません。