Eventos do Dispositivo

Publicando Eventos

O SGG 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-D3-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.

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 Landis+Gyr (D3-DeviceEventMappingLookup) serão passados para o sistema para processamento.

Inscrevendo-se em Eventos do Dispositivo em Tempo Real

O Landis+Gyr Command Center oferece a capacidade de se "inscrever" para eventos do dispositivo de dentro de sua interface on-line. Isso é feito criando um assinante no Command Center com um URL de chamada de retorno, além de uma lista de tipos de eventos que o assinante está interessado em receber. Quando um evento assinado ocorre, ele é enviado para o URL de chamada de retorno em tempo real.

No L+G , os Eventos são configurados com uma de três configurações de "alarme". Essas configurações determinam a frequência com que os eventos serão enviados para os assinantes:

1. Alarme: fornecido imediatamente do medidor

2. Consultivo: enviado com base em uma programação de entrega

3. Log Apenas: envido apenas mediante solicitação (não aplicável para nosso processamento de eventos em tempo real de implementação)

O Command Center comunicará os eventos usando um formato CIM que descreve a mensagem como comunicação substantivo/verbo. O detalhe do evento, em si, será contido dentro de um elemento "carga útil" da estrutura padrão. A carga útil será formatada usando a estrutura de mensagem EndDeviceEvent. Essa mensagem identifica eventos de dispositivo usando um número de categoria CIM 4-part. Esses números são quatro números separados por pontos que descreverão o tipo de dispositivo e o evento. Por exemplo: 3.33.1.257 é para "Tentativa de interferência suspeita".

• Segmento 1: Encerrar código de domínio de evento do Dispositivo (por exemplo, 3. medidor/10. coletor/11. roteador/12. dispositivo HAN)

• Segmento 2: Códigos de Partes de Domínio de Encerramento de Evento do Dispositivo (por exemplo, 1. Acesso/2. Bateria)

• Segmento 3: Códigos de Tipo de Evento de Dispositivo (por exemplo, 1. Alarme/2. Gerenciamento de Alarme)

• Segmento 4: Índice de Encerramento de Evento de Dispositivo (por exemplo, 1. Cancelar/2. Tentativa de Acesso)

Consulte a documentação do Landis+Gyr para obter detalhes sobre os Números de Categorias do CIM. Os números de Categoria do CIM devem ser mapeados para nomes de eventos de dispositivo padrão usando a busca extensível Mapeamento de Eventos de Dispositivo do Landis+Gyr.

O SGG recebe essas mensagens por meio de um composto do BPEL que salva a solicitação de entrada como um arquivo a ser coletado pelo OSB.

O composto AMIEventSubscriber é responsável pelo recebimento de mensagens do evento, com base em assinaturas definidas no L+G Command Center. O URL de chamada de retorno configurado para a assinatura no Command Center deverá apontar para esse composto do BPEL.

Os seguintes projetos OSB analisam eventos de dispositivos individuais a partir da mensagem e realizam a validação e o mapeamento das informações para o Formato de Seeder de Eventos do Dispositivo.

1. O SGG-D3-EVENT-BASE contém componentes responsáveis pelo processamento "real" de dados de entrada. Pode ser atualizado no futuro sem afetar as configurações de personalização e do ambiente que foram feitas no projeto SGG-D3-CIM-EVENT-CM.

2. O SGG-D3-CIM-EVENT-CM permite a personalização e simplifica atualizações futuras.

As definições de configuração de tempo de execução para o projeto SGG-D3-CIM-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:

Estatísticas de processamento são coletadas de qualquer evento de tempo real recebido (mesmo se houver apenas um evento na mensagem) da mesma maneira que eventos de dispositivos recebidos por meio da interface de arquivo simples.

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.