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:
-
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.
-
O SGG-DG-CSV-CM permite personalização e simplifica atualizações futuras.
-
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.
-
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:
-
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.
-
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
<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 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
<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
<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:
-
Navegue para o projeto SGG-D3-CIM-EVENT-CM no Oracle Service Bus Console.
-
Expanda a pasta Serviços de Proxy.
-
Selecione o serviço de proxy InboundProxyService (não o Pipeline ou o WSDL).
-
Clique em Criar para criar uma nova sessão.
-
Selecione Detalhes do Transporte.
-
Clique no sinal de mais na seção Propriedades Dinâmicas de EndPoint. Uma linha vazia será exibida.
-
Digite a propriedade que deseja definir na coluna Propriedade.
-
Digite "falso" na coluna valor.
-
Repita as etapas de 6 a 8 para cada propriedade que deseja definir.
-
Clique em Ativar para salvar e ativas as alterações.