擷取服務協議
本主題提供從 Oracle Utilities Customer Cloud Service 擷取服務協議以匯入至 Oracle Utilities Digital Asset Cloud Service 的其他相關明細。
初始擷取批次處理
使用「將服務協議移轉至 DACS 計量服務」(C1-DMSIL) 批次處理來建立之服務協議的初始擷取檔案。請使用批次控制入口來檢視此批次處理所使用的參數。此處理應只針對初始擷取執行。
維護物件稽核演算法
「將服務協議同步為 DACS 計量服務」(C1_DASASYNC) 稽核演算法會追蹤新服務協議資料與現有服務協議資料的變更,並建立用來建立增量擷取檔案的資料同步要求。
同步要求業務物件
服務協議同步要求是以「將 CCB 服務協議同步至 DACS 計量服務」(C1-DACSMSSyncRequest) 業務物件為基礎。
增量擷取批次處理
使用「計量服務遞增同步批次控制」(C1-DMSEX) 批次處理,從同步要求與「一般處理」記錄建立增量服務協議擷取檔案。請使用批次控制入口來檢視此批次處理所使用的參數。此處理應該根據增量更新的需要來執行。
服務協議擷取檔案格式
服務協議擷取檔案使用下列以 Tab 字元分隔值的格式:
欄位名稱 |
選擇性/必要 |
備註 |
---|---|---|
外部參考 ID | 選擇性 | 客戶資訊系統應用程式中的計量服務參考 ID。 |
變更日期/時間 | 選擇性 |
變更計量服務的日期與時間。 僅適用於「增量上傳」 如果同一計量服務點有多項變更,將會用來排列處理順序。 |
初始載入同步標誌 | 必要 |
指出上傳類型的值。有效值為:
|
外部 ID | 必要 |
客戶資訊系統應用程式中的計量服務 ID。 從 Customer to Meter 或 Customer Cloud Service 匯入資料時,這是「服務協議外部 ID」。 |
計量服務類型 | 必要 |
計量服務的類型。從 Customer to Meter 或 Customer Cloud Service 匯入資料時,這會來自「服務協議類型」。 如果提供的計量服務點類型尚未在 Digital Asset Management/Digital Asset Cloud Service 中定義為「計量服務類型」,則會使用可延伸查尋將此值對應至 Digital Asset Management/Digital Asset Cloud Service 中使用的「計量服務類型」。 |
外部聯絡人 ID | 選擇性 |
與客戶資訊系統應用程式中計量服務相關之聯絡人的 ID。 從 Customer to Meter 或 Customer Cloud Service 匯入資料時,這是「聯絡人外部 ID」。 |
外部帳戶 ID | 選擇性 | 用來識別與客戶資訊服務應用程式中計量服務記錄相關之帳戶的 ID。 |
開始日期時間 | 必要 | 計量服務記錄開始的日期與時間。 |
結束日期時間 | 選擇性 | 計量服務記錄結束或將結束的日期與時間 (如果適用)。 |
分部 | 選擇性 |
計量服務的部門。 如果提供的部門尚未在 Digital Asset Management/Digital Asset Cloud Service 中定義為「部門」,則會使用可延伸查尋將此值對應至 Digital Asset Management/Digital Asset Cloud Service 中使用的「部門」。 |
服務協議狀態 | 選擇性 |
計量服務的狀態。 如果提供的狀態尚未在 Digital Asset Management/Digital Asset Cloud Service 中定義為「狀態」,則會使用可延伸查尋將此值對應至 Digital Asset Management/Digital Asset Cloud Service 中定義的「狀態」。 |
費率表列表 | 選擇性 |
與計量服務相關之費率表與生效日期的串連列表。 此列表中的每個資料列都是由下列項目組成:
資料列中的每個元素都會以逗號 ( , ) 分隔。 列表中的每個資料列都會以分號 ( ; ) 分隔。 例如: ERES-1,2022-01-01ERES-2,2021-01-01 |
計量服務點列表 | 選擇性 |
與計量服務相關之計量服務點的串連列表。 此列表中的每個資料列都是由下列項目組成:
資料列中的每個元素都會以逗號 ( , ) 分隔。 列表中的每個資料列都會以分號 ( ; ) 分隔。 範例: 6800401571,2022-12-13T14:30:00-05:00,1703304223,2022-12-13T14:30:00-05:00, |
已清除 | 選擇性 |
指出是否已在客戶資訊系統應用程式中將客戶混淆處理 (如果支援) 的標誌。有效值為 Y/N (預設值) 僅適用於「增量上傳」 如果客戶資訊系統應用程式中不支援「物件清除」,則應將此設為 "N"。 |
範例記錄
以下是一個範例檔案:
EXTREFMS11 2023-06-15T13:02:00-08:00 F1IC EXTMS1 CA!ZZMTRDST EXTCONTACT1 EXTACCT1 2022-10-15T09:23:00-08:00 2023-06-14T13:45:00-08:00 ZZEDV 20 ERESRBOH,2022-11-09; EXTMSP1,2022-11-09T13:14:55-08:00,2023-04-14T08:25:44-08:00; Y