擷取服務協議

本主題提供從 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。
變更日期/時間 選擇性

變更計量服務的日期與時間。

僅適用於「增量上傳」

如果同一計量服務點有多項變更,將會用來排列處理順序。

初始載入同步標誌 必要

指出上傳類型的值。有效值為:

  • F1IL - 初始載入

  • F1IC - 增量

外部 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

計量服務點列表 選擇性

與計量服務相關之計量服務點的串連列表。

此列表中的每個資料列都是由下列項目組成:

  • 外部計量服務點 ID (必要)

  • 開始日期時間 (必要)

  • 結束日期時間 (選擇性)

資料列中的每個元素都會以逗號 ( , ) 分隔。

列表中的每個資料列都會以分號 ( ; ) 分隔。

範例:

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