Eventos de dispositivo

Los datos de evento de dispositivo exportados del sistema de recopilación de datos como un fichero en formato de NES se cargan en Oracle Utilities como un evento de dispositivo. Una de sus tareas de configuración consiste en personalizar el procesamiento de los eventos de dispositivo.

La funcionalidad necesaria se entrega en el producto base como dos proyectos de OSB:

SGG-D4-EVENT-BASE contiene componentes responsables del procesamiento real de los datos entrantes. No se debe modificar durante la configuración.
SGG-D4-EVENT-CM le permite segmentar sus personalizaciones para que las futuras actualizaciones de la funcionalidad base implantada en SGG-D4-EVENT-BASE no afecten a la configuración de personalización y entorno.

Los valores de configuración en tiempo de ejecución para el proyecto SGG-D4-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:


Elemento	Descripción	Valores válidos
populateRaw	Determina si los datos de evento de dispositivo se rellenan como datos sin procesar.	true false
callPreProcessing	Determina si se llama al servicio proxy de preprocesamiento.	true false
callPostProcessing	Determina si se llama al servicio proxy de posprocesamiento.	true false
destinationRootElement	Contiene el nombre del servicio web entrante para la predefinición de evento de dispositivo.
serviceProviderExternalId	ID externo del proveedor de servicios NES.
publishServices/service	Especifica el nombre del servicio de negocio en el proyecto de OSB utilizado para publicar datos para sistemas externos (como, por ejemplo, Oracle DataRaker).
filterEvents	Determina si se deben filtrar los eventos.	true false

Publicación de eventos

Se puede configurar el adaptador de NES 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

La publicación de datos se activa haciendo referencia a un servicio de negocio de publicador del elemento publishServices/service en el fichero EnvironmentSettings.xq como se muestra a continuación:

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

Los siguientes componentes suministrados con el proyecto SGG-D4-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.

Nota: además, no se puede aplicar el filtrado a eventos de dispositivo publicados mediante esta función.

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.


Parámetro	Descripción	Valor por defecto
SGG_DR_INT_QUEUE	Nombre de JNDI de la cola para publicar cargas útiles de Smart Grid Gateway. Es la cola de JMS definida en el servicio de negocio DataRakerBusinessService. No se debe cambiar.	DataRakerQueue
SOA_DR_PUBLISH_SIZE	Número de registros (cargas útiles de Smart Grid Gateway) para acumular en un fichero publicado.	100
SOA_DR_FILE_SIZE	Tamaño máximo de fichero para el fichero acumulado (cargas útiles de Smart Grid Gateway) en kilobytes.	524288
SOA_DR_ELAPSED_TIME	Período de tiempo en segundos que, cuando se supera, hace que se cree un nuevo fichero saliente.	600
SOA_DR_POLLING_FREQ	Frecuencia de búsqueda, en segundos, del directorio temporal para nuevos ficheros.	60
SOA_DR_STAGING_DIR	Punto/directorio de montaje del directorio temporal para ficheros de carga útil de Smart Grid Gateway acumulados. Se usa de modo interno y no se debe cambiar.	/spl/sploutput/staging
SOA_DR_INTEGRATION_DIR	Punto/directorio de montaje desde el que Oracle DataRaker consumirá los ficheros XML convertidos.	/spl/sploutput/int

Filtrado de eventos

El adaptador de Smart Grid Gateway se puede configurar para filtrar datos iniciales de medida transferidos a Smart Grid Gateway y a la aplicación Oracle Utilities Meter Data Management. El filtrado de datos se activa definiendo el elemento <filterUsage> del fichero EnvironmentSettings.xq como “verdadero”, tal y como se muestra a continuación:

<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 NES (D4-DeviceEventMappingLookup) se transfieren al sistema para su procesamiento.

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:

Acceda al proyecto SGG-D4-EVENT-CM en la consola de Oracle Service Bus.
Amplíe la carpeta Servicios de Proxy.
Seleccione el servicio proxy InboundProxyService (no el pipeline ni WSDL).
Haga clic en Crear para crear una nueva sesión.
Seleccione Detalles de transporte.
Haga clic en el signo de suma de la sección Propiedades Dinámicas de Punto Final. Aparecerá una fila vacía.
Introduzca la propiedad que desea definir en la columna Propiedad.
Introduzca "falso" en la columna Valor.
Repita los pasos del 6 al 8 por cada propiedad que desea definir.
Haga clic en Activar para guardar y activar los cambios.

Nota: estas propiedades solo se utilizan si SGG_EXT_ID_PATTERN no está presente o si la expresión regular no captura nada. SGG_EXT_ID_PATTERN sustituirá estas propiedades cuando la expresión regular capture datos de grupo.