PowerApps から Power BI に接続するConnect to Power BI from PowerApps

Power BI

Power BI は、データを分析し、洞察を共有するビジネス分析用ツール群です。Power BI is a suite of business analytics tools to analyze data and share insights. すべてのデバイスで使用できる豊富なダッシュ ボードで、お客様のビジネスを監視し、すばやく回答を取得します。Monitor your business and get answers quickly with rich dashboards available on every device. アプリでは、Power BI サービスで設定しているデータ アラートの状態を確認できます。In your app, you can check the status of the data alerts that you have set up in the Power BI service. Power BI でのデータ アラートの詳細については、ドキュメント ページを参照してください。For more information on data alerts in Power BI, head to the documentation page.

このトピックでは、アプリで Power BI の接続を使用する方法を説明し、使用可能な関数の一覧を表示します。This topic shows you how to use the Power BI connection in an app, and lists the available functions.

前提条件Prerequisites

アプリで Power BI の接続を使用するUse the Power BI connection in your app

Power BI サービスで設定したアラートを一覧表示しますList the alerts that you've set up in the Power BI service

  1. [挿入] メニューで、[ギャラリー] を選択し、[テキスト ギャラリー] のいずれかを追加します。On the Insert menu, select Gallery, and add any of the Text galleries.
  2. 現在のユーザーのアラートを表示するには、ギャラリーの [項目] プロパティを次の数式に設定します。To show the current user's alerts, set the Items property of the gallery to the following formula:

    PowerBI.GetAlerts()

ギャラリーは、アラートの一覧で更新されます。The gallery will update with the list of alerts. 各アラートについて、アラートの名前、アラートの ID 番号、およびアラートが構成されたグループ ワークスペースの ID が表示されます。For each alert, you will receive the alert name, the ID number of the alert, and the ID of the group workspace in which the alert was configured. アラートの詳細情報を取得するには、アラート ID が必要です。You will need the alert ID to get further information about the alert.

アラートの状態を表示しますView the status of an alert

アラートの状態を表示するには、上記の手順から取得したアラート ID で CheckAlertStatus 関数を呼び出します。To view the status of the alert, call the CheckAlertStatus function with the alert ID obtained from the step above.

アラート ID は、リテラル文字列 (例: "1234") として渡すことも、GetAlerts() の呼び出しを使って設定するギャラリー セクションへの参照 (例: Gallery1.Selected.alertId) として渡すこともできます。The alert ID can be passed in either as a literal string (e.g. "1234") or as a reference to a gallery section populated using the GetAlerts() call (e.g. Gallery1.Selected.alertId)

続行するには、ラベルを追加し、その [テキスト] プロパティをこれらの数式のいずれかに設定します。To proceed, add a label, and then set its Text property to one of these formulas:

  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertTitle
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).currentTileValue
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertThreshold
  • PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).isAlertTriggered

ラベルは、アラートの現在の状態が更新されます。The label will update with the current status of the alert.

使用可能な関数の確認View the available functions

この接続には、次の関数が含まれています。This connection includes the following functions:

関数名Function Name 説明Description
GetAlertsGetAlerts Power BI サービスで設定したアラートを一覧表示しますList the alerts that you have set up in the Power BI service
CheckAlertStatusCheckAlertStatus 特定のアラートの状態を確認しますCheck the status of a particular alert

GetAlertsGetAlerts

Power BI サービスで設定したアラートを一覧表示します。List the alerts that you have set up in the Power BI service.

入力プロパティInput properties

なし。None.

出力プロパティOutput properties

プロパティ名Property Name データ型Data Type 必須Required 説明Description
value 配列array いいえNo Power BI サービスで設定したデータ アラートの配列。An array of the data alerts that you have set up in the Power BI service. 配列内の各要素は次のものを含みます。Each element in the array will include:
  • alertTitle: アラートのタイトルalertTitle: the title of the alert
  • alertId: アラートの IDalertId: the ID of the alert
  • groupId: アラートが作成されたグループの IDgroupId: the ID of the group that the alert was created in

CheckAlertStatusCheckAlertStatus

アラートの状態を確認します。Check the status of an alert.

注意

このエンドポイントへの要求は、あまり頻繁に呼び出されるとアラートごとに調整されます。Requests to this endpoint will be throttled on a per-alert basis if called too frequently.

入力プロパティInput properties

プロパティ名Property Name データ型Data Type 必須Required 説明Description
alertIdalertId 整数integer はいYes GetAlerts によって返される、アラートの IDThe ID of the alert, as returned by GetAlerts

出力プロパティOutput properties

プロパティ名Property Name データ型Data Type 必須Required 説明Description
tileValuetileValue number いいえNo アラートがトリガーされたときのタイルの値The value of the tile when the alert was triggered
tileUrltileUrl stringstring いいえNo アラートがあるタイルの URLURL for the tile that has the alert
alertTitlealertTitle stringstring いいえNo アラートの名前Name of the alert
isAlertTriggeredisAlertTriggered ブール値boolean いいえNo アラートが現在トリガーされているかどうかWhether the alert is currently triggered
alertThresholdalertThreshold number いいえNo アラームがトリガーされるしきい値The threshold at which the alarm is triggered

利用可能な接続をすべて表示する。See all the available connections.
アプリに接続を追加する方法を確認する。Learn how to add connections to your apps.