Eventos do Dispositivo
O Itron OpenWay pode enviar eventos em tempo real, como alarmes de indisponibilidade de medidor, para o Oracle Utilities Smart Grid Gateway. Esses eventos são chamados de exceções na arquitetura Itron e são enviados para o serviço ExceptionSubscriberService do BPEL pelo Itron OpenWay, sem precisar de uma solicitação explícita do Oracle Utilities Smart Grid Gateway. As exceções são carregadas como dados de eventos de dispositivos e são fornecidas para os aplicativos integráveis.
A funcionalidade obrigatória é fornecida no produto base como dois projetos OSB:
-
O SGG-D8-EXCEPTION-BASE contém os componentes responsáveis pelo processamento "real"de dados de entrada. Não deve ser modificado durante a configuração. Esse projeto pode ser atualizado sem afetar as configurações de personalização e de ambiente adicionadas ao projeto SGG-D8-EXCEPTION-CM.
-
O SGG-D8-EXCEPTION-CM permite a personalização e simplifica as atualizações futuras.
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. |
|
|
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 Itron OpenWay 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-D8-EXCEPTION-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 eventos de dispositivos cujo <externalEventName> corresponde a um dos valores definidos na busca extensível Itron - Mapeamento de Eventos de Dispositivo (D8-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-D8-EXCEPTION-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.