初始測量與裝置事件

系統會將從 AMI 前端系統匯出的用量和事件資料載入至 Oracle Utilities，作為初始測量與裝置事件資料。您可以設定下列基準產品 OSB 專案來自訂此項目的處理：

  1. SGG-DG-CSV-BASE 包含無法在客戶端變更的元件。這些元件會實作 CSV 格式處理 (例如，驗證和轉換) 特定的函式。

  2. SGG-DG-CSV-CM 可讓您自訂並簡化未來的升級作業。

  3. SGG-DG-XML-BASE 包含無法在客戶端變更的元件。這些元件會實作初始測量資料與事件上傳格式處理 (例如，驗證和轉換) 特定的函式。

  4. SGG-DG-XML-CM 可讓您自訂並簡化未來的升級作業。

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

下表描述包含在 SGG-DG-CSV-CM EnvironmentSettings.xq 檔案中的元素：

元素

描述

有效值

populateRaw

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

true

false

callPreProcessing

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

true

false

callPostProcessing

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

true

false

destinationRootElementEvent

保留裝置事件匯集器之內送 Web 服務的名稱。

destinationRootElementIMD

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

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

下表描述包含在 SGG-DG-XML-CM EnvironmentSettings.xq 檔案中的元素：

元素

描述

有效值

populateRawIMD

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

true

false

callPreProcessing

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

true

false

callPostProcessing

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

true

false

destinationRootElement

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

如需 Oracle Utilities Smart Grid Gateway Adapter Development Kit 中所包含之 OSB 實作範例的其他資訊，請參閱 Oracle Service Bus 處理。

處理大型輸入檔案

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

處理採用 Adapter Development Kit 原生格式的資料

從 AMI 前端系統匯出的用量與事件資料可以「原生」初始測量和裝置事件資料格式 (初始測量和裝置事件匯集器業務物件的格式) 載入至 Oracle Utilities。您可以設定下列基準產品 OSB 專案來自訂此項目的處理：

  1. SGG-DG-SEEDER-BASE 包含無法在客戶端變更的元件。這些元件會實作初始測量資料與事件上傳格式處理 (例如，驗證和轉換) 特定的函式。

  2. SGG-DG-SEEDER-CM 可讓您自訂並簡化未來的升級作業。

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

下表描述包含在 SGG-DG-SEEDER-CM EnvironmentSettings.xq 檔案中的元素：

元素

描述

有效值

callPreProcessing

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

true

false

callPostProcessing

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

true

false

destinationRootElementInterval

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

destinationRootElementScalar

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

destinationRootElementEvent

保留裝置事件匯集器之內送 Web 服務的名稱。

publishServices/service

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

filterEvents

決定是否要篩選事件。

true

false

filterUsage

決定是否要篩選用量。

true

false

如需有關 ADK「原生」格式的詳細資訊，請參閱 Adapter Development Kit 原生格式。

發布初始測量資料與裝置事件

您可以設定 Adapter Development Kit 來發布初始測量資料和裝置事件，以用於 Oracle DataRaker 或其他外部系統。我們透過 OSB 元件與 BPEL 複合的組合來支援此功能。

啟用資料發布

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

SGG-DG-SEEDER-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

篩選初始測量資料

您可以設定 Adapter Development Kit 來篩選傳遞至 Oracle Utilities Smart Grid Gateway 和 Meter Data Management 的初始測量資料。若要啟用篩選資料的功能，請將 EnvironmentSettings.xq 檔案中的 <filterUsage> 元素設定為 “true”，如下所示：
<filterUsage>true</filterUsage>

啟用篩選時，只有其 <externalUOM> 與您在 ADK - 計量單位代碼與標準計量單位的對應可延伸查尋 (DG-HeadendUOMLookup) 中定義之其中一個值相符的測量，才會傳遞至系統進行處理。

篩選事件

您可以設定 Adapter Development Kit 來篩選傳送到 Oracle Utilities Smart Grid Gateway 和 Meter Data Management 的裝置事件。將 EnvironmentSettings.xq 檔案中的 <filterEvents> 元素設定為 "True" 即可啟用篩選，如下所示：
<filterEvents>true</filterEvents>

啟用篩選時，只有其 <externalEventName> 與您在 ADK - 裝置事件對應可延伸查尋 (DG-DeviceEventMappingLookup) 中定義之其中一個值相符的裝置事件，才會傳遞至系統進行處理。

有優先順序的裝置事件處理

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

設定承載處理通知

根據預設，「承載統計資料」、「承載錯誤通知」及「承載摘要」通知活動會傳送至 Oracle Service Bus 內的「通知佇列」。您可以設定 Smart Grid Gateway 轉接器來限制傳送這些活動，方法是在適當的 OSB 專案中，定義選擇性的 JCA 傳輸動態特性。下列選擇性 JCA 傳輸動態特性可用來控制是否要傳送這些通知活動：

  • SGG_​SEND_​STATISTICS：控制是否要傳送「承載統計資料」活動 (True：傳送，False：不傳送)
  • SGG_​SEND_​ERROR：控制是否要傳送「承載錯誤通知」活動 (True：傳送，False：不傳送)
  • SGG_​SEND_​SUMMARY：控制是否要傳送「承載摘要」活動 (True：傳送，False：不傳送)

這些特性設定為 False 時，相對應的承載通知不會傳送到 JMS 佇列。請注意，預設不會植入這些特性，若省略，預設值會是 True。

如何建立這些特性：

  1. 導覽至 Oracle Service Bus 主控台中的 SGG-D3-CIM-EVENT-CM 專案。

  2. 展開 Proxy 服務資料夾。

  3. 選取 InboundProxyService Proxy 服務 (而不是「管線」或 WSDL)。

  4. 按一下建立以建立新的階段作業。

  5. 選取傳輸明細。

  6. 按一下動態端點特性區段中的加號。此時，畫面會顯示空白的資料列。

  7. 在特性資料欄中，輸入您要定義的特性。

  8. 在值欄中，輸入 "false"。

  9. 針對您要定義的每個特性，重複執行步驟 6 至 8。

  10. 按一下啟用以儲存並啟用變更。

備註：
只會在 SGG_​EXT_​ID_​PATTERN 不存在或是一般表示式沒有任何擷取結果時使用這些特性。當一般表示式擷取到群組資料時，SGG_​EXT_​ID_​PATTERN 就會置換這些特性。