Digital Asset Cloud Service/Digital Asset Management 內送 Web 服務

Oracle Utilities Digital Asset Cloud Service 和 Oracle Utilities Digital Asset Management 包含內送 Web 服務 REST API,可用於客戶註冊和取消註冊、管理事件參與及其他處理。如需有關內送 Web 服務選項的一般資訊,請參考內送 Web 服務

請使用內送 Web 服務入口來檢視有關這些 Web 服務及其所支援作業的其他明細。

方案註冊

「方案註冊」(X1-ProgramEnrollment) 內送 Web 服務可用來從外部系統 (例如客戶資訊系統) 提交方案註冊與取消註冊要求。此 Web 服務包含下列作業:

  • 建立方案註冊 (enrollProgram):用來建立註冊要求以將客戶註冊到方案中

  • 建立方案取消註冊 (unenrollProgram):- 用來建立取消註冊要求以將客戶從方案取消註冊 (移除)

  • 取得方案註冊 (getProgramEnrollment):- 用來擷取註冊資訊

  • 取得方案取消註冊 (getProgramUnenrollment):- 用來擷取取消註冊資訊

如需有關用來將客戶註冊和取消註冊到方案中的處理詳細資訊,請參閱業務使用者指南中的關於註冊與取消註冊

方案事件

方案事件 (X1-ProgramEvent) 內送 Web 服務可用來從外部系統 (例如 Oracle Utilities Network Management System 之類的先進配電管理系統 (ADMS) 或監督控制與資料獲取 (SCADA) 系統) 建立方案事件並將其更新至 Oracle Utilities Digital Asset Cloud Service 與 Oracle Utilities Digital Asset Management。此 Web 服務包含下列作業:

  • 建立方案事件 (createProgramEvent):用來建立方案事件。方案事件會以「已排定」狀態開始 (以「待處理」狀態建立,但自動轉變為「已排定」)

  • 動作方案事件 (actionProgramEvent):用來將事件轉變為不同狀態,例如「進行中」、「完成」或「已取消」。

如需有關方案事件的詳細資訊,請參閱業務使用者指南中的關於方案事件

方案事件參與

方案事件參與 (X1-ProgramEventParticipation) 內送 Web 服務可用來將事件參與資料從外部系統 (例如 Oracle Utilities Network Management System 之類的先進配電管理系統 (ADMS) 或監督控制與資料獲取 (SCADA) 系統) 傳送至 Oracle Utilities Digital Asset Cloud Service 與 Oracle Utilities Digital Asset Management。此 Web 服務包含下列作業:

  • 預留裝置 (reserveDevice):用來透過在「事件參與」資料表中建立記錄,將裝置「預留」給即將進行的事件使用。此處理也可以建立事件 (如果該事件尚未存在的話)。

  • 事件後更新 (postEventOutcome):用來以事件的結果更新裝置事件參與記錄

如需有關事件參與的詳細資訊,請參閱業務使用者指南中的關於事件參與

方案適用性與資格問題

「方案適用性與資格問題」(X1-ProgramEligibilityAndQualification) 內送 Web 服務可用來擷取客戶的適用方案、註冊處理期間將向客戶詢問的每個方案問題,以及能夠符合方案資格的預期客戶答案。此 Web 服務包含下列作業:

  • 取得適用方案 (getEligiblePrograms):用來擷取客戶的適用方案

  • 取得資訊性問題 (getInformationalQuestions):用來擷取註冊處理中使用的方案資訊性問題,以及預期客戶答案。

  • 取得資格問題 (getQualifyingQuestions):用來擷取註冊處理中所使用的方案資格問題,以及能夠符合方案資格的預期客戶答案

如需有關方案資格與適用性的詳細資訊,請參閱業務使用者指南中的關於方案

可控裝置狀態

可控裝置狀態 (X1-ControllableDeviceStatus) 內送 Web 服務可用來從外部應用程式接收可控裝置的狀態。此 Web 服務包含下列作業:

  • 可控裝置狀態檢查後 (postControllableDeviceStatus):由外部應用程式用來傳送可控裝置的狀態

如需有關可控裝置的詳細資訊,請參閱業務使用者指南中的關於可控資產與裝置

目前方案註冊

「目前方案註冊」(X1-CurrentProgramEnrollment) 內送 Web 服務可用來擷取指定客戶的目前方案註冊。此 Web 服務包含下列作業:

  • 擷取方案註冊 (retrieveProgramEnrollment):用來擷取指定客戶的目前方案註冊

如需有關用來將客戶註冊和取消註冊到方案中的處理詳細資訊,請參閱業務使用者指南中的關於註冊與取消註冊

方案內容

「方案內容」(X1-ProgramContext) 內送 Web 服務可用來擷取包含名稱/值配對的客戶內容資訊,這有助於指出客戶可能註冊的各種方案。此 Web 服務包含下列作業:

  • 取得方案內容 (getProgramContexts):用來擷取客戶的方案內容

如需有關用來將客戶註冊和取消註冊到方案中的處理詳細資訊,請參閱業務使用者指南中的關於註冊與取消註冊

預約任務

「預約任務」(X1-AppointmentTasks) 內送 Web 服務可用來透過自助服務入口,要求並追蹤與客戶服務訂單現場活動相關的預約。此 Web 服務包含下列作業:

  • 登記預約 (bookAppointment):用來登記預約

  • 取消預約 (cancelAppointment):用來取消預約
  • 擷取待處理任務 (retrievePendingTasks):用來擷取待處理任務列表

  • 搜尋預約時段 (searchAppointmentSlots):用來搜尋可用預約時段
  • 搜尋任務 (searchForTasks):用來搜尋任務