Medições Iniciais e Eventos do Dispositivo

Os dados de uso e de eventos exportados do sistema Head-End AMI são carregados no Oracle Utilities como dados de medição inicial e de eventos de dispositivo. Você pode personalizar o processamento desses dados configurando os seguintes projetos OSB de produtos básicos:

  1. O SGG-DG-CSV-BASE contém componentes que não devem ser alterados pelo cliente. Eles implementam funções específicas para o processamento do formato CSV, como validação e transformação.

  2. O SGG-DG-CSV-CM permite personalização e simplifica atualizações futuras.

  3. O SGG-DG-XML-BASE contém componentes que não devem ser alterados pelo cliente. Eles implementam funções específicas para o processamento do formato de carregamento de IMD e de evento, como validação e transformação.

  4. O SGG-DG-XML-CM permite personalização e simplifica atualizações futuras.

As definições de configuração de tempo de execução para o projeto SGG-DG-CSV-CM estão armazenadas no arquivo XQuery EnvironmentSettings.xq. Você pode usar esse arquivo para ajustar o processamento dos dados de medição inicial e de eventos de dispositivos. Por exemplo, se quiser carregar dados brutos, você especificaria "verdadeiro" para o conteúdo do elemento populateRaw.

A tabela a seguir descreve os elementos incluídos no arquivo EnvironmentSettings.xq do SGG-DG-CSV-CM:

Elemento

Descrição

Valores Válidos

populateRaw

Determina se os dados de medição inicial são preenchidos como dados brutos.

true

false

callPreProcessing

Determina se o serviço de proxy de pré-processamento é chamado.

true

false

callPostProcessing

Determina se o serviço de proxy de pós-processamento é chamado.

true

false

destinationRootElementEvent

Contém o nome do serviço da Web de entrada para o seeder de eventos do dispositivo.

destinationRootElementIMD

Contém o nome do serviço da Web de entrada para o seeder do IMD.

As definições de configuração de tempo de execução para o projeto SGG-DG-XML-CM estão armazenadas no arquivo XQuery EnvironmentSettings.xq. Você pode usar esse arquivo para ajustar o processamento dos dados de medição inicial e de eventos de dispositivos. Por exemplo, se quiser carregar dados brutos, você especificaria "verdadeiro" para o conteúdo do elemento populateRaw.

A tabela a seguir descreve os elementos incluídos no arquivo EnvironmentSettings.xq do SGG-DG-XML-CM:

Elemento

Descrição

Valores Válidos

populateRawIMD

Determina se os dados de medição inicial são preenchidos como dados brutos.

true

false

callPreProcessing

Determina se o serviço de proxy de pré-processamento é chamado.

true

false

callPostProcessing

Determina se o serviço de proxy de pós-processamento é chamado.

true

false

destinationRootElement

Contém o nome do serviço da Web de entrada para o seeder do IMD.

Para obter informações adicionais sobre o exemplo de implementação do OSB incluído no Kit de Desenvolvimento do Adaptador Oracle Utilities Smart Grid Gateway, consulte Processamento do Oracle Service Bus.

Processando Arquivos de Entrada Grandes

Em alguns ambientes, o projeto OSB pode começar o processamento de um arquivo de entrada grande antes de ele ter sido completamente copiado para o diretório de entrada. Para evitar isso, configure a propriedade MinimumAge no serviço de proxy “InboundProxyService” para os projetos SGG-DG-CSV-CM e SGG-DG-XML-CM. A propriedade MinimumAge especifica a idade mínima dos arquivos a serem recuperados, com base no carimbo de data e hora modificado pela última vez. Isso permite que grandes arquivos sejam completamente copiados para o diretório de entrada, antes de serem recuperados para processamento.

Processando Dados no Formato Nativo do Kit de Desenvolvimento do Adaptador

Os dados de uso e de eventos exportados do sistema Head-End AMI podem ser carregados nos formatos de dados de medição inicial e de eventos de dispositivos "nativos" (o formato dos objetos de negócios do seeder de medição inicial e de eventos de dispositivos). Você pode personalizar o processamento desses dados configurando os seguintes projetos OSB de produtos básicos:

  1. O SGG-DG-SEEDER-BASE contém componentes que não devem ser alterados pelo cliente. Eles implementam funções específicas para o processamento do formato de carregamento de IMD e de evento, como validação e transformação.

  2. O SGG-DG-SEEDER-CM permite personalização e simplifica atualizações futuras.

As definições de configuração de tempo de execução para o projeto SGG-DG-SEEDER-CM estão armazenadas no arquivo XQuery EnvironmentSettings.xq. Você pode usar esse arquivo para ajustar o processamento dos dados de medição inicial e de eventos de dispositivos. Por exemplo, se quiser carregar dados brutos, você especificaria "verdadeiro" para o conteúdo do elemento populateRaw.

A tabela a seguir descreve os elementos incluídos no arquivo EnvironmentSettings.xq do SGG-DG-SEEDER-CM:

Elemento

Descrição

Valores Válidos

callPreProcessing

Determina se o serviço de proxy de pré-processamento é chamado.

true

false

callPostProcessing

Determina se o serviço de proxy de pós-processamento é chamado.

true

false

destinationRootElementInterval

Contém o nome do serviço da Web de entrada para o seeder de IMD de intervalo.

destinationRootElementScalar

Contém o nome do serviço da Web de entrada para o seeder de IMD escalar. Na maioria dos casos, é o mesmo que destinationRootElementInterval.

destinationRootElementEvent

Contém o nome do serviço da Web de entrada para o seeder de eventos do dispositivo.

publishServices/service

Especifica o nome do serviço de negócios no projeto OSB usado para publicar dados para sistemas externos (como o Oracle DataRaker).

filterEvents

Determina se os eventos deverão ser filtrados.

true

false

filterUsage

Determina se o uso deverá ser filtrado.

true

false

Consulte O Formato Nativo do Kit do de Desenvolvimento do Adaptador para obter mais informações sobre o formato "nativo" do ADK.

Publicando Dados de Medição Inicial e Eventos de Dispositivos

O Kit de Desenvolvimento do Adaptador pode ser configurado para publicar dados de medição inicial e eventos de dispositivos para uso no Oracle DataRaker ou em outros sistemas externos. Essa funcionalidade é suportada por meio de uma combinação de componentes OSB e de compostos BPEL.

Habilitando a Publicação de Dados

A publicação de dados é ativada ao referenciar um serviço de negócios de editor no elemento publishServices/service no arquivo EnvironmentSettings.xq da seguinte maneira:
<publishServices>
  <service>[publisherBusinessService]</service>
</publishServices>

Os seguintes componentes fornecidos com o projeto do OSB SGG-DG-SEEDER-CM são usados na publicação de dados de medição e de eventos de dispositivos no Oracle DataRaker:

  • O serviço de negócios DataRakerBusinessService é usado para enviar dados para uma fila JMS pré-configurada (definida como um Ponto de Extremidade URI), a partir da qual os dados serão publicados. Esse é o serviço de negócios que deverá ser especificado no arquivo EnvironmentSettings.xq.

  • A conta de serviço DataRakerServiceAccount é usada para definir e manter o nome de usuário e a senha necessários para acessar a fila JMS definida no serviço de negócios DataRakerBusinessService.

Configurando a Saída de Publicação

O composto BPEL SGGDRIntegration lida com a publicação dos dados no Oracle DataRaker ou outros sistemas.

Os dados de medição inicial e de eventos de dispositivo são publicados no formato de dados de medição inicial "nativo" (o formato dos objetos de negócios do seeder de medição inicial e de eventos de dispositivo). Esse formato inclui códigos normalizados de unidade de medida, condição e evento do dispositivo. Consulte o Guia do Usuário Administrativo do Kit de Desenvolvimento do Adaptador Smart Grid Gateway da Oracle Utilities para obter mais detalhes sobre esse formato.
Observação: os dados iniciais de medição publicados por esse recurso são publicados antes do processamento de VEE. Além disso, a filtragem NÃO pode ser aplicada à medição inicial ou aos dados de eventos do dispositivo publicados por esse recurso.

Os seguintes parâmetros podem ser usados para configurar detalhes de como os dados são fornecidos ao Oracle DataRaker, incluindo o diretório em que os arquivos são publicados para o Oracle DataRaker consumir, número de registros por arquivo, frequência de pesquisa etc. Esses parâmetros são definidos durante a instalação. Consulte o Guia de Instalação do Oracle Utilities Smart Grid Gateway para obter mais detalhes sobre a definição de valores para esses parâmetros.

Parâmetro

Descrição

Valor Padrão

SGG_DR_INT_QUEUE

Nome JNDI da fila para publicar cargas úteis SGG.

Essa é a fila JMS definida no serviço de negócios DataRakerBusinessService. Isso NÃO deve ser alterado.

DataRakerQueue

SOA_DR_PUBLISH_SIZE

O número de registros (cargas úteis SGG) a serem acumulados em um arquivo publicado.

100

SOA_DR_FILE_SIZE

O tamanho máximo do arquivo acumulado (cargas úteis SGG) em quilobytes.

524288

SOA_DR_ELAPSED_TIME

O período de tempo em segundos que, quando excedido, faz com que um novo arquivo de saída seja criado.

600

SOA_DR_POLLING_FREQ

A frequência da pesquisa em segundos do diretório intermediário para novos arquivos.

60

SOA_DR_STAGING_DIR

Ponto de montagem/diretório para o diretório intermediário dos arquivos de carga útil SGG acumulados.

Isso é usado internamente e NÃO deve ser alterado.

/spl/sploutput/staging

SOA_DR_INTEGRATION_DIR

Ponto de montagem/diretório a partir do qual o Oracle DataRaker consumirá os arquivos XML convertidos.

/spl/sploutput/int

Filtrando Dados da Medição Inicial

O Kit de Desenvolvimento do Adaptador pode ser configurado para filtrar dados de medição inicial passados para o Oracle Utilities Smart Grid Gateway e para o Meter Data Management. A filtragem de dados é ativada configurando o elemento <filterUsage> no arquivo EnvironmentSettings.xq como "verdadeiro" da seguinte maneira:
<filterUsage>true</filterUsage>

Quando a filtragem está ativada, apenas medições cujo <externalUOM> corresponde a um dos valores definidos na busca extensível ADK - Mapeamento do Código de Unidade de Medida para Unidade de Medida Padrão (DG-HeadendUOMLookup) são passadas para o sistema para processamento.

Filtrando Eventos

O Kit de Desenvolvimento do Adaptador pode ser configurado para filtrar eventos de dispositivos passados para o Oracle Utilities Smart Grid Gateway e para o Meter Data Management. A filtragem de dados está ativada pela configuração do elemento <filterEvents> no arquivo EnvironmentSettings.xq como "verdadeiro" da seguinte forma:
<filterEvents>true</filterEvents>

Quando a filtragem está ativada, apenas eventos de dispositivos cujo <externalEventName> corresponde a um dos valores definidos na busca extensível ADK - Mapeamento de Eventos de Dispositivos (DG-DeviceEventMappingLookup) são passados para o sistema para processamento.

Processamento de Eventos do Dispositivo Priorizados

O adaptador do SGG prioriza o processamento de eventos de dispositivos criados a partir de comandos do medidor inteligente e/ou de eventos de conclusão, configurando o flag Método de Execução nesses tipos de eventos de dispositivos como "Tempo Real" (D1RT). Além disso, eventos de dispositivos recebidos com o flag Método de Execução definido como "Tempo Real" serão processados em tempo real, não via processamento em batch. Consulte Priorização de Eventos de Dispositivos no Guia do Usuário de Negócios do Oracle Utilities Meter Data Management / Smart Grid Gateway para obter mais informações.

Configurando Notificações de Processamento de Carga Útil

Por padrão, as atividades de notificação de Estatísticas de Carga Útil, Notificação de Erro de Carga Útil e Resumo de Carga Útil são enviadas para a Fila de Notificação do Oracle Service Bus. Os adaptadores do Smart Grid Gateway podem ser configurados para restringir o envio dessas atividades com a definição de propriedades dinâmicas de transporte JCA opcionais no projeto OSB adequado. As propriedades dinâmicas de transporte JCA opcionais a seguir podem ser usadas para controlar se essas atividades de notificação são enviadas:

  • SGG_SEND_STATISTICS: Controla o envio de atividades de Estatísticas de Carga Útil (verdadeiro: enviar, falso: não enviar)
  • SGG_SEND_ERROR: Controla o envio de atividades de Notificação de Erro (verdadeiro: enviar, falso: não enviar)
  • SGG_SEND_SUMMARY: Controla o envio de atividades de Resumo de Carga Útil (verdadeiro: enviar, falso: não enviar)

Quando essas propriedades são definidas como falso, a notificação de carga útil correspondente não será enviada para a Fila do JMS. Observe que essas propriedades não estão preenchidas por padrão e ficam, por padrão, como verdadeiro, se omitidas.

Para criar essas propriedades:

  1. Navegue para o projeto SGG-D3-CIM-EVENT-CM no Oracle Service Bus Console.

  2. Expanda a pasta Serviços de Proxy.

  3. Selecione o serviço de proxy InboundProxyService (não o Pipeline ou o WSDL).

  4. Clique em Criar para criar uma nova sessão.

  5. Selecione Detalhes do Transporte.

  6. Clique no sinal de mais na seção Propriedades Dinâmicas de EndPoint. Uma linha vazia será exibida.

  7. Digite a propriedade que deseja definir na coluna Propriedade.

  8. Digite "falso" na coluna valor.

  9. Repita as etapas de 6 a 8 para cada propriedade que deseja definir.

  10. Clique em Ativar para salvar e ativas as alterações.

Observação: Essas propriedades só são usadas se o SGG_EXT_ID_PATTERN não estiver presente ou se a expressão regular não capturar nada. O SGG_EXT_ID_PATTERN substituirá essas propriedades quando a expressão regular capturar dados de grupos.