Eventos do Dispositivo
Os dados do evento do dispositivo exportados do sistema Head-End como um arquivo no formato do NES são carregados no Oracle Utilities como Evento do Dispositivo. Uma das suas tarefas de configuração é personalizar o processamento de eventos do dispositivo.
A funcionalidade obrigatória é fornecida no produto base como dois projetos OSB:
-
O SGG-D4-EVENT-BASE contém componentes responsáveis pelo processamento real de dados de entrada. Não deve ser modificado durante a configuração.
-
O SGG-D4-EVENT-CM permite segmentar suas personalizações para que atualizações futuras de funcionalidade básica implementadas no SGG-D4-EVENT-BASE não afetem as configurações de personalização e do ambiente.
As definições de configuração de tempo de execução para o projeto SGG-D4-EVENT-CM são armazenadas no arquivo XQuery EnvironmentSettings.xq. Você pode usar esse arquivo para ajustar o processamento de dados de eventos do dispositivo. 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:
|
Elemento |
Descrição |
Valores Válidos |
|---|---|---|
|
populateRaw |
Determina se os dados de eventos do dispositivo 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 de eventos do dispositivo. |
|
|
serviceProviderExternalId |
O ID Externo do prestador de serviço do NES. | |
|
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 |
Publicando Eventos
O adaptador do NES pode ser configurado para publicar 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.
Ativando a Publicação de Eventos do Dispositivo
<publishServices>
<service>[publisherBusinessService]</service>
</publishServices>Os componentes a seguir fornecidos com o projeto OSB SGG-D4-EVENT-CM são usados na publicação de dados 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 da Publicação de Eventos do Dispositivo
O composto BPEL SGGDRIntegration lida com a publicação dos dados no Oracle DataRaker ou outros sistemas. Os dados de eventos do dispositivo são publicados no formato de dados de eventos de dispositivo "nativo" (o formato do objeto de negócios do seeder de eventos do dispositivo). Esse formato inclui códigos de eventos de dispositivo normalizados. Consulte o Guia do Usuário Administrativo do Kit de Desenvolvimento do Adaptador Oracle Utilities Smart Grid Gateway para obter mais detalhes sobre esse formato.
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 Eventos
<filterEvents>true</filterEvents>Quando a filtragem está ativada, apenas os eventos do dispositivo cujo <externalEventName> corresponder a um dos valores definidos na busca extensível Mapeamento de Eventos do Dispositivo do NES (D4-DeviceEventMappingLookup) serã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-D4-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.