BPEL 處理及 Web 服務

所有 Web 服務都會收到傳入服務的 XML，然後將呼叫轉換成 NES 系統可辨識的格式。

CreateMeter ：接收來自訊息寄送方服務的傳入 XML，並將該 XML 轉換成 NES API 參數節點，再傳遞至 DeviceManager.Create NES API Web 服務方法，然後從 CreateMeter 收集 XML，以便將該 XML 傳回 Oracle Utilities Smart Grid Gateway。

訊息

CreateMeter RequestMessage：包含從 Oracle Utilities Smart Grid Gateway 格式化而成的參數，以符合要供 NES API DeviceManager.Create 方法使用的傳入 XML。

CreateMeter ResponseMessage：包含當 DeviceManager.Create 方法成功地驗證安全性金鑰及 XML 參數時，所使用的「裝置 ID」。

相關處理

計量表開始通訊

接收來自 Oracle Utilities Smart Grid Gateway 中之 D4-CONLOAD (連接負載) 訊息寄送方的傳入 XML，並將該 XML 轉換成 NES 格式。

從事件儲存庫擷取未處理的事件；轉換每個批次以便將 GUID 識別碼取代為可讀取的形式，最後準備 OSB 的新檔案，再刪除事件批次。此服務的排定呼叫可包含偏好的查詢日期，或是可接受預設值 (前一日的用量)。

訊息

GrabBatchEventsSoapIn

GrabBatchEventsSoapOut

從用量儲存庫擷取未處理的用量；轉換每個批次以便將 GUID 識別碼取代為可讀取的形式，最後準備 OSB 的新檔案，再刪除用量批次。此服務的排定呼叫可包含偏好的查詢日期，或是可接受預設值 (前一日的用量)。

訊息

GrabBatchUsageSoapIn

GrabBatchUsageSoapOut

相關處理

連接

事件管理

用量處理

接收來自訊息 senderOutbound 服務的傳入 XML，並轉換成 NES API 參數節點，以便傳遞至 DeviceManager.Move NES API Web 服務方法。然後，該處理會收集要傳回至 Oracle Utilities Smart Grid Gateway 的傳回 XML。

訊息

MeterDecommissioningRequestMessage：此訊息是 Move 方法的輸入。此方法包含易於從 Oracle Utilities Smart Grid Gateway 格式化的參數，以符合 NES API DeviceManager.Move 方法的傳入 XML。

MeterDecommissioningResponseMessage ：此訊息包含狀態，指出 DeviceManager.Create 方法已成功地驗證安全性金鑰，且 XML 參數已被接受。如果狀態為 SUCCEEDED，此訊息也會包含呼叫的「追蹤 ID」、「裝置 ID」及 StatusType ID。

相關處理

計量表停止通訊

此 Web 服務可協助處理 Oracle Utilities Smart Grid Gateway 與 NES 系統之間大部分的通訊。如果您的實作需要基準套件沒有提供的功能，此 Web 服務將在管理這些自訂項目方面扮演不可或缺的角色。

PerformCommand 所執行的指令，會產生事件來讓 Oracle Utilities Smart Grid Gateway 生命週期向前推進，然後將輸出字串傳回給呼叫程式。輸出可能會是追蹤 ID 或是裝置的相關資訊。

訊息

PerformCommandSoapIn：會在 Oracle Utilities Smart Grid Gateway 內準備 sXmlParameters 輸入，以便執行主要是由 5 個指令組成的群組，這些指令包括「抄表負載狀態」、「按需抄表」、「連接負載」、「斷接負載」，以及「設定自動拓樸管理組態」。

PerformCommandSoapOut:

PerformCommand 所傳回的項目，是來自 DeviceManager.PerformCommand 之「抄表負載狀態」、「按需抄表」、「連接負載」、「斷接負載」及「設定自動拓樸管理組態」 的 XML。

實際上實作並不會呼叫此 Web 服務，而是 NES 會呼叫此服務，且在設定 NES 伺服器時是必要的。

ReceivePanoramixEvents 會從 NES 認證服務取得 APIKey，然後利用此服務之參數列表中的事件定義 ID，切換至該事件定義的分支，以便開始任何特定的處理。例如，按需抄表完成事件代表 BPEL PM 處理需要利用在該事件 xml 中找到的 RESULTID 來擷取用量。所有要傳送至 Oracle Utilities Smart Grid Gateway 的事件及用量都必須經過轉換，將 GUID 替換成可讀取的表單項目。這牽涉到使用 BPEL PM DVM 查尋功能。

訊息

ReceivePanoramixEventsSoapIn

ReceivePanoramixEventsSoapOut

相關處理

事件管理

這些 Web 服務是可讓您在將訊息傳送至 NES 伺服器的前一刻及後一刻自訂訊息的勾點。您的實作可能會因特殊目的而想要修改資料。這是僅有的幾個允許修改 BPEL PM 代碼的地方之一。

這個 Web 服務是可讓您在將訊息傳送至 NES 伺服器的前一刻及後一刻自訂訊息的勾點。您的實作可能會因特殊目的而想要修改資料。這是其中一個唯一可讓您修改 BPEL PM 代碼的地方。

此 Web 服務方法會利用格式化的內送 xml 參數，起始對 NES 系統的呼叫。首先，它會將接收自呼叫系統的「參數」轉換成 NES 系統可辨識的格式。然後，它會叫用對 NES 系統之「裝置管理程式服務」的呼叫。當系統叫用該呼叫時，會收到來自 DeviceManager 的傳回 XML，其中指出指令的執行狀態；如果執行成功，也會有此呼叫的追蹤 ID。

訊息

ReadBillingDataOnDemandRequestMessage：包含可供「DeviceManager 執行指令」用來讀取按需計費資料的輸入參數。它會將來自呼叫系統的參數格式化，以符合要供 NES DeviceManager.PerfomCommand 方法使用的傳入 XML。

ReadBillingDataOnDemandResponseMessage：將回應 xml 從 NES 系統格式轉換為 Oracle Utilities Smart Grid Gateway 格式。

相關處理

按需抄表

此 Web 服務方法會利用格式化的內送 xml 參數，起始對 NES 系統之「裝置管理員服務」的呼叫。首先，它會將接收自呼叫系統的「參數」轉換成 NES 系統可辨識的格式。然後，它會透過「裝置管理程式服務」叫用對 NES 系統的呼叫。系統開始該呼叫之後，會收到來自 DeviceManager 的回應訊息，其中指出指令的執行狀態；如果執行成功，也會有此呼叫的追蹤 ID。

訊息

ReadLoadProfileOnDemandRequestMessage：此訊息可用於對 NES 系統的區間按需抄表要求。將來自 Oracle Utilities Smart Grid Gateway 的傳入 XML 轉換成 NES 可辨識的格式。

ReadLoadProfileOnDemandResponseMessage：將 ReadLoadProfileOnDemandRequest 的回應 xml 從 NES 系統格式轉換為 Oracle Utilities Smart Grid Gateway 格式。

相關處理

按需抄表

接收來自 Oracle Utilities Smart Grid Gateway 中之 D4-RDLOADST (抄表負載狀態) 訊息寄送方的傳入 XML，並將該 XML 轉換成 NES 格式。

接收來自 Oracle Utilities Smart Grid Gateway 中之 D4-DISCONLD (斷接負載) 訊息寄送方的傳入 XML，並將該 XML 轉換成 NES 格式。

利用格式化的內送 xml 參數，起始對「要求管理服務」的呼叫。首先，它會將接收自呼叫系統的「參數」轉換成 NES 系統可辨識的格式。然後，它會透過「要求管理服務」叫用對 NES 系統的呼叫，並擷取其中包含「計量表資訊」的回應。

訊息

RetrieveMeterInformationRequestMessage：包含可供「DeviceManager 執行指令」用來擷取計量表資訊的輸入參數。它也會將來自呼叫系統的參數格式化，以符合要供 NES DeviceManager.PerfomCommand 方法使用的傳入 XML。

RetrieveMeterInformationResponseMessage：將回應 xml 從 NES 系統格式轉換為 Oracle Utilities Smart Grid Gateway 格式。

相關處理

遠端斷接

遠端連接

接收來自 Oracle Utilities Smart Grid Gateway 以執行 RetrieveMeterIdentifier 處理的呼叫，並叫用 NES 系統之 DeviceManager 服務中的 RetrieveByParameter 方法。

將傳入的 Oracle Utilities Smart Grid Gateway 格式化輸入轉換成採用 NES 格式的 sXmlParameters，然後叫用 RetrieveMeterIdentifier。

訊息

RetrieveMeterIdentifierRequestMessage：轉換接收自呼叫系統的 xml，以符合要供 NES API DeviceManager.RetrieveByParameter 方法使用的傳入 XML。此方法需要的輸入值為「ID 類型」及相關聯的 ID。

RetrieveMeterIdentifierResponseMessage：當前端系統同步傳回 RetrieveByParameter 呼叫的 XML 時，只有在呼叫狀態為「成功」的時候，才會將 DEVICEID 節點包含在 APIPAYLOAD 中。

相關處理

計量表開始通訊

此 Web 服務方法是專門用來設定「自動拓樸管理」 (ATM) 組態指令，該指令會將「計量表」指派給「資料集中器」。

將傳入的 Oracle Utilities Smart Grid Gateway 格式化輸入轉換成採用 NES 格式的 sXmlParameters，然後叫用 DeviceManager PerformCommand。您必須建立連線，以便開始 NES 指令處理。

訊息

SetATMConfigurationRequestMessage：此訊息是 SetATMConfiguration 方法的輸入。此方法包含易於從 Oracle Utilities Smart Grid Gateway 格式化的參數，以符合 NES API DeviceManager.PerformCommand 方法的傳入 XML，其中 COMMANID 為 Constants.DeviceCommands.SET_​ATM_​CONFIGURATION

SetATMConfigurationResponseMessage：當前端系統同步傳回 PerformCommand 呼叫的 XML 時，只有在呼叫狀態為「成功」的時候，才會將 COMMAND 節點包含在 APIPAYLOAD 中。

相關處理

計量表開始通訊

NES Web 服務

下表說明用於 Oracle Utilities Smart Grid Gateway 指令訊息傳遞的 NES Web 服務及作業：