初始測量

以 NES 格式的檔案從前端系統匯出的用量資料會作為初始測量資料載入 Oracle Utilities 中。基準產品提供的下列 OSB 專案可協助管理用量處理：

  1. SGG-D3-USAGE-BASE 包含會負責實際處理傳入資料的元件。組態期間不應修改此專案。

  2. SGG-D4-USAGE-CM 允許您區隔自訂項目，讓未來在 SGG-D4-USAGE-BASE 中實作的基準功能升級不會影響到該自訂項目及環境設定。

SGG-D4-USAGE-CM 專案的執行時間組態設定會儲存在 EnvironmentSettings.xq XQuery 檔案中。您可以利用此檔案，來調整初始測量資料處理。例如，假設您要載入原始資料，請將 populateRawIMD 元素的內容指定為 “true”。

下表說明包含在 EnvironmentSettings.xq 檔案中的元素：

元素

描述

有效值

populateRaw

決定是否要以原始資料的形式來植入初始測量資料。

true

false

callPreProcessing

決定是否要呼叫前處理的 Proxy 服務。

true

false

callPostProcessing

決定是否要呼叫後處理的 Proxy 服務。

true

false

destinationRootElementInterval

保留區間初始測量資料匯集器之內送 Web 服務的名稱。

destinationRootElementScalar

保留定量初始測量資料匯集器之內送 Web 服務的名稱。在大多數的情況下，其值與 destinationRootElementInterval 的值相同。

publishServices/service

指定在 OSB 專案中，用來發布外部系統 (例如 Oracle DataRaker) 資料之業務服務的名稱。

filterUsage

決定是否要篩選用量。

true

false

發布初始測量資料

您可以設定 SGG 轉接器來發布初始測量資料，以便用於 Oracle DataRaker 或其他外部系統。我們透過 OSB 元件與 BPEL 複合的組合來支援此功能。

啟用初始測量資料發布功能

若要啟用發布資料的功能，請在 EnvironmentSettings.xq 檔案的 publishServices/service 元素中，參考發布者業務服務，如下所示：
<publishServices>
  <service>[publisherBusinessService]</service>
</publishServices>

SGG-D4-USAGE-CM OSB 專案隨附的下列元件，可用來將測量資料發布至 Oracle DataRaker：

  • DataRakerBusinessService 業務服務用來將資料傳送至預先設定的 JMS 佇列 (定義為端點 URI)，資料將從該佇列發布。這是您必須要在 EnvironmentSettings.xq 檔案中指定的業務服務。

  • DataRakerServiceAccount 服務帳戶用來定義和維護存取 DataRakerBusinessService 業務服務中定義之 JMS 佇列所需的使用者名稱和密碼。

設定初始測量發布輸出

SGGDRIntegration BPEL 複合會處理將資料發布至 Oracle DataRaker 或其他系統的作業。初始測量資料是以「原生」初始測量資料格式 (初始測量匯集器業務物件的格式) 發布。此格式包含正規化的計量單位及條件代碼。如需深入瞭解此格式，請參閱 Oracle Utilities Smart Grid Gateway Adapter Development Kit 管理使用者指南。

備註：
透過此功能所發布的初始測量資料，會在執行「驗證、編輯和估算」處理之前發布。此外，您無法將篩選條件套用至藉由此功能所發布的資料。

下列參數可用來詳細設定如何將資料提供給 Oracle DataRaker，包括用來記入檔案以供 Oracle DataRaker 使用的目錄、每個檔案的記錄數目、輪詢頻率等等。這些參數都是在安裝期間定義的。如需深入瞭解如何定義這些參數的值，請參閱 Oracle Utilities Smart Grid Gateway 安裝指南。

參數

描述

預設值

SGG_​DR_​INT_​QUEUE

發布 SGG 承載之佇列的 JNDI 名稱。

這是 DataRakerBusinessService 業務服務中定義的 JMS 佇列。這不應變更。

DataRakerQueue

SOA_​DR_​PUBLISH_​SIZE

在已發布檔案中累積的記錄數 (SGG 承載)。

100

SOA_​DR_​FILE_​SIZE

累積 (SGG 承載) 檔案的最大檔案大小 (KB)。

524288

SOA_​DR_​ELAPSED_​TIME

超過此期間 (秒數) 將建立新的傳出檔案。

600

SOA_​DR_​POLLING_​FREQ

新檔案的暫存目錄輪詢頻率 (秒數)。

60

SOA_​DR_​STAGING_​DIR

累積 SGG 承載檔案之暫存目錄的掛載點/目錄。

這是內部使用的，不應變更。

/spl/sploutput/staging

SOA_​DR_​INTEGRATION_​DIR

Oracle DataRaker 將從中使用已轉換之 XML 檔案的掛載點/目錄。

/spl/sploutput/int

篩選初始測量資料

您可以設定 SGG 轉接器，來篩選傳送到 SGG 和 Oracle Utilities Meter Data Management 應用程式的初始測量資料。若要啟用篩選資料的功能，請將 EnvironmentSettings.xq 檔案中的 <filterUsage> 元素設定為 “true”，如下所示：
<filterUsage>true</filterUsage>

當您啟用篩選功能時，只有其 <externalUOM> 與您在 NES 計量單位代碼對應可延伸查尋可延伸查尋 (D4-HeadendUOMLookup) 中定義的其中一個值相符之測量，才會被傳送至系統以供處理。

處理大型輸入檔案

在某些環境中，OSB 專案可能會在大型檔案還沒被完全複製到輸入目錄中時，就開始處理該大型檔案。若要避免發生這種情況，請在專案的 “InboundProxyService” Proxy 服務中，設定 MinimumAge 特性。MinimumAge 特性會根據上次修改過的時間戳記，指定要擷取之檔案的最小存在時間。這樣就能夠在大型檔案完全複製到輸入目錄之後才擷取檔案以供處理。

有優先順序的初始測量處理

SGG 轉接器會為利用智慧計量表指令及/或完成事件所建立的初始測量處理設定優先順序，方法是將這些初始測量類型中的「執行方法」標誌設定為「即時」(D1RT)。此外，收到「執行方法」標誌設為「即時」的初始測量會即時處理，而不是透過批次處理。如需詳細資訊，請參閱 Oracle Utilities Meter Data Management / Smart Grid Gateway 業務使用者指南中的初始測量資料優先順序設定。