Payload Handler Classes and Parameters

This section provides valid Payload Handler Class Names and associated dynamic parameters for supported head end systems and payload types.

Adapter Development Kit

As delivered, the Adapter Development Kit supports payload processing of usage and event data exported from an AMI head end system in the “native” initial measurement and device event data formats (the format of the initial measurement and device event seeder business objects). See The Adapter Development Kit Native Format for more information.

Payload Type: ADK CSV

  • Payload Handler Class: com.splwg.d1.domain.sgg.dg.processing.CSVPayloadHandler

Payload Type: ADK XML

  • Payload Handler Class: com.splwg.d1.domain.sgg.dg.processing.XMLPayloadHandler

Payload Type: ADK Seeder

  • Payload Handler Class: com.splwg.d1.domain.sgg.dg.processing.SeederPayloadHandler

Processing Custom and Non-Standard Formats

The Adapter Development Kit can be configured to support payload processing of data from AMI head end systems in custom and non-standard formats. Processing payloads of this type requires a specific Payload Handler Class (see below), and creation of Groovy Library Scripts to parse and transform data into the “native” format. See Adapter Development Kit Custom Payload Processing and Payload Processing User Exit Interceptor Scripts for more information.

  • Payload Handler Class: com.splwg.d1.domain.sgg.dg.processing.PayloadHandlerViaUserExits

The Adapter Development Kit also supports payload processing of data in the Common Information Model (CIM) format. See Adapter Development Kit Common Information Model (CIM) Payload Processing for more information.

Common Parameters

The following parameters can be used by all of the supported head end system adapters.

Dynamic Parameter Name

Description and Valid Values

suppressPayloadStatistics

Optional parameter. Determines if the PayloadStatistics business object will not be created while processing payload. If this set to false or not provided, then the default existing behavior when a PayloadStatistics business object is created at the start of the payload processing. Valid values are ‘true’ and ‘false’ (default).

suppressPayloadError

Optional parameter. Determines if the PayloadErrorNotification business object will not be created when an error occurs while processing payload. If this set to false or not provided, then the default existing behavior when a PayloadErrorNotification business object is created for every error occurred during the payload processing. If this set to false, the error description will be written into the application log file. Valid values are ‘true’ and ‘false’ (default).

suppressPayloadSummary

Optional parameter. Determines if the PayloadSummary business object will not be created while processing payload. If this set to false or not provided, then the default existing behavior when a PayloadSummary business object is created at the end of the payload processing. Valid values are ‘true’ and ‘false’ (default).

createFilePerCommit

Optional parameter. Determines how files are created when streaming files out to a file system or Object Storage. When set to true, streamed out files are written per commit. Valid values are ‘true’ and ‘false’ (default).

commitSizeInKB

Optional Parameter. Specifies the total amount of memory (in KB) allocated for Device Event and IMD seeders before they are committed. Seeders are kept in memory until their size exceeds the value defined for this parameter or the end of payload is reached.

Default value is 100.

Note: This parameter (either the default value or a specified value) is ignored when the chunkSize parameter is set.

chunkSize

Optional parameter. Specifies the size in bytes of a portion (chunk) of the payload that will be processed in a single batch “thread”.

If parameter is set, the commitSizeInKB parameter is ignored.

This parameter is supported by the following payload formats:
  • Landis+Gyr Usage

  • Landis+Gyr Events

  • MV90 Usage

  • Sensus RNI Usage

  • Sensus RNI Events

  • Silver Spring Networks Usage (CSV)

  • Adapter Development Kit Usage sample format (CSV)

  • Adapter Development Kit via User Exits (if an instance returned from the getParser method implements the com.splwg.d1.domain.sgg.dg.processing.ChunkProcessor  interface).