Power Apps の Power BI タイルコントロール

2025-10-04

アプリ内の Power BI タイルを表示するコントロール。

Description

アプリ内に Power BI タイル を表示して、既存のデータ分析とレポートを活用します。オプションパネルの [データ] タブでワークスペース、ダッシュボード、タイルのプロパティを設定して、表示するタイルを指定します。

注

POWER BI タイルコントロールは、 GCC High および DoD 環境では使用できません。
Power BI タイルコントロールは中国では使用できません。
Power BI タイルを埋め込む際のライセンス要件については、「ライセンス」を参照してください。

Power BI コンテンツを含むアプリを共有する場合は、アプリ自体だけでなく、タイルの由来となるダッシュボードも共有する必要があります。それ以外の場合、アプリを開いたユーザーの場合でも、Power BI コンテンツは表示されません。 Power BI コンテンツを含むアプリは、そのコンテンツのアクセス許可を尊重します。

Performance

アプリ内で 3 つ以上の Power BI タイルを同時に読み込むのはお勧めしません。タイルの読み込みとアンロードは、 LoadPowerBIContent プロパティを設定することで制御できます。

埋め込みオプション

埋め込みは、Power BI API のバージョンによって異なります。新しい Power BI API 認証スキームにより、タイルにモバイルまたは他の埋め込みシナリオ (Teams または SharePoint) でアクセスできない場合があります。

AllowNewAPI プロパティを使用して、API バージョンの使用を制御できます。詳細については、「キーのプロパティ」を参照してください。

AllowNewAPI プロパティ値	行動
正しい	Power BI から埋め込み URL を取得し、 TileUrl 値にすることで、ダッシュボード、レポート、またはタイルを埋め込むことができます。
いいえ	ダッシュボードタイルを埋め込むには、 URL を埋め込んでTileUrl 値にするか、提供されたグラフィカルインターフェイスを使用します。

注

Power BI URL の認証はモバイルプレーヤーでは処理されないため、Power BI URL の埋め込み (IFrame など) は Power Apps モバイルではサポートされていません。

フィルタリング

フィルター処理は、Power BI API のバージョンによって異なります。コントロールの構成方法に応じて、以下の適切なセクションを参照してください。

新しい API を使用して Power BI サービスを呼び出す場合

AllowNewAPI プロパティが "True" に設定されている場合は、新しい API を使用して Power BI サービスを呼び出しています。詳細については、「URL でクエリ文字列パラメーターを使用してレポートをフィルター処理する」を参照してください。

元の API を使用して Power BI サービスを呼び出す場合

AllowNewAPI プロパティが "False" に設定されている場合は、元の API を使用して Power BI サービスを呼び出しています。この場合、アプリから 1 つのパラメーターを渡すことで、Power BI タイルに表示される結果をフィルター処理できます。ただし、文字列値と等号演算子のみがサポートされており、テーブル名または列名にスペースが含まれている場合は、フィルターが機能しない可能性があります。

1 つのフィルター値を渡すには、次の構文に従って TileURL プロパティの値を変更します。

"https://app.powerbi.com/embed?dashboardId=<DashboardID>&tileId=<TileID>&config=<SomeHash>"

その値に、次の構文を追加します。

&$filter=<TableName>/<ColumnName> eq '<Value>'

たとえば、リストボックスの値を使用するとします。

"&$filter=Store/Territory eq '" & ListBox1.Selected.Abbr & "'"

このパラメーターは、タイルが生成されたレポートのデータセット内の値をフィルター処理します。ただし、フィルター処理機能には次の制限があります。

適用できるフィルターは 1 つだけです。
eq演算子のみがサポートされています。
フィールド型は文字列である必要があります。
フィルター処理は、ピン留めされた視覚化タイルでのみ使用できます。ピン留めされたレポートではサポートされていません。
R と Python スクリプトのビジュアルをフィルター処理することはできません。

Power BI レポートの計算フィールドを使用して、他の値の型を文字列に変換したり、複数のフィールドを 1 つに結合したりできます。

重要なプロパティ

AllowNewAPI - Power BI サービスを呼び出すときに新しい API を使用するかどうかを指定します。値を True に設定すると、新しい Power BI API を使用できるようになります (モバイルおよび一部の埋め込みシナリオではサポートされていませんが、より高度なフィルター処理が可能になります)。 False は元の API を使用します。既定値は false です。

ダッシュボード – タイルの由来となる Power BI ダッシュボード。

LoadPowerBIContent – True に設定すると、Power BI コンテンツが読み込まれて表示されます。 False に設定すると、Power BI コンテンツがアンロードされ、メモリが解放され、パフォーマンスが最適化されます。

PowerBIInteractions - True に設定すると、Power BI コンテンツを操作できますが、Power Apps OnSelect イベントはトリガーされません。 False に設定すると、タイルを操作できませんが、タイルが選択されると Power Apps OnSelect イベントがトリガーされます。

タイル – 表示する Power BI タイルの名前。

ワークスペース – タイルの由来となる Power BI ワークスペース。

追加のプロパティ

BorderColor – コントロールの境界線の色。

BorderStyle – コントロールの境界線が Solid、Dashed、Doted、None のいずれであるか。

BorderThickness – コントロールの境界線の太さ。

DisplayMode – コントロールでユーザー入力 (編集) を許可するか、データのみを表示するか (表示)、無効 (無効) にするかを指定します。

Height – コントロールの上端と下端の間の距離。

OnSelect – ユーザーがコントロールを選択したときに実行するアクション。既定では、タイルに関連付けられている Power BI レポートが開きます。

TileUrl – Power BI サービスからタイルを要求する URL。 URL にクエリ文字列のフィルター処理を追加するには、上記のフィルター処理のセクションを参照してください。

表示 – コントロールが表示されるか非表示になっているか。

幅 – コントロールの左端と右端の間の距離。

X – コントロールの左端とその親コンテナーの左端との間の距離 (親コンテナーがない場合は画面)。

Y – コントロールの上端と親コンテナーの上端との間の距離 (親コンテナーがない場合は画面)。

Example

[ 挿入 ] タブで、[ グラフ ] メニューを開き、 Power BI タイル コントロールを追加します。

コントロールを追加して構成する方法がわからない場合
オプションパネルの [データ] タブで、[ワークスペース] 設定で [マイワークスペース] を選択します。
ダッシュボードの一覧でダッシュボードを選択し、タイルの一覧でタイルを選択します。

コントロールによって Power BI タイルがレンダリングされます。

アクセシビリティガイドライン

Power BI タイルは、単に Power BI コンテンツのコンテナーです。これらの Power BI アクセシビリティに関するヒントを使用して、アクセシビリティの高いコンテンツを作成する方法について説明します。

Power BI コンテンツにタイトルがない場合は、スクリーンリーダーをサポートするために ラベル コントロールを使用して見出しを追加することを検討してください。 Power BI タイルの直前にラベルを配置できます。

フィードバック

このページはお役に立ちましたか?