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:

  1. 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.

  2. SGG-DG-CSV-CM permite la personalización y simplifica las actualizaciones futuras.

  3. 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.

  4. 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:

  1. 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.

  2. 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

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-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 datos iniciales de medida y de evento de dispositivo se publican en el formato de datos iniciales de medida “nativo” (el formato de los objetos de negocio de predefinición de medidas iniciales y eventos de dispositivo). Este formato incluye códigos de unidades de medida, condiciones y 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: los datos iniciales de medida publicados mediante esta función se publican antes del procesamiento de VEE. Además, no se puede aplicar el filtrado a los datos iniciales de medida o de evento 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 datos iniciales de medida

Adapter Development Kit se puede configurar para filtrar datos iniciales de medida transferidos a Oracle Utilities Smart Grid Gateway y 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:
<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

Adapter Development Kit se puede configurar para filtrar eventos de dispositivo transferidos a Oracle Utilities Smart Grid Gateway y Meter Data Management. El filtrado de datos se activa definiendo el elemento <filterEvents> del fichero EnvironmentSettings.xq como “verdadero”, tal y como se muestra a continuación:
<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:

  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.

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.