組織向けのコンテンツを埋め込むときに Power BI アプリを自動的にインストールする

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

アプリからコンテンツを埋め込むには、ユーザーは埋め込むコンテンツが含まれるアプリにアクセスする必要があります。 アプリがインストールされていない場合は、埋め込みは失敗します。 アプリからのコンテンツの埋め込みを容易にするため、組織の PowerBI.com でアプリの自動インストールを設定できます。 アプリの自動インストールの定義はテナント レベルのアクションであり、すべてのアプリに適用されます。

コンテンツの埋め込み時にアプリを自動的にインストールする

インストールされていないアプリにアクセスして、アプリのコンテンツを埋め込もうとすると、埋め込みは失敗します。 この問題を回避するには、コンテンツの埋め込み時のアプリの自動インストールを許可します。 自動インストールを許可すると、ユーザーが埋め込もうとしているコンテンツの基になっているアプリがインストールされていない場合、そのユーザーに対してアプリが自動的にインストールされます。 アプリを自動的にインストールすると、ユーザーのエクスペリエンスがスムーズになります。

Power BI ユーザー向けの埋め込み (ユーザー所有データ)

ユーザーのアプリの自動インストールを許可するには:

  1. アプリケーションを登録する場合は、API の作成アクセス許可をアプリケーションに追加します。 アプリを既に登録している場合は、アプリケーションのアクセス許可を変更して、API の作成アクセス許可を追加します。

    [Create APIs] (API の作成) オプションが選ばれている、Power BI 埋め込みセットアップ ツールのスクリーンショット。

  2. 埋め込み URL でアプリ ID を指定します。 アプリ ID を指定するには、アプリの作成者は、アプリをインストールしてから、サポートされている Power BI REST API 呼び出し (レポートの取得ダッシュボードの取得など) のいずれかを使う必要があります。 アプリの作成者は、REST API の応答から埋め込み URL を取得する必要があります。 コンテンツがアプリからのものである場合、アプリ ID は URL 内に含まれています。

  3. 埋め込み URL を使ってコンテンツを埋め込みます。

セキュリティ保護された埋め込み

アプリケーションの自動インストールを使うには、アプリ作成者がアプリをインストールする必要があります。 その後、アプリ作成者は、PowerBI.com でアプリに移動し、レポートに移動して、リンクを取得する必要があります。 そのリンクを使用可能なアプリにアクセスできる他のすべてのユーザーは、そのレポートを埋め込むことができます。

考慮事項と制限事項

  • このシナリオで埋め込むことができるのは、レポートとダッシュボードのみです。

  • 現在、アプリ所有データまたは SharePoint の埋め込みシナリオでは、この機能はサポートされていません。