Clases y parámetros de manejador de carga útil

En esta sección se proporcionan nombres de clases de manejador de carga útil y sus parámetros asociados válidos para los sistemas de recopilación de datos y tipos de carga útil soportados.

Adapter Development Kit

Tal y como se proporciona, Adapter Development Kit soporta el procesamiento de carga útil de datos de consumo y eventos exportados de un sistema de recopilación de datos de infraestructura de medición avanzada en los formatos “nativos” de datos iniciales de medida y eventos de dispositivo (el formato de los objetos de negocio de predefinición de medidas iniciales y eventos de dispositivo). Consulte Formato nativo de Adapter Development Kit para obtener más información.

Tipo de carga útil: ADK CSV

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.dg.processing.CSVPayloadHandler

Tipo de carga útil: ADK XML

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.dg.processing.XMLPayloadHandler

Tipo de carga útil: ADK Seeder

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.dg.processing.SeederPayloadHandler

Procesamiento de formatos no estándar y personalizados

Adapter Development Kit se puede configurar para soportar el procesamiento de carga útil de datos desde sistemas de recopilación de datos de infraestructura de medición avanzada en formatos no estándar y personalizados. El procesamiento de cargas útiles de este tipo necesita una clase de manejador de carga útil específica (consulte a continuación) y la creación de scripts de biblioteca de Groovy para analizar y transformar datos al formato “nativo”. Consulte Procesamiento de carga útil personalizada de Adapter Development Kit y Scripts de interceptor de salida de usuario de procesamiento de carga útil para obtener más información.

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.dg.processing.PayloadHandlerViaUserExits

Adapter Development Kit también soporta el procesamiento de datos de carga útil en el formato del modelo de información común (CIM). Consulte Procesamiento de carga útil del modelo de información común (CIM) de Adapter Development Kit para obtener más información.

Adaptador para OpenWay de Itron

Tipo de carga útil: Itron OpenWay XML

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d8.processing.ItronXMLPayloadHandler
  • Parámetros dinámicos:

Nombre de parámetro dinámico

Descripción y valores válidos

intervalValueDecPlaces

Valor opcional. Especifica el número de dígitos después del signo de decimales correspondiente al valor de cantidad. Si falta este parámetro, la lógica de procesamiento define por defecto dicho número en 6.

filterRegisterSource

Valor opcional. Determina si deben filtrarse los datos de registro de origen. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto)

Tipo de carga útil: Excepción de OpenWay de Itron

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d8.processing.ExceptionPayloadHandler

Adaptador MV90 para Itron

Tipo de carga útil: MV90

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d5.processing.MV90PayloadHandler
  • Parámetros dinámicos:

Nombre de parámetro dinámico

Descripción y valores válidos

usePhysicalChannel

Valor opcional. Determina si el ID de canal físico se transfiere a la predefinición de datos iniciales de medida para crear el número de identificador del componente de medición. Si se define como falso, se utiliza el campo MV90 LOGCHAN.

fieldForDvcIdN

Valor opcional. Especifica qué campo se utiliza como valor para el ID de dispositivo. Los valores válidos son:

  • DC_​RECID

  • DC_​CUSTID

  • DC_​METERID (por defecto)

MV90ScalarChannelSuffix

Valor opcional. Contiene un valor de sufijo que se añadirá al número de identificador del componente de medición cuando se crean datos iniciales de medida escalar para lecturas de registro. El valor por defecto es “_​S”

processMV90ScalarData

Valor opcional. Determina si se procesan las lecturas de registro. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

sendStatusAsIs

Valor opcional. Determina si los códigos de estado se transferirán como si procedieran del sistema de recopilación de datos. Si se define como falso o no se proporciona, se toma por defecto el comportamiento existente cuando se analiza un código de estado y se transfieren los tipos de estado a la predefinición de datos iniciales de medida en la que se activan los bits. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

MV90DateFormat

Valor opcional. Contiene el formato de fecha utilizado para analizar campos de fecha y hora proporcionados. El código soporta la lista limitada de valores para el formato. Si falta este parámetro o el valor suministrado no coincide con ninguno de esta lista, el formato que se utilice será MDDYYhhmm, el valor por defecto. Los valores válidos son:

  • MMDDYYhhmm (por defecto)

  • MMYYDDhhmm

  • DDMMYYhhmm

  • DDYYMMhhmm

  • YYMMDDhhmm

  • YYDDMMhhmm

MV90IntervalValueDecPlaces

Valor opcional. Especifica el número de dígitos después del signo de decimales correspondiente al valor de cantidad. Si falta este parámetro, la lógica de procesamiento define por defecto dicho número en 6.

MV90StrtmtrAndStopmtrToDecimal

Valor opcional. Determina si MV90 STRTMTR (inicio de lectura de contador) y STOPMTR (detención de lectura de contador) se convertirá a un decimal. La lógica de procesamiento tratará estos campos como decimales. Utilice la configuración para determinar el número de decimales que son necesarios.

Adaptador para Landis+Gyr

Tipo de carga útil: Consumo de L+G

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d3.processing.LGUsagePayloadHandler
  • Parámetros dinámicos:

Nombre de parámetro dinámico

Descripción y valores válidos

dateTimeInUTC

Indica si el sistema Landis+Gyr envía información de fecha/hora en UTC (verdadero) o en la hora local del dispositivo (falso). Si no se indica, el comportamiento por defecto será la hora local del dispositivo. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto)

Tipo de carga útil: Evento de L+G

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d3.processing.LGEventPayloadHandler
  • Parámetros dinámicos:

Nombre de parámetro dinámico

Descripción y valores válidos

dateTimeInUTC

Indica si el sistema Landis+Gyr envía información de fecha/hora en UTC (verdadero) o en la hora local del dispositivo (falso). Si no se indica, el comportamiento por defecto será la hora local del dispositivo. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto)

Tipo de carga útil: Evento de L+G CIM

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d3.processing.LGCIMEventPayloadHandler
  • Parámetros dinámicos: N/A

Adaptador para Sensus

Tipo de carga útil: Consumo de RNI de Sensus

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d6.processing.SensusUsagePayloadHandler
  • Parámetros dinámicos:

Nombre de parámetro dinámico

Descripción y valores válidos

dateTimeInUTC

Indica si el sistema RNI de Sensus envía información de fecha/hora en UTC (verdadero) o en la hora local del dispositivo (falso). Si no se indica, el comportamiento por defecto será la hora local del dispositivo. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

useExternalTOU

Se aplica solo al consumo escalar.

Indica si se debe o no utilizar un período de discriminación horaria de referencias externas cuando se procesan datos de medidas.

Cuando se define como verdadero el período de discriminación horaria que Sensus proporciona se transferirá a la predefinición de datos iniciales de medida como “preVEE/externalTOU” de discriminación horaria externa. Si no se proporciona o se define como falso, el período de discriminación horaria que Sensus proporciona se transferirá a la predefinición de datos iniciales de medida como el número de identificador de componente de medición “preVEE/mcIdN”. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

sendStatusAsIs

Determina si los códigos de estado se transferirán como si se hubieran recibido del sistema de recopilación de datos. Cuando se definen como verdaderos, los códigos de estado se enviarán como si se hubieran recibido del sistema de recopilación de datos. En cambio, cuando no se proporcionan o se definen como falsos, los códigos de estado del sistema de recopilación de datos se procesarán a través de una máscara de bits para producir varios estados individuales. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

sendIntervalDateTimes

Cuando se define como verdadero, se rellenará el elemento “preVEE/msrms/mL/dt” de la predefinición de datos iniciales de medida para registros de intervalo con la fecha y hora de intervalo y el elemento “preVEE/enDt” se rellenará con la fecha/hora del último intervalo. Cuando se define como falso o no se proporciona, no se rellenará el elemento “preVEE/msrms/mL/dt” de la predefinición de datos iniciales de medida para registros de intervalo y el elemento “preVEE/enDt” se rellenará con la fecha de inicio + segundos por intervalo * número de intervalos. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

scalarExpanding

Valor opcional. Define el número de lecturas de registro que se procesarán en las cargas útiles escalares. Cuando se defina, el procesamiento de carga útil de Sensus utilizará este valor para garantizar que se procesan todas las lecturas escalares incluidas en una carga útil.

El valor por defecto es 2.

Tipo de carga útil: evento de RNI de Sensus

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d6.processing.SensusEventPayloadHandler
  • Parámetros dinámicos:

Nombre de parámetro dinámico

Descripción y valores válidos

dateTimeInUTC

Indica si el sistema RNI de Sensus envía información de fecha/hora en UTC (verdadero) o en la hora local del dispositivo (falso). Si no se indica, el comportamiento por defecto será la hora local del dispositivo. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto)

Adaptador para Silver Spring Networks

Tipo de carga útil: Silver Spring Networks CSV

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d7.processing.SSNCSVPayloadHandler

Tipo de carga útil: Silver Spring Networks XML

  • Clase de manejador de carga útil: com.splwg.d1.domain.sgg.d7.processing.SSNXMLPayloadHandler

Parámetros comunes

Todos los adaptadores de sistema de recopilación de datos soportados pueden utilizar los parámetros siguientes.

Nombre de parámetro dinámico

Descripción y valores válidos

suppressPayloadStatistics

Parámetro opcional. Determina si no se creará el objeto de negocio PayloadStatistics al procesar la carga útil. Si se define como falso o no se proporciona, se toma por defecto el comportamiento existente cuando se crea un objeto de negocio PayloadStatistics al inicio del procesamiento de carga útil. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

suppressPayloadErrorNotification

Parámetro opcional. Determina si no se creará el objeto de negocio PayloadErrorNotification cuando se produce un error al procesar la carga útil. Si se define como falso o no se proporciona, se toma por defecto el comportamiento existente cuando se crea un objeto de negocio PayloadErrorNotification para todos los errores que suceden durante el procesamiento de carga útil. Si se define como falso, la descripción del error se escribirá en el fichero log de la aplicación. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

suppressPayloadSummary

Parámetro opcional. Determina si no se creará el objeto de negocio PayloadSummary al procesar la carga útil. Si se define como falso o no se proporciona, se toma por defecto el comportamiento existente cuando se crea un objeto de negocio PayloadSummary al final del procesamiento de carga útil. Los valores válidos son ‘verdadero’ y ‘falso’ (por defecto).

commitSizeInKB

Parámetro opcional. Especifica la cantidad total de memoria (en KB) asignada a las predefiniciones de datos iniciales de medida y de evento de dispositivo antes de que se validen. Las predefiniciones se guardan en memoria hasta que su tamaño supera el valor definido para este parámetro o se llega al final de la carga útil.

El valor por defecto es 100.

Nota: este parámetro (el valor por defecto o uno especificado) se ignora cuando se establece el parámetro chunkSize.

chunkSize

Parámetro opcional. Especifica el tamaño en bytes de una parte (fragmento) de la carga útil que se procesará en un solo “hilo” de lote.

Si el parámetro está establecido, se ignora el parámetro commitSizeInKB.

Este parámetro se soporta por los formatos de carga útil siguientes:
  • Consumo de Landis+Gyr

  • Eventos de Landis+Gyr

  • Consumo de MV90

  • Consumo de RNI de Sensus

  • Eventos de RNI de Sensus

  • Consumo de Silver Spring Networks (CSV)

  • Formato de ejemplo de consumo de Adapter Development Kit (CSV)

  • Adapter Development Kit mediante salidas del usuario (si una instancia devuelta del método getParser implanta la interfaz com.splwg.d1.domain.sgg.dg.processing.ChunkProcessor).