Loading Initial Measurement Data and Device Events
Initial measurement data and device event loading and processing use OSB to poll for, parse, and transform the head-payloads into the Oracle Utilities Smart Grid Gateway service format. Payloads contain measurements and meter events in some head-end specific format OSB then places each service call into a JMS queue within the Oracle Utilities applications. The JMS client consumes the entries and invokes the respective services in parallel then a service creates initial measurements with data in a common format with head-end-specific processing as needed. A second service creates device events with data in a common format.
As noted above, measurement and device event data must be requested from the Itron OpenWay head-end system via Scheduled Read commands. See About Scheduled Read Commands on page 13 and Initiating Scheduled Read Commands on page 19 in the Oracle Utilities Smart Grid Gateway Adapter for Itron OpenWay User’s Guide for more information about Scheduled Read commands.
Initial Measurement
The usage data received from the AMI head-end system as a file in Itron OpenWay XML format is loaded into Oracle Utilities as initial measurement data. The following OSB projects, delivered in the base product, help manage the usage processing:
The runtime configuration settings for the SGG-D8-ITRONXML-CM project are stored in the xquery file EnvironmentSettings.xq. You can use this file to adjust initial measurement data processing. For example, if you want to load raw data you would specify "true" for the content of the populateRawIMD element.
The following table describes the elements included in the EnvironmentSettings.xq file:
Processing Large Input Files
In some environments, the OSB project may begin processing a large input file before it has been completely copied to the input directory. To prevent this, configure the MinimumAge property in the "InboundProxyService" proxy service for the SGG-D8-ITRONXML-CM project. The MinimumAge property specifies the minimum age of files to be retrieved, based on the last modified time stamp. This enables large files to be completely copied to the input directory before they are retrieved for processing.
See Working with Adapter OSB Projects in the Oracle Utilities Smart Grid Gateway Configuration Guide for more information about setting the MinimumAge property.
Device Events
Itron OpenWay can send real-time events such as meter outage alarms to Oracle Utilities Smart Grid Gateway. These events are referred to as exceptions in the Itron architecture, and are sent to the BPEL ExceptionSubscriberService service by Itron OpenWay without requiring an explicit request from Oracle Utilities Smart Grid Gateway. Exceptions are loaded as device events data and provided to the edge applications.
The required functionality is delivered in the base product as two OSB projects:
Base Package Business Objects
The Itron OpenWay adapter base package includes the following initial measurement and device event business objects:
Itron OpenWay Device Event Mapping BO
The Itron OpenWay head-end system is capable of sending a large selection of device events. The adapter maps these events into standard Oracle Utilities Smart Grid Gateway event names and categories. To meet this end, a Itron OpenWay-specific extendable lookup business object, D8-DeviceEventMappingLookup, holds device event names specific to Itron OpenWay.