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

  • [アーティクル]

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

Power BI を持っていない場合は? サインアップ。

内容

アプリ内の Power BI タイル を表示することにより、既存のデータ分析とレポートを活用します。 オプション パネルの データ タブで Workspace、Dashboard、および Tile のプロパティを設定することで、表示するタイルを指定します。

注意

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

共有とセキュリティ

Power BI コンテンツを含むアプリを共有するときは、アプリ自体だけでなく、タイルの取得元である ダッシュボード も共有する必要があります。 さもなければ、アプリを開いたユーザーにも Power BI コンテンツは表示されません。 Power BI コンテンツを含むアプリには、そのコンテンツに対するアクセス許可が適用されます。

パフォーマンス

アプリ内に同時に 4 つ以上の Power BI タイルを読み込むことは推奨されません。 LoadPowerBIContent プロパティを設定することにより、タイルの読み込みとアンロードを制御できます。

埋め込みオプション

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

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

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

注意

埋め込み Power BI URL (IFrame など) は、Power BI URL リクエストの認証はモバイル プレーヤーでは処理されないことから 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 タイルに表示される結果をフィルター処理できます。 ただし、サポートされているのは文字列値と等価演算子のみであり、テーブル名または列名にスペースが含まれていると、フィルターが機能しない場合があります。

単一のフィルター値を渡すには、次の構文に従って 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 です。

Dashboard – タイルの取得元である Power BI ダッシュボード。

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

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

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

Workspace – タイルの取得元である Power BI ワークスペース。

追加のプロパティ

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

BorderStyle – コントロールの境界線が実線、破線、点線、またはなしかどうか。

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

DisplayMode – コントロールがユーザー入力を許可するか (編集)、データのみを表示するか (表示)、または無効にするか (無効) どうか。

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

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

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

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

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

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

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

例

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

    コントロールの追加および構成 についてはこちらをご覧ください。

  2. オプション パネルの データ タブで、Workspace 設定の 自分のワークプレース を選択します。

  3. ダッシュボードの一覧でダッシュボードを選択してから、タイルの一覧でタイルを選択します。

    コントロールでは、Power BI タイルを表示します。

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

Power BI tileは、Power BI コンテンツのコンテナーです。 アクセシビリティ対応のコンテンツを作成する方法については、Power BI のアクセシビリティに関するヒント を参照してください。

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

注意

ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)

この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。