Power BI

Power BI 是一套商務分析工具,可用來分析資料和分享深入解析。 透過每個裝置上的多種儀表板監視您的業務,並迅速獲得解答。 您可以在您的應用程式中,查看您在 Power BI 服務中設定的資料警示狀態。 有關 Power BI 資料警示的詳細資訊,請參閱文件頁面

本主題說明如何在應用程式中使用 Power BI 連線,並列出可用的函式。

開始使用的必要條件

在您的應用程式中使用 Power BI 連線

列出您在 Power BI 服務中設定的警示

  1. 在 [插入] 功能表上,選取 [資源庫],並新增任一文字資源庫
  2. 若要顯示目前使用者的警示,請將資源庫的 Items 屬性設為下列公式︰

    PowerBI.GetAlerts()

資源庫將更新警示的清單。 對於每個警示,您將收到警示名稱、警示的識別碼,以及設定警示時所在的群組工作區的識別碼。 您需要警示識別碼才能取得警示的進一步資訊。

檢視警示的狀態

若要檢視警示的狀態,請使用透過上述步驟取得的警示識別碼,來呼叫 CheckAlertStatus 函式。

能夠以常值字串 (例如「1234」) 或資源庫區段 (透過 GetAlerts() 呼叫 (例如 Gallery1.Selected.alertId) 填入) 參照的形式來傳遞警示識別碼

若要繼續,請新增標籤,然後將其 Text 屬性設定為下列其中一個公式︰

  • 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

標籤將更新警示的目前狀態。

檢視可用的函式

此連線包含下列函式︰

函式名稱 說明
GetAlerts 列出您在 Power BI 服務中設定的警示
CheckAlertStatus 檢查特定警示的狀態

GetAlerts

列出您在 Power BI 服務中設定的警示。

輸入屬性

無。

輸出屬性

屬性名稱 資料類型 必要 說明
陣列 您在 Power BI 服務中設定的資料警示陣列。 陣列中的每個項目將包括︰
  • alertTitle︰警示的標題
  • alertId︰警示的識別碼
  • groupId︰建立警示所在群組的識別碼

CheckAlertStatus

檢視警示的狀態。

注意︰若呼叫的次數太頻繁,此端點的要求將對各個警示進行節流。

輸入屬性

屬性名稱 資料類型 必要 說明
alertId 整數 GetAlerts 傳回的警示識別碼

輸出屬性

屬性名稱 資料類型 必要 說明
tileValue 數字 觸發警示時的圖格值
tileUrl 字串 有警示之圖格的 URL
alertTitle 字串 警示的名稱
isAlertTriggered 布林值 目前是否觸發警示
alertThreshold 數字 觸發警示的閾值

有用連結

查看所有可用連線
了解如何將連線新增到您的應用程式。