Classes e Parâmetros do Manipulador de Carga Útil

Esta seção fornece Nomes de Classes de Manipuladores de Carga Útil válidos e parâmetros dinâmicos associados para sistemas head-end e tipos de carga úteis suportados.

Kit de Desenvolvimento de Adaptadores

Conforme entregue, o Kit de Desenvolvimento de Adaptadores suporta o processamento de carga útil dos dados de uso e evento exportados de um sistema de AMI nos formatos "nativos" de medição inicial e de dados do evento do dispositivo (o formato dos objetos de negócios da medida inicial e do seeder de eventos do dispositivo). Consulte Formato Nativo do Kit de Desenvolvimento do Adaptador para obter mais informações.

Tipo de Carga Útil: ADK CSV

  • Classe do Manipulador de Carga Útil: com.splwg.d1.domain.sgg.dg.processing.CSVPayloadHandler

Tipo de Carga Útil: ADK XML

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.dg.processing.XMLPayloadHandler

Tipo de Carga Útil: ADK Seeder

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.dg.processing.SeederPayloadHandler

Processando Formatos Personalizados e Não Padronizados

O Kit de Desenvolvimento do Adaptador pode ser configurado para suportar o processamento de carga útil de dados dos sistemas head-end AMI em formatos personalizados e não padrão. O processamento de cargas úteis desse tipo requer uma Classe de Manipulador de Carga Útil (veja abaixo) e a criação de scripts da Biblioteca do Groovy para analisar e transformar dados no formato "nativo". Consulte Processamento de Carga Útil Personalizada do Kit de Desenvolvimento de Adaptadores e Scripts de Interceptador de Saída de Usuário de Processamento de Carga Util para obter mais informações.

  • Classe do Manipulador de Carga Útil: com.splwg.d1.domain.sgg.dg.processing.PayloadHandlerViaUserExits

O Kit de Desenvolvimento do Adaptador também suporta o processamento de carga útil de dados no formato de Modelo de Informações Comuns (CIM). Para obter mais informações, consulte Processamento de Carga Útil do Modelo de Informações Comuns (CIM) do Kit de Desenvolvimento do Adaptador.

Adaptador para Itron OpenWay

Tipo de Carga Útil: Itron OpenWay XML

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d8.processing.ItronXMLPayloadHandler
  • Parâmetros Dinâmicos:

Nome do Parâmetro Dinâmico

Descrição e Valores Válidos

intervalValueDecPlaces

Valor opcional. Especifica o número de dígitos após a casa decimal para o valor da quantidade. Caso este parâmetro não seja encontrado, a lógica de processamento assume como padrão o número de dígitos após a casa decimal como 6.

filterRegisterSource

Valor opcional. Determina se os dados do registro da fonte devem ser filtrados. Os valores válidos são "verdadeiro" e "falso" (padrão)

Tipo de Carga Útil: Itron OpenWay Exception

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d8.processing.ExceptionPayloadHandler

Adaptador MV90 para Itron

Tipo de Carga Útil: MV90

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d5.processing.MV90PayloadHandler
  • Parâmetros Dinâmicos:

Nome do Parâmetro Dinâmico

Descrição e Valores Válidos

usePhysicalChannel

Valor opcional. Determina se o ID do canal físico é passado ao Seeder do IMD para criar o número identificador do componente de medição. Se isso estiver definido como falso, o campo MV90 LOGCHAN será usado.

fieldForDvcIdN

Valor opcional. Especifica qual campo é usado como o valor para o ID do dispositivo. Os valores válidos incluem:

  • DC_RECID

  • DC_CUSTID

  • DC_METERID (padrão)

MV90ScalarChannelSuffix

Valor opcional. Mantém um valor de sufixo a ser adicionado ao número do identificador do componente de medição quando um scalarIMD é criado para leituras de registro. O valor padrão é "_S".

processMV90ScalarData

Valor opcional. Determina se as leituras do registro são processadas. Os valores válidos são "verdadeiro" e "falso" (padrão).

sendStatusAsIs

Valor opcional. Determina se os códigos de status serão passados conforme vieram do head-end. Se definido como falso ou não fornecido, o comportamento padrão existente quando um código de status é analisado e os tipos de status passados para o seeder do IMD na qual os bits estão ativados. Os valores válidos são "verdadeiro" e "falso" (padrão).

MV90DateFormat

Valor opcional. Mantém o formato da data usado para analisar os campos de data/hora fornecidos. O código suporta a lista limitada de valores para o formato. Se esse parâmetro estiver ausente ou se o valor fornecido não corresponder aos valores dessa lista, o formato usado será MDDYYhhmm, o valor padrão. Os valores válidos incluem:

  • MMDDYYhhmm (padrão)

  • MMYYDDhhmm

  • DDMMYYhhmm

  • DDYYMMhhmm

  • YYMMDDhhmm

  • YYDDMMhhmm

MV90IntervalValueDecPlaces

Valor opcional. Especifica o número de dígitos após a casa decimal para o valor da quantidade. Caso este parâmetro não seja encontrado, a lógica de processamento assume como padrão o número de dígitos após a casa decimal como 6.

MV90StrtmtrAndStopmtrToDecimal

Valor opcional. Determina se o MV90 STRTMTR (Medidor de Início de Leitura) e STOPMTR (Medidor de Parada de Leitura) serão convertidos para um decimal. A lógica de processamento tratará esses campos, pois o decimal usa a configuração para determinar quantos pontos decimais são necessários.

Adaptador para Landis+Gyr

Tipo de Carga Útil: uso do L+G

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d3.processing.LGUsagePayloadHandler
  • Parâmetros Dinâmicos:

Nome do Parâmetro Dinâmico

Descrição e Valores Válidos

dateTimeInUTC

Indica se o sistema Landis + Gyr está enviando informações de data/hora no UTC (verdadeiro) ou na hora local do dispositivo (falso). Se não for fornecido, o comportamento padrão será a hora local do dispositivo. Os valores válidos são "verdadeiro" e "falso" (padrão)

Tipo de Carga Útil: L+G Event

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d3.processing.LGEventPayloadHandler
  • Parâmetros Dinâmicos:

Nome do Parâmetro Dinâmico

Descrição e Valores Válidos

dateTimeInUTC

Indica se o sistema Landis + Gyr está enviando informações de data/hora no UTC (verdadeiro) ou na hora local do dispositivo (falso). Se não for fornecido, o comportamento padrão será a hora local do dispositivo. Os valores válidos são "verdadeiro" e "falso" (padrão)

Tipo de Carga Útil: uso do L+G

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d3.processing.LGCIMEventPayloadHandler
  • Parâmetros Dinâmicos: N/A

Adaptador para Sensus

Tipo de Carga Útil: Sensus RNI Usage

  • Classe do Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d6.processing.SensusUsagePayloadHandler
  • Parâmetros Dinâmicos:

Nome do Parâmetro Dinâmico

Descrição e Valores Válidos

dateTimeInUTC

Indica se o sistema Sensus RNI está enviando informações de data/hora em UTC (verdadeiro) ou hora local do dispositivo (falso). Se não for fornecido, o comportamento padrão será a hora local do dispositivo. Os valores válidos são "verdadeiro" e "falso" (padrão).

useExternalTOU

Aplica-se somente a uso Escalar.

Indica se um período de horário de uso de referência externa deve ou não ser usado ao processar dados de medição.

Quando definido como verdadeiro, o Sensus do período de horário de uso será informado para o Seeder de IMD como um horário de uso externo "preVEE/externalTOU". Quando não for fornecido ou definido como falso, o Sensus do período de Horário de Uso será informado para o Seeder de IMD como o número do identificador MC externo "preVEE/mcIdN". Os valores válidos são "verdadeiro" e "falso" (padrão).

sendStatusAsIs

Determina se os códigos de status serão passados conforme recebidos do head-end. Quando definido como verdadeiro, os códigos de status serão enviados à medida que forem recebidos do head-end. Quando não for fornecido ou definido como falso, os códigos de status do cabeçalho serão processados por meio de uma máscara de bits para produzir vários status individuais. Os valores válidos são "verdadeiro" e "falso" (padrão).

sendIntervalDateTimes

Quando definido como verdadeiro, o elemento "preVEE/msrms/mL/dt" do seeder IMD para registros de intervalo será preenchido com a data/hora do intervalo e o elemento "preVEE/enDt" será preenchido com a data/hora do intervalo do último intervalo. Quando não for fornecido ou definido como falso, o elemento "preVEE/msrms/mL/dt" do seeder de IMD para registros de intervalo não será preenchido e o elemento "preVEE/enDt" será preenchido com: data inicial + spi * número de intervalos. Os valores válidos são "verdadeiro" e "falso" (padrão).

scalarExpanding

Valor Opcional. Define o número de leituras de registro a serem processadas em cargas úteis escalares. Quando definido, o processamento de cargas úteis do Sensus usa essa definição para garantir que todas as leituras escalares incluídas em uma carga útil sejam processadas.

O valor padrão é 2.

Tipo de Carga Útil: Sensus RNI Event

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d6.processing.SensusEventPayloadHandler
  • Parâmetros Dinâmicos:

Nome do Parâmetro Dinâmico

Descrição e Valores Válidos

dateTimeInUTC

Indica se o sistema Sensus RNI está enviando informações de data/hora em UTC (verdadeiro) ou hora local do dispositivo (falso). Se não for fornecido, o comportamento padrão será a hora local do dispositivo. Os valores válidos são "verdadeiro" e "falso" (padrão)

Adaptador para Silver Spring Networks

Tipo de Carga Útil: Silver Spring Networks CSV

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d7.processing.SSNCSVPayloadHandler

Tipo de Carga Útil: Silver Spring Networks XML

  • Classe de Manipulador de Carga Útil: com.splwg.d1.domain.sgg.d7.processing.SSNXMLPayloadHandler

Parâmetros Comuns

Os seguintes parâmetros podem ser usados por todos os adaptadores de sistema head-end.

Nome do Parâmetro Dinâmico

Descrição e Valores Válidos

suppressPayloadStatistics

Parâmetro opcional. Determina se o objeto de negócios PayloadStatistics não será criado durante o processamento da carga útil. Se configurado como falso ou não fornecido, o comportamento padrão existente quando um objeto de negócios PayloadStatistics for criado no início do processamento da carga útil. Os valores válidos são "verdadeiro" e "falso" (padrão).

suppressPayloadErrorNotification

Parâmetro opcional. Determina se o objeto de negócios PayloadErrorNotification não será criado quando ocorrer um erro ao processar a carga útil. Se configurado como falso ou não fornecido, o comportamento padrão existente quando um objeto de negócios PayloadErrorNotification será criado para cada erro ocorrido durante o processamento da carga útil. Se definido como falso, a descrição do erro será gravada no arquivo de registro do aplicativo. Os valores válidos são "verdadeiro" e "falso" (padrão).

suppressPayloadSummary

Parâmetro opcional. Determina se o objeto de negócios PayloadSummary não será criado durante o processamento da carga útil. Se configurado como falso ou não fornecido, o comportamento padrão existente quando um objeto de negócios PayloadSummary será criado no final do processamento da carga útil. Os valores válidos são "verdadeiro" e "falso" (padrão).

commitSizeInKB

Parâmetro opcional. Especifica a quantidade total de memória (em KB) alocada para o Evento do Dispositivo e os seeders de IMD antes de serem submetidos a commit. Os seeders são mantidos na memória até que seu tamanho exceda o valor definido para esse parâmetro ou o fim da carga útil seja atingido.

O valor padrão é 100.

Observação: Este parâmetro (o valor padrão ou um valor especificado) é ignorado quando o parâmetro chunkSize é definido.

chunkSize

Parâmetro opcional. Especifica o tamanho em bytes de uma parte da carga útil que será processada em um único "thread" de batch.

Se o parâmetro estiver definido, o parâmetro commitSizeInKB será ignorado.

Este parâmetro é suportado pelos seguintes formatos de carga útil:
  • Uso do Landis+Gyr

  • Eventos do Landis+Gyr

  • MV90 Uso

  • Uso Sensus RNI

  • Eventos Sensus RNI

  • Uso de redes Silver Spring (CSV)

  • Formato de amostra de Uso do Kit de Desenvolvimento do Adaptador (CSV)

  • Kit de Desenvolvimento do Adaptador via Saídas do Usuário (se uma instância retornada do método getParser implementar a interface com.splwg.d1.domain.sgg.dg.processing.ChunkProcessor).