Medidas iniciales y eventos de dispositivo
Los datos de consumo y eventos exportados del sistema de recopilación de datos de infraestructura de medición avanzada se cargan en Oracle Utilities como datos iniciales de medida y de eventos de dispositivo. Puede personalizar el procesamiento configurando los siguientes proyectos de OSB de productos base:
-
SGG-DG-CSV-BASE contiene componentes que no se van a cambiar en el sitio de cliente. Implantan funciones específicas del procesamiento de formato CSV como, por ejemplo, la validación y la transformación.
-
SGG-DG-CSV-CM permite la personalización y simplifica las actualizaciones futuras.
-
SGG-DG-XML-BASE contiene componentes que no se van a cambiar en el sitio de cliente. Implantan funciones específicas del procesamiento de formato de carga de datos iniciales de medida y eventos como, por ejemplo, la validación y la transformación.
-
SGG-DG-XML-CM permite la personalización y simplifica las actualizaciones futuras.
Los valores de configuración en tiempo de ejecución para el proyecto SGG-DG-CSV-CM se almacenan en el fichero EnvironmentSettings.xq de XQuery. Puede utilizar este fichero para ajustar el procesamiento de datos iniciales de medida y de eventos 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 SGG-DG-CSV-CM EnvironmentSettings.xq:
Elemento |
Descripción |
Valores válidos |
---|---|---|
populateRaw |
Determina si los datos iniciales de medida 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 |
destinationRootElementEvent |
Contiene el nombre del servicio web entrante para la predefinición de evento de dispositivo. |
|
destinationRootElementIMD |
Contiene el nombre del servicio web entrante para la predefinición de datos iniciales de medida. |
Los valores de configuración en tiempo de ejecución para el proyecto SGG-DG-XML-CM se almacenan en el fichero EnvironmentSettings.xq de XQuery. Puede utilizar este fichero para ajustar el procesamiento de datos iniciales de medida y de eventos 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 SGG-DG-XML-CM EnvironmentSettings.xq:
Elemento |
Descripción |
Valores válidos |
---|---|---|
populateRawIMD |
Determina si los datos iniciales de medida 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 datos iniciales de medida. |
Para obtener información adicional sobre la implantación OSB de muestra incluida en Adapter Development Kit de Oracle Utilities Smart Grid Gateway, consulte Procesamiento de Oracle Service Bus.
Procesamiento de ficheros de entrada grandes
En algunos entornos, el proyecto de OSB puede empezar a procesar un fichero de entrada grande antes de que se haya copiado por completo en el directorio de entrada. Para evitarlo, configure la propiedad MinimumAge en el servicio proxy “InboundProxyService” para los proyectos SGG-DG-CSV-CM y SGG-DG-XML-CM. La propiedad MinimumAge especifica la antigüedad mínima de los ficheros que se van a recuperar, en función del registro horario de la última modificación. Esto permite que los ficheros grandes se copien por completo en el directorio de entrada antes de que se recuperen para su procesamiento.
Procesamiento de datos en el formato nativo de Adapter Development Kit
Los datos de consumo y eventos exportados del sistema de recopilación de datos de infraestructura de medición avanzada se pueden cargar en Oracle Utilities en los formatos “nativos” de datos iniciales de medida y eventos de dispositivo (el formato de los objetos de negocio de predefinición de medidas iniciales y eventos de dispositivo). Puede personalizar el procesamiento configurando los siguientes proyectos de OSB de productos base:
-
SGG-DG-SEEDER-BASE contiene componentes que no se van a cambiar en el sitio de cliente. Implantan funciones específicas del procesamiento de formato de carga de datos iniciales de medida y eventos como, por ejemplo, la validación y la transformación.
-
SGG-DG-SEEDER-CM permite la personalización y simplifica las actualizaciones futuras.
Los valores de configuración en tiempo de ejecución para el proyecto SGG-DG-SEEDER-CM se almacenan en el fichero EnvironmentSettings.xq de XQuery. Puede utilizar este fichero para ajustar el procesamiento de datos iniciales de medida y de eventos 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 SGG-DG-SEEDER-CM EnvironmentSettings.xq:
Elemento |
Descripción |
Valores válidos |
---|---|---|
callPreProcessing |
Determina si se llama al servicio proxy de preprocesamiento. |
true false |
callPostProcessing |
Determina si se llama al servicio proxy de posprocesamiento. |
true false |
destinationRootElementInterval |
Contiene el nombre del servicio web entrante para la predefinición de datos iniciales de medida de intervalo. |
|
destinationRootElementScalar |
Contiene el nombre del servicio web entrante para la predefinición de datos iniciales de medida escalares. En la mayoría de los casos, es el mismo que destinationRootElementInterval. |
|
destinationRootElementEvent |
Contiene el nombre del servicio web entrante para la predefinición de evento de dispositivo. |
|
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 |
filterUsage |
Determina si se debe filtrar el consumo. |
true false |
Consulte Formato nativo de Adapter Development Kit para obtener más información sobre el formato “nativo” de ADK.
Publicación de datos iniciales de medida y eventos de dispositivo
Adapter Development Kit se puede configurar con el fin de publicar datos iniciales de medida y 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 datos
<publishServices>
<service>[publisherBusinessService]</service>
</publishServices>
Los siguientes componentes suministrados con el proyecto SGG-DG-SEEDER-CM de OSB se utilizan en la publicación de datos de medidas y 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
El compuesto de BPEL SGGDRIntegration gestiona la publicación de los datos en Oracle DataRaker o en otros sistemas.
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 datos iniciales de medida
<filterUsage>true</filterUsage>
Cuando el filtrado está activado, solo se transfieren al sistema para su procesamiento las medidas cuya <externalUOM> coincide con uno de los valores definidos en la lista de valores ampliable de ADK - Asignación de código de UM a UM estándar (DG-HeadendUOMLookup).
Filtrado de eventos
<filterEvents>true</filterEvents>
Cuando el filtrado está activado, solo se transfieren al sistema para su procesamiento los eventos de dispositivo cuyo <externalEventName> coincide con uno de los valores definidos en la lista de valores ampliable ADK - Asignación de evento de dispositivo (DG-DeviceEventMappingLookup).
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-D3-CIM-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.