Eventos de dispositivo

Publicación de eventos

Se puede configurar Smart Grid Gateway para publicar eventos de dispositivo para su uso en Oracle DataRaker o en otros sistemas externos. Esta funcionalidad se soporta mediante una combinación de componentes de OSB y compuestos de BPEL.

Activación de la publicación de eventos de dispositivo

<publishServices>
  <service>[publisherBusinessService]</service>
</publishServices>

Los siguientes componentes suministrados con el proyecto SGG-D3-EVENT-CM de OSB se utilizan en la publicación de datos de eventos de dispositivo en Oracle DataRaker:

• El servicio de negocio DataRakerBusinessService se utiliza para enviar datos a una cola de JMS preconfigurada (definida como una URI de punto final), desde la que se publicarán los datos. Es el servicio de negocio que se debe especificar en el fichero EnvironmentSettings.xq.

• La cuenta de servicio DataRakerServiceAccount se utiliza para definir y mantener el nombre de usuario y la contraseña necesarios para acceder a la cola de JMS definida en el servicio de negocio DataRakerBusinessService.

Configuración de la salida de publicación de evento de dispositivo

El compuesto de BPEL SGGDRIntegration gestiona la publicación de los datos en Oracle DataRaker o en otros sistemas. Los datos de eventos de dispositivo se publican en el formato de datos de eventos de dispositivo “nativo” (el formato del objeto de negocio de predefinición de evento de dispositivo). Este formato incluye códigos de eventos de dispositivo normalizados. Consulte la guía del usuario administrativo Oracle Utilities Smart Grid Gateway Adapter Development Kit para obtener más información sobre este formato.

Los parámetros siguientes se pueden utilizar para configurar detalles sobre cómo se proporcionan los datos a Oracle DataRaker, incluido el directorio donde se publican los ficheros para consumo de Oracle DataRaker, el número de registros por fichero, la frecuencia de búsqueda, etcétera. Estos parámetros se definen durante la instalación. Consulte la guía de instalación Oracle Utilities Smart Grid Gateway Installation Guide para obtener más información sobre la definición de valores para estos parámetros.

Filtrado de eventos

<filterEvents>true</filterEvents>

Cuando el filtrado está activado, solo los eventos de dispositivo cuyo <externalEventName> coincide con uno de los valores definidos en la lista de valores ampliable Asignación de evento de dispositivo de Landis+Gyr (D3-DeviceEventMappingLookup) se transfieren al sistema para su procesamiento.

Suscripción a eventos de dispositivo en tiempo real

El centro de comandos de Landis+Gyr permite "suscribirse" a eventos de dispositivo desde su interfaz en línea. Para ello hay que crear un suscriptor en el centro de comandos con una URL de rellamada asociada, así como una lista de tipos de eventos que el usuario está interesado en recibir. Cuando ocurre un evento al que está suscrito, este se envía a la URL de rellamada en tiempo real.

En L+G los eventos se configuran con uno de tres valores de "alarma". Estos valores determinan la frecuencia con que se enviarán los eventos a los suscriptores:

1. Alarma: se entregan inmediatamente desde el contador

2. Aviso: se envían en función de un programa de entrega

3. Solo log: solo se envían a petición (no aplicable para nuestro procesamiento de eventos de implantación en tiempo real)

El centro de comandos comunicará los eventos usando el formato CIM que describe el mensaje como una combinación de nombre/verbo. Los detalles del propio evento se incluirán en un elemento de "carga útil" de la estructura estándar. La carga útil se formateará usando la estructura de mensaje EndDeviceEvent. Este mensaje identifica eventos de dispositivo mediante un número de categoría de 4 partes de CIM. Estos números son números separados en cuatro partes que describirán el tipo de dispositivo y el evento. Por ejemplo: 3.33.1.257 es para "sospecha de intento de manipulación".

• Segmento 1: código de dominio de evento de dispositivo final (por ejemplo, 3. contador/10. recopilador/11. enrutador/12. dispositivo de red de área doméstica)

• Segmento 2: códigos de piezas de dominio de evento de dispositivo final (por ejemplo, 1. Acceso/2. Batería)

• Segmento 3: códigos de tipo de evento de dispositivo final (por ejemplo, 1. Alarma/2. Gestión de alarmas)

• Segmento 4: índice de eventos de dispositivo final (por ejemplo, 1. Abortar/2. Intento de acceso)

Consulte la documentación de Landis+Gyr para obtener más información sobre los números de categoría CIM. Los números de categoría CIM se deben asignar a nombres de eventos de dispositivo estándar mediante la lista de valores ampliable Asignación de evento de dispositivo de Landis+Gyr.

Smart Grid Gateway recibe estos mensajes a través de un compuesto de BPEL que guarda la solicitud entrante como un fichero que seleccionará OSB.

El compuesto AMIEventSubscriber es responsable de recibir los mensajes de eventos en función de las suscripciones definidas en el centro de comandos de L+G. La URL de rellamada configurada para la suscripción en el centro de comandos debe señalar a este compuesto de BPEL.

Los siguientes proyectos de OSB analizan eventos de dispositivos individuales del mensaje y realizan la validación y la asignación de la información al formato de predefinición de eventos de dispositivo.

1. SGG-D3-CIM-EVENT-BASE contiene componentes responsables del procesamiento "real" de los datos entrantes. Podrá actualizarse en el futuro sin que afecte a la configuración de personalización y entorno que se ha realizado en el proyecto SGG-D3-CIM-EVENT-CM.

2. SGG-D3-CIM-EVENT-CM permite la personalización y simplifica las actualizaciones futuras.

Los valores de configuración en tiempo de ejecución para el proyecto SGG-D3-CIM-EVENT-CM se almacenan en el fichero EnvironmentSettings.xq de XQuery. Puede utilizar este fichero para ajustar el procesamiento de datos de evento de dispositivo. Por ejemplo, si desea cargar datos sin procesar, debe especificar “verdadero” para el contenido del elemento populateRaw.

En la tabla siguiente se describen los elementos incluidos en el fichero EnvironmentSettings.xq:

Se recopilan estadísticas de procesamiento para cualquier evento en tiempo real que se recibe, aunque solo haya un evento en el mensaje, del mismo modo que los eventos de dispositivo recibidos por medio de la interfaz de fichero plano.

Procesamiento de eventos de dispositivo con prioridad

El adaptador de Smart Grid Gateway da prioridad al procesamiento de eventos de dispositivo creados a partir de comandos de contador inteligente y/o eventos de finalización, mediante la definición del indicador Método de ejecución en estos tipos de eventos de dispositivo como “Tiempo real” (D1RT). Además, los eventos de dispositivo recibidos con el indicador Método de ejecución definido como “Tiempo real” se procesarán en tiempo real, y no mediante el procesamiento por lotes. Consulte Priorización de eventos de dispositivo en la guía del usuario de negocio Oracle Utilities Meter Data Management / Smart Grid Gateway Business User Guide para obtener más información.

Configuración de notificaciones de procesamiento de carga útil

Por defecto, las actividades de notificación Estadísticas de carga útil, Notificación de error de carga útil y Resumen de carga útil se envían a la cola de notificaciones en Oracle Service Bus. Los adaptadores de Smart Grid Gateway se pueden configurar para restringir el envío de estas actividades definiendo propiedades dinámicas de transporte de JCA opcionales en el proyecto de OSB adecuado. Se pueden utilizar las siguientes propiedades dinámicas de transporte de JCA opcionales para controlar si se envían estas actividades de notificación:

• SGG_​SEND_​STATISTICS: controla el envío de actividades de estadísticas de carga útil (verdadero: enviar, falso: no enviar)
• SGG_​SEND_​ERROR: controla el envío de actividades de notificación de error de carga útil (verdadero: enviar, falso: no enviar)
• SGG_​SEND_​SUMMARY: controla el envío de actividades de resumen de carga útil (verdadero: enviar, falso: no enviar)

Cuando estas propiedades se definen como falsas, no se enviará la correspondiente notificación de carga útil a la cola de JMS. Tenga en cuenta que estas propiedades no se rellenan por defecto, y se definen como verdadero si se omiten.

Para crear estas propiedades:

1. Acceda al proyecto SGG-D3-CIM-EVENT-CM en la consola de Oracle Service Bus.

2. Amplíe la carpeta Servicios de Proxy.

3. Seleccione el servicio proxy InboundProxyService (no el pipeline ni WSDL).

4. Haga clic en Crear para crear una nueva sesión.

5. Seleccione Detalles de transporte.

6. Haga clic en el signo de suma de la sección Propiedades Dinámicas de Punto Final. Aparecerá una fila vacía.

7. Introduzca la propiedad que desea definir en la columna Propiedad.

8. Introduzca "falso" en la columna Valor.

9. Repita los pasos del 6 al 8 por cada propiedad que desea definir.

10. Haga clic en Activar para guardar y activar los cambios.