處理節省的 KWH 檔案
Oracle Utilities Analytics Insights 會傳送包含事件持續期間內每個客戶所達成之實際能源節約的「節省的 kWh」檔案,可用來決定財務結算資料。這些檔案是由每個參與的計量服務點的記錄 (以逗號分隔) 所組成,這些記錄會被傳送到 Oracle Cloud Object Storage。批次處理會匯入這些檔案,並建立擷取每個計量服務點之資料的業務標誌。本節描述 Oracle Utilities Digital Asset Cloud Service/Digital Asset Management 如何處理這些「節省的 kWh」檔案。
節省的 KWH 檔案格式
「節省的 kWh」檔案使用下列逗號值格式:
欄位 |
描述 |
範例 |
---|---|---|
EventId |
方案事件的 ID |
4011 |
EventType |
方案事件類型 |
Economic |
ProgramId |
事件的方案 ID |
1234512345 |
SPId |
計量服務點 ID |
1122334455 |
ActualStartTime |
事件的開始時間 |
2022-12-13T14:30:00-05:00 |
ActualEndTime |
事件的結束時間 |
2022-12-13T16:30:00-05:00 |
IntervalSize(Seconds) |
所包含之區間值的區間大小 (以秒表示)。 |
900 |
TotalkWh |
事件期間的 kWh 總計 |
75.00 |
TotalKwhSavedForPeriod |
事件期間內節省的 kWh 總計 |
33.00 |
KwhSaved<n> |
包含事件期間內所節省 kWh 總計的個別區間值。區間值數目是由事件持續期間除以區間大小所得出。 |
1: 5.00 2: 3.00 3: 2.00 4: 2.00 5: 3.00 6: 8.00 7: 6.00 8: 4.00 |
以下是一個根據上述範例資料的範例檔案:
EventId,EventType,ProgramId,SPId,ActualStartTime,ActualEndTime,IntervalSize(Seconds),TotalKwh,TotalKwhSavedForPeriod,KwhSaved1,KwhSaved2,KwhSaved3,KwhSaved4,..... 4011,Economic,1234512345,1122334455,2022-12-13T14:30:00-05:00,2022-12-13T16:30:00-05:00,900,75.00,33.00,5.00,3.00,2.00,2.00,3.00,8.00,6.00,4.00
批次處理
「節省的 kWh」檔案的處理會使用「節省的 kWh 業務標誌上傳」(X1-KWHAV) 批次處理來進行。請使用批次控制入口來檢視此批次處理所使用的參數。此處理應排定成定期執行。
此批次處理會使用「建立節省的 kWh 業務標誌」(X1-KWHAVDBUS) 演算法 (在批次控制入口的演算法頁籤上為「檔案上傳」系統事件定義的演算法)。此演算法會使用下列參數:
-
業務標誌標準名稱:用來識別批次處理所建立業務標誌之「業務標誌類型」的「標準名稱」(X1-KWHAVOIDED)。如需有關業務標誌標準名稱的詳細資訊,請參閱瞭解業務標誌和標準名稱。
-
區間資料條件值:從「用量交易服務數量區間條件」(D2-UTSQIntvlConditionLookup) 可延伸查尋擷取到之業務標誌中區間資料值的用量交易服務數量條件代碼
請注意,這些參數值無法變更。實作若想要針對這些參數使用替代值,就必須建立自己的這個演算法版本,並將客戶演算法新增至批次控制。
節省的 KWH 業務標誌
「節省的 kWh 業務標誌上傳」(X1-KWHAV) 批次處理會在從 Oracle Utilities Analytics Insights 傳送的「節省的 kWh」檔案中,為每個計量服務點建立業務標誌。建立這些業務標誌時,是使用「節省的 kWh 業務標誌」(X1-KWhAvdBusinessFlag) 業務物件來建立。
「節省的 kWh」業務標誌包含下列項目:
-
業務標誌類型:業務標誌所依據的業務標誌類型。業務標誌類型會指定特定類型之業務標誌的明細。
-
狀態:業務標誌的目前狀態
-
計量服務點 ID:與業務標誌相關的計量服務點
-
業務標誌日期/時間:建立業務標誌的日期與時間。請注意,這與記錄中所包含區間資料值的期間無關。
-
實際開始日期/時間:事件的開始日期與時間
-
實際結束日期/時間:事件的結束日期與時間
-
起始系統:建立業務標誌的系統。空白時,表示業務標誌是在內部建立的。
-
外部資訊:從起始業務標誌之系統收到的識別碼
-
事件外部識別碼:事件的外部 ID
-
方案外部 ID:方案的外部 ID
-
來源檔案 ID:用來將相同檔案中收到的業務標誌分組的 ID
-
外部參考系統:外部系統的替代參考。這是用來識別起始系統。
-
外部服務點 ID:起始系統中服務點的識別碼
-
-
明細:導致實際能源節約之方案事件的明細,包含:
- 已處理事件結算:指出是否已從此業務標誌建立事件結算交易的標誌。請注意,這只有在編輯業務標誌時才會顯示。
-
方案事件 ID:方案事件的 ID
-
方案事件類目:事件的類目
-
狀態:資料匯入狀態。可為下列內容:
-
成功:匯入包含「kWh 總計」值和所有區間值
-
部分:匯入包含「kWh 總計」值和部分區間值
-
失敗:匯入包含「kWh 總計」值,但沒有區間值
-
-
kWh 總計:服務點的事件能源總計 (單位為 kWh)。
-
節省的 kWh 總計:服務點的事件能源節約總計 (單位為 kWh)。如果「狀態」為「成功」,則此值應等於下方所列區間值的總計。
-
區間大小:所包含區間值的區間大小,以 hh:mm:ss (小時:分鐘:秒) 表示
-
區間資料:列出構成能源節約之個別區間值的資料表。每個區間值都由下列項目定義:
-
序號:區間值的序號。區間值數目應等於事件持續期間除以區間大小。例如,若事件持續時間為 2 小時且區間大小為 15 分鐘,則會有 8 個區間值。
-
日期/時間:區間值的日期與時間。請注意,第一個區間值的日期/時間應等於實際開始日期/時間。
-
數量:區間值 (單位為 kWh)。這些值的總計應等於上方的節省的 kWh 總計值。
-
區間條件值:指派給值的用量交易服務數量條件 (從「建立節省的 kWh 業務標誌」(X1-KWHAVDBUS) 演算法上的區間資料條件值參數)。
-
節省的 KWH 業務標誌處理
當「節省的 kWh」業務標誌進入「其他處理」狀態時,「事件結算建立」(X1-EVTSETCR) 演算法會根據業務標誌所包含的明細來建立「事件結算交易」。如果業務標誌上的「區間大小 (秒)」與業務標誌類型上定義的「區間大小」不同,系統就會將區間值轉換成符合業務標誌類型上定義的區間大小。
例如,業務標誌包含以下的 15 分鐘區間值 (區間大小為 900 秒):
日期/時間 |
值 |
---|---|
2022-12-13T14:00:00 |
5.00 |
2022-12-13T14:15:00 |
3.00 |
2022-12-13T14:30:00 |
2.00 |
2022-12-13T14:45:00 |
2.00 |
2022-12-13T15:00:00 |
3.00 |
2022-12-13T15:15:00 |
8.00 |
2022-12-13T15:30:00 |
6.00 |
2022-12-13T15:45:00 |
4.00 |
如果業務標誌類型上定義的「區間大小」為 1 小時區間 (區間大小為 01:00:00),便會加總 15 分鐘的區間值,以建立以下的 1 小時區間值。
日期/時間 |
值 |
---|---|
2022-12-13T14:00:00 |
12 (前 4 個 15 分鐘區間值的總和) |
2022-12-13T15:00:00 |
21 (後 4 個 15 分鐘區間值的總和) |
節省的 KWH 業務標誌類型
您必須建立一個業務標誌類型,此業務標誌類型參考建立業務標誌時要使用的業務標誌「標準名稱」與業務標誌業務物件,以及參考用來在從業務標誌建立之事件結算交易上定義區間用量值的計量單位、使用期間與服務數量識別碼組合。這應該使用「節省的 kWh 業務標誌類型」(X1-KWhAvdBusinessFlagType) 業務物件來建立,並應該包含下列項目:
-
業務標誌類型:業務標誌類型的代碼。
-
標準名稱:以此類型為基準之業務標誌的業務標誌標準名稱。這應該是「節省的 kWh」(X1-KWHAVOIDED)。
-
相關交易業務物件:用於以此類型為基準之業務標誌的業務物件。這會預設為「節省的 kWh 業務標誌」(X1-KWhAvdBusinessFlag),且除非您的實作已建立自己的「節省的 kWh」業務標誌業務物件,否則不應變更。
-
預設優先順序:指派給以此類型為基準之業務標誌的預設優先順序。這是用來設定以此類型為基準之業務標誌相對於其他業務標誌的處理優先順序。
-
狀態:業務標誌類型的狀態。業務標誌僅會從「現用」業務標誌類型建立。
-
描述:業務標誌類型的描述。這是用在業務標誌類型的資訊字串中。
-
計量單位/使用時間/服務數量 ID:定義在從此類型之業務標誌建立的事件結算交易上如何表示「節省的 kWh」區間值的參數
-
計量單位:用來定義如何在事件結算交易上表示「節省的 kWh」區間值的計量單位
-
使用時間:用來定義如何在事件結算交易上表示「節省的 kWh」區間值的使用期間
-
服務數量 ID:用來定義如何在事件結算交易上表示「節省的 kWh」區間值的服務數量識別碼
-
區間大小:在事件結算交易上建立的「節省的 kWh」區間值大小,以小時:分鐘:秒 (HH:MI:SS) 表示。這應該與用於區間價格集的區間大小相符。
-
如需有關業務標誌與業務標誌類型的詳細資訊,請參閱瞭解業務標誌。