標籤歷史
功能說明
標籤歷史小工具用於顯示從 Weincloud 伺服器取得的標籤歷史資料。此小工具支援單一標籤或多標籤模式,並提供多種資料合計功能,讓使用者能夠以表格形式檢視標籤的歷史數值變化。
- 單一標籤模式:顯示單一標籤的歷史資料
- 多標籤模式:最多支援 30 個標籤來源,啟用合計功能後可同時檢視多個標籤的歷史數據
- 資料合計:支援平均值、總和、最大值、最小值、中位數、百分位數及計數等合計模式
- 時間格式自訂:提供多種日期時間格式選項
- 資料下載:可將歷史資料匯出下載
樣式設定
資料來源
點擊「選擇標籤」按鈕來設定要顯示的標籤資料來源。
多標籤 (啟用合計功能)
勾選此選項後,可以選擇多個標籤作為資料來源(最多 30 個),並啟用合計功能對多個標籤的歷史資料進行統計分析。
支援的資料類型:
- 單一標籤模式:Boolean、Int、Float、String
- 多標籤模式(啟用合計功能):Boolean、Int、Float
標籤篩選
啟用
開啟此功能後,允許儀表板檢視者互動式地選擇要顯示的標籤數據。使用切換開關來啟用或停用此功能。
樣式
點擊「選擇風格」按鈕開啟風格選擇器對話框,可以為標籤歷史小工具選擇預設的視覺風格樣式。
基礎
背景顏色
設定小工具的背景顏色。點擊顏色選擇器可開啟色彩面板,提供:
- 預設色彩選項
- 自訂色彩
- 透明度調整
標題
- 啟用:勾選核取方塊以顯示標題
- 標題文字:輸入標題內容(最多 100 字元)
- 未啟用標題時,相關設定會呈現停用狀態
字型
從下拉選單選擇標題文字的字型,提供多種字型選項包括:
- 預設
- 系統字型(Arial, Calibri, Helvetica, Times New Roman 等)
- 中文字型(Microsoft JhengHei, Microsoft YaHei, SimSun 等)
注意:此選項僅在啟用標題時可用。
大小寫&尺寸
- 大小寫:選擇標題文字的大小寫樣式
- 預設
- 大寫
- 小寫
- 字首大寫
- 尺寸:調整標題字型大小(範圍:10-128)
注意:此選項僅在啟用標題時可用。
字型顏色
設定標題文字的顏色。點擊顏色選擇器可開啟色彩面板選擇顏色。預設為 #333333。
右側提供文字對齊選項:
- 靠左對齊
- 置中對齊
- 靠右對齊
注意:此選項僅在啟用標題時可用。
分隔線
- 啟用:勾選核取方塊以顯示標題與內容之間的分隔線(預設已啟用)
- 顏色:設定分隔線的顏色(預設為半透明灰色 rgba(171, 171, 171, 0.36))
- 粗細:調整分隔線粗細(範圍:1-10)
注意:此選項僅在啟用標題時可用。
一般設定
時間格式
從下拉選單選擇歷史資料的時間顯示格式,提供多種格式選項:
僅日期格式:
- YYYY/MM/DD
- YYYY-MM-DD
- MM/DD/YYYY
- DD.MM.YYYY
- DD/MM/YYYY
- DD-MM-YY
- DD/MM/YY
- MM-DD-YY
日期時間格式(12小時制):
- YYYY/MM/DD hh:mm:ss a
- YYYY-MM-DD hh:mm:ss a
- MM/DD/YYYY hh:mm:ss a
- DD.MM.YYYY hh:mm:ss a
- DD/MM/YYYY hh:mm:ss a
- DD-MM-YY hh:mm:ss a
- DD/MM/YY hh:mm:ss a
- MM-DD-YY hh:mm:ss a
日期時間格式(24小時制):
- YYYY/MM/DD HH:mm:ss
- YYYY-MM-DD HH:mm:ss
- MM/DD/YYYY HH:mm:ss
- DD.MM.YYYY HH:mm:ss
- DD/MM/YYYY HH:mm:ss
- DD-MM-YY HH:mm:ss
- DD/MM/YY HH:mm:ss
- MM-DD-YY HH:mm:ss
僅時間格式:
- hh:mm:ss a (12小時制)
- hh:mm:ss (24小時制,預設值)
預設區間
設定小工具初始載入時顯示的時間範圍:
可用選項:
- 1 分鐘
- 3 分鐘
- 5 分鐘
- 10 分鐘
- 15 分鐘
- 30 分鐘
- 1 小時
- 6 小時
- 12 小時
- 1 天
- 3 天
- 7 天
- 30 天
- 3 個月
- 6 個月
- 1 年
重要提示:
- 未啟用合計功能時，最大時間範圍為 6 小時(21600 秒)，詳細限制可參考資料限制章節
下載
啟用
使用切換開關啟用或停用歷史資料的下載功能。啟用後,使用者可以將表格中的歷史資料匯出為檔案。
合計
合計模式下可以使不同資料來源的數值在同一個時間點下顯示,但會與實際的數值有誤差。
注意:
- 切換為「原始的」模式時,如果時間範圍超過 6 小時(21600 秒),系統會自動調整為 6 小時，詳細限制可參考資料限制章節
集合大小
設定資料間隔多少時間要合併在一起:
- 10 秒
- 30 秒
- 1 分鐘
- 5 分鐘
- 10 分鐘
- 30 分鐘
- 1 小時
- 3 小時
- 6 小時
- 12 小時
- 1 天
重要提示:
- 可選擇的集合大小會根據時間範圍自動調整
- 系統會標示不適用的選項並顯示警告圖示
- 不適用的選項會以灰色顯示並附帶警告提示
模式
合併資料的方式:
- 平均:計算區間內的平均值
- 總和:計算區間內的總和
- 最大:取區間內的最大值
- 最小:取區間內的最小值
- 中位數:取區間內的中位數
- 百分位數:取指定百分位數的值
- 計數:計算區間內的資料筆數
- 眾數:取區間內出現最多次的值
填充
如果合併區間的資料為空,是否填值:
- 無:不填充
- 線性:根據線性回歸推導出的值
- 注意:眾數模式下此選項不可用
- 空值:填入 null
- 前一個:以前一個區間值當參考
動態選項說明:
- 當模式選擇「眾數」時,填充選項會自動調整,移除「線性」選項
導數
計算變化率
- 勾選後會計算資料的變化率
- 注意:「眾數」模式下此選項會被停用
百分位數
決定要取百分位多少的數值 0-100,支援小數點後兩位
- 注意:僅在模式選擇「百分位數」時可編輯
- 其他模式下此選項會被停用
更新頻率
設定小工具自動更新資料的頻率:
- 30 秒
- 1 分鐘
- 5 分鐘
- 10 分鐘
- 30 分鐘
- 1 小時
- 3 小時
- 6 小時
外觀
緊湊模式
勾選後啟用緊湊顯示模式,以更緊密的排版顯示歷史資料表格(預設已啟用)。
X
設定小工具在儀表板上的水平位置(X 座標)。
- 最小值:由系統定義
- 最大值:根據工作區大小和小工具寬度動態計算
Y
設定小工具在儀表板上的垂直位置(Y 座標)。
- 最小值:由系統定義
- 最大值:根據工作區大小和小工具高度動態計算
寬度
設定小工具的寬度。
- 最小值:由小工具定義的最小像素寬度
- 最大值:由系統定義
- 預設值:150
高度
設定小工具的高度。
- 最小值:由小工具定義的最小像素高度
- 最大值:由系統定義
- 預設值:125
使用者限制
物件類別
設定此小工具的安全存取類別。只有具備相應權限的使用者才能檢視或操作此小工具。
可用選項:
- 無(預設,無限制)
- 類別:A
- 類別:B
- 類別:C
- 類別:D
- 類別:E
- 類別:F
- 類別:G
- 類別:H
- 類別:I
- 類別:J
- 類別:K
- 類別:L
受保護時隱藏
勾選後,當使用者無存取權限時,將完全隱藏此小工具而非僅停用。
注意:此選項僅在設定物件類別後可用。
受保護時隱藏下載
勾選後,當使用者無存取權限時,將隱藏下載功能。
注意:此選項僅在啟用下載功能且設定物件類別後可用。
Disabled
勾選後,停用此小工具的所有互動功能。
注意:此選項僅在設定物件類別後可用。
自動更新
歷史圖在觀看模式，預設狀況下會自動更新資料
- 時間範圍選擇最近6小時內，且沒有開啟合計模式，則會適用即時模式來獲取資料，更新頻率會根據標籤的間隔設定來決定
- 其他情況則會以歷史模式來獲取資料，更新頻率為集合大小的設定，例如集合大小是1分鐘，則每分鐘更新一次
資料限制
為了確保系統穩定性，目前針對部分使用有做限制獲取，限制條件如下
單次獲取最多只能獲取4320筆數據
- 在歷史圖中的即時模式下，我們會以
5秒當作單位來獲取數據，這樣最多只能獲取到6小時內的數據
60(秒)*60(分鐘)*6(小時)/5(秒) = 4320
- 如果有開啟合計模式，我們會以
集合大小當作單位來獲取資料 如果集合大小是1分鐘，那麼最多只能獲取到3天內的數據
60(秒)*60(分鐘)*24(小時)*3(天)/60(秒) = 4320
單次下載最多只能獲取535680筆數據
- 在歷史圖中的即時模式下，我們會以
5秒當作單位來下載數據，這樣最多只能下載到31天內的數據
60(秒)*60(分鐘)*24(小時)*31(天)/5(秒) = 535680
- 如果有開啟合計模式，我們會以
集合大小當作單位來下載資料 如果集合大小是30秒，那麼最多只能下載到186天內的數據
60(秒)*60(分鐘)*24(小時)*186(天)/30(秒) = 535680
- 但不超過
1年的數據
遇到單次獲取或下載遇到限制時可以採取的手段
- 調整時間範圍到限制內
- 開啟
合計模式，並調整集合大小到更大的值，這樣每次獲取的數據量就會減少 - 分段獲取數據，將時間範圍分成多個段落，每次獲取一個段落的數據，最後將這些數據合併起來
流量限制
目前單一HMI最多只允許15分鐘內可以獲取及下載100MBytes左右的資料，超過這個限制會導致獲取或下載失敗
已發佈的儀表板限制
- 每個發布的儀表板，每1分鐘只能請求1次下載資料請求