Power BI は、データを分析して分析情報を共有するための一連のビジネス分析ツールです。 すべてのデバイスで利用できる豊富なダッシュボードを使用して、ビジネスを監視し、迅速に回答を得ることができます。 アプリでは、Power BI サービスで設定したデータ アラートの状態を確認できます。 Power BI のデータ アラートの詳細については、 ドキュメント ページを参照してください。
このトピックでは、アプリで Power BI 接続を使用する方法と、使用可能な関数の一覧を示します。
注
Power BI 接続は 委任できません。
[前提条件]
アプリで Power BI 接続を使用する
Power BI サービスで設定したアラートを一覧表示する
[ 挿入 ] メニューの [ ギャラリー] を選択し、 任意のテキスト ギャラリーを追加します。
現在のユーザーのアラートを表示するには、ギャラリーの Items プロパティを次の式に設定します。
PowerBI.GetAlerts()
ギャラリーはアラートの一覧で更新されます。 アラートごとに、アラート名、アラートの ID 番号、およびアラートが構成されたグループ ワークスペースの ID が表示されます。 アラートに関する詳細情報を取得するには、アラート ID が必要です。
アラートの状態を表示する
アラートの状態を表示するには、上記の手順で取得したアラート ID を使用して CheckAlertStatus 関数を呼び出します。
アラート ID は、リテラル文字列 (例: "1234") として渡すか、GetAlerts() 呼び出し (Gallery1.Selected.alertId など) を使用して設定されたギャラリー セクションへの参照として渡すことができます。
続行するには、ラベルを追加し、 Text プロパティを次のいずれかの数式に設定します。
PowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertTitlePowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).currentTileValuePowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).alertThresholdPowerBI.CheckAlertStatus( /* alert ID that you received from GetAlert */ ).isAlertTriggered
ラベルは、アラートの現在の状態で更新されます。
使用可能な関数を表示する
この接続には、次の関数が含まれます。
| 関数名 | Description |
|---|---|
| GetAlerts | Power BI サービスで設定したアラートを一覧表示する |
| CheckAlertStatus | 特定のアラートの状態を確認する |
GetAlerts
Power BI サービスで設定したアラートを一覧表示します。
入力プロパティ
なし。
出力プロパティ
| プロパティ名 | データ型 | 必須 | Description |
|---|---|---|---|
| value | アレイ | いいえ | Power BI サービスで設定したデータ アラートの配列。 配列内の各要素には次のものが含まれます。
|
CheckAlertStatus
アラートの状態を確認します。
注
このエンドポイントへの要求は、呼び出される頻度が高すぎるとアラートごとに調整されます。
入力プロパティ
| プロパティ名 | データ型 | 必須 | Description |
|---|---|---|---|
| alertId | 整数 | イエス | GetAlerts によって返されるアラートの ID |
出力プロパティ
| プロパティ名 | データ型 | 必須 | Description |
|---|---|---|---|
| tileValue | 数値 | いいえ | アラートがトリガーされたときのタイルの値 |
| tileUrl | 文字列 | いいえ | アラートを含むタイルの URL |
| alertTitle | 文字列 | いいえ | アラートの名前 |
| isAlertTriggered | ブーリアン | いいえ | アラートが現在トリガーされているかどうか |
| alertThreshold | 数値 | いいえ | アラームがトリガーされるしきい値 |
便利なリンク
使用可能なすべての接続を表示します。
アプリに 接続を追加 する方法について説明します。