Procesos de BPEL y servicios web

Estos procesos son responsables de realizar la conversión del formato de Oracle Utilities al formato de NES, realizando llamadas de proceso y llamando al punto final remoto para disparar los eventos de dispositivo.

Todos los servicios web reciben XML procedente de un servicio entrante y, a continuación, transforman la llamada en un formato que es reconocido por el sistema NES.

CreateMeter: recibe el XML entrante procedente del servicio emisor del mensaje, lo transforma en el nodo de parámetros de API de NES, lo transfiere al método de servicio web de API de NES DeviceManager.Create y después recopila XML que procede de CreateMeter, para su devolución a Oracle Utilities Smart Grid Gateway.

Mensajes

CreateMeter RequestMessage: contiene los parámetros a los que se da formato desde Oracle Utilities Smart Grid Gateway para que coincidan con el XML entrante para el método DeviceManager.Create de API de NES.

CreateMeter ResponseMessage: contiene el ID de dispositivo que se utiliza cuando el método DeviceManager.Create valida la clave de seguridad y los parámetros de XML correctamente.

Procesos relacionados

Establecimiento de comunicación con contador

ConnectLoadRemoteConnect

Recibe el XML entrante que procede del remitente de mensaje D4-CONLOAD (Conexión de carga) de Oracle Utilities Smart Grid Gateway y lo transforma al formato de NES.

GrabBatchEvents

Recupera los eventos no procesados del repositorio de eventos, transforma cada lote para sustituir los identificadores GUID por un formato de lectura y, por último, prepara un nuevo fichero para OSB antes de suprimir el lote de eventos. La llamada programada a este servicio puede contener las fechas preferidas para consultar o puede aceptar el valor por defecto que es el consumo del día anterior.

Mensajes

GrabBatchEventsSoapIn

GrabBatchEventsSoapOut

GrabBatchUsage

Recupera el consumo no procesado del repositorio de consumo, transforma cada lote para sustituir los identificadores GUID por un formato de lectura y, por último, prepara un nuevo fichero para OSB antes de suprimir el lote de consumo. La llamada programada a este servicio puede contener las fechas preferidas para consultar o puede aceptar el valor por defecto que es el consumo del día anterior.

Mensajes

GrabBatchUsageSoapIn

GrabBatchUsageSoapOut

Procesos relacionados

Conexión

Gestión de eventos

Procesamiento de consumo

MeterDecommissioning

Recibe el XML entrante que procede del servicio senderOutbound de mensaje y lo transforma en el nodo de parámetros de API de NES para transferirlo al método de servicio de API de NES DeviceManager.Move. A continuación, el proceso recopila el XML que se va a devolver a Oracle Utilities Smart Grid Gateway.

Mensajes

MeterDecommissioningRequestMessage: este mensaje es la entrada para el método Move. El método contiene los parámetros a los que se da formato convenientemente desde Oracle Utilities Smart Grid Gateway para que coincidan con el XML entrante para el método DeviceManager.Move de API de NES.

MeterDecommissioningResponseMessage: este mensaje contiene el estado que indica que el método DeviceManager.Create ha validado la clave de seguridad y los parámetros de XML se han aceptado correctamente. Si el estado es SUCCEEDED, también contiene el ID de seguimiento para la llamada, el ID de dispositivo y el ID de StatusType.

Procesos relacionados

Interrupción de comunicación con contador

PerformCommand

Este servicio web facilita la mayor parte de la comunicación entre Oracle Utilities Smart Grid Gateway y el sistema NES. Si la implantación necesita funcionalidades que no se han entregado como parte del paquete base, este servicio web desempeñará un papel integral en la gestión de esas personalizaciones.

PerformCommand ejecuta un comando que genera los eventos que avanzan el ciclo de vida de Oracle Utilities Smart Grid Gateway y, a continuación, devuelve la cadena de salida al autor de la llamada. La salida puede ser un ID de seguimiento o información sobre un dispositivo.

Mensajes

PerformCommandSoapIn: la entrada de sXmlParameters se prepara desde Oracle Utilities Smart Grid Gateway para ejecutar principalmente un grupo de cinco comandos, que son Lectura de estado de carga, Lectura bajo demanda, Conexión de carga, Desconexión de carga y Definición de configuración de gestión de topología automatizada.

PerformCommandSoapOut:

La devolución de PerformCommand es el xml de DeviceManager.PerformCommand para Lectura de estado de carga, Lectura bajo demanda, Conexión de carga, Desconexión de carga y Definición de configuración de gestión de topología automatizada.

ReceivePanoramixEvents

En realidad, la implantación nunca llama a este servicio web, sino que NES lo llama y es necesario cuando se configura el servidor de NES.

ReceivePanoramixEvents obtiene la APIKey del servicio de autenticación de NES, a continuación, con el ID de definición de evento de la lista de parámetros para este servicio, cambia a la bifurcación para que la definición de evento empiece cualquier procesamiento específico. Por ejemplo, un evento de finalización de lectura bajo demanda significa que el proceso de BPEL PM tiene que recuperar el consumo usando el RESULTID encontrado en el xml de evento. Todos los eventos y el consumo que se transfieren a Oracle Utilities Smart Grid Gateway se deben transformar primero para sustituir el GUID con elementos de formato de lectura. Esto conlleva el uso de la funcionalidad de lista de valores de asignación de valores de dominio de BPEL PM.

Mensajes

ReceivePanoramixEventsSoapIn

ReceivePanoramixEventsSoapOut

Procesos relacionados

Gestión de eventos

PrePerformCommandCallout / PostPerformCommandCallout

Estos servicios web son enlaces designados para permitir la personalización de mensajes justo antes y justo después de enviarlos al servidor de NES. Su implantación puede querer modificar los datos para fines especiales. Es el único lugar en el que se permite modificar el código PM de BPEL.

ReceivedPanoramixEventsCallout

Este servicio web es un enlace designado para permitir la personalización de mensajes justo antes y justo después de enviarlos al servidor de NES. Su implantación puede querer modificar los datos para fines especiales. Es el único lugar en el que se permite modificar el código PM de BPEL.

ReadBillingDataOnDemand

Este método de servicio web inicia una llamada al sistema NES con el parámetro xml entrante con formato. En primer lugar, transforma los parámetros recibidos del sistema de llamada en formato reconocible por el sistema NES. Después, realiza una llamada al servicio de gestor de dispositivos del sistema NES. Cuando se realiza la llamada, el sistema recibe el XML de devolución de DeviceManager que indica el estado de la ejecución del comando y, si es correcto, el ID de seguimiento de la llamada.

Mensajes

ReadBillingDataOnDemandRequestMessage: contiene el parámetro de entrada para que el comando de ejecución DeviceManager lea datos de facturación bajo demanda. Da formato a parámetros procedentes del sistema de llamada para que coincidan con el XML entrante para el método DeviceManager.PerfomCommand de NES.

ReadBillingDataOnDemandResponseMessage: transforma el xml de respuesta del formato del sistema NES al formato de Oracle Utilities Smart Grid Gateway.

Procesos relacionados

Lecturas bajo demanda

ReadLoadProfileOnDemand

Este método de servicio web inicia una llamada al servicio de gestor de dispositivos del sistema NES con el parámetro xml entrante con formato. En primer lugar, transforma los parámetros recibidos del sistema de llamada en formato reconocible por el sistema NES. Después, realiza una llamada al sistema NES a través del servicio de gestor de dispositivos. Después de realizar la llamada, el sistema recibe el mensaje de respuesta de DeviceManager que indica el estado de la ejecución del comando y, si es correcto, el ID de seguimiento de la llamada.

Mensajes

ReadLoadProfileOnDemandRequestMessage: este mensaje es para la solicitud de lectura bajo demanda de intervalo al sistema NES. Transforma el XML entrante de Oracle Utilities Smart Grid Gateway a un formato reconocible por NES.

ReadLoadProfileOnDemandResponseMessage: transforma el xml de respuesta para ReadLoadProfileOnDemandRequest del formato del sistema NES al formato de Oracle Utilities Smart Grid Gateway.

Procesos relacionados

Lecturas bajo demanda

ReadLoadStatusRemoteConnect

Recibe el XML entrante que procede del remitente de mensaje D4-RDLOADST (Lectura de estado de carga) de Oracle Utilities Smart Grid Gateway y lo transforma al formato NES.

RemoteDisconnect

Recibe el XML entrante que procede del remitente de mensaje D4-DISCONLD (Desconexión de carga) de Oracle Utilities Smart Grid Gateway y lo transforma al formato de NES.

RetrieveMeterInfo

Inicia una llamada al servicio de gestión de solicitudes con parámetros xml entrantes con formato. En primer lugar, transforma los parámetros recibidos del sistema de llamada en formato reconocible por el sistema NES. Después, realiza una llamada al sistema NES a través del servicio de gestión de solicitudes y recupera una respuesta con información de contador.

Mensajes

RetrieveMeterInformationRequestMessage: contiene el parámetro de entrada para que el comando de ejecución DeviceManager recupere información de contador. Además, da formato a parámetros procedentes del sistema de llamada para que coincidan con el XML entrante para el método DeviceManager.PerfomCommand de NES.

RetrieveMeterInformationResponseMessage: transforma el xml de respuesta del formato del sistema NES al formato de Oracle Utilities Smart Grid Gateway.

Procesos relacionados

Desconexión remota

Conexión remota

RetrieveMeterIdentifier

Recibe una llamada desde Oracle Utilities Smart Grid Gateway para el proceso RetrieveMeterIdentifier y llama al método RetrieveByParameter en el servicio DeviceManager del sistema NES.

Convierte la entrada con formato de Oracle Utilities Smart Grid Gateway en sXmlParameters con formato de NES y, a continuación, llama a RetrieveMeterIdentifier.

Mensajes

RetrieveMeterIdentifierRequestMessage: transforma el xml recibido del sistema de llamada para que coincida con el XML entrante para el método DeviceManager.RetrieveByParameter de API de NES. En este método es necesario el tipo de ID y el ID asociado como entradas.

RetrieveMeterIdentifierResponseMessage: cuando se devuelve el XML de forma sincrónica desde el sistema de recopilación de datos para la llamada RetrieveByParameter, el nodo DEVICEID solo se incluye en APIPAYLOAD si el estado de la llamada es Correcto.

Procesos relacionados

Establecimiento de comunicación con contador

SetATMConfiguration

Este método de servicio web es específico para definir el comando de configuración de gestión de topología automatizada que asigna el contador al concentrador de datos.

Convierte la entrada con formato de Oracle Utilities Smart Grid Gateway en sXmlParameters con formato de NES y, a continuación, llama a PerformCommand de DeviceManager. Debe establecerse una conexión para comenzar a procesar el comando de NES.

Mensajes

SetATMConfigurationRequestMessage: este mensaje es la entrada para el método SetATMConfiguration. El método contiene los parámetros a los que se da formato convenientemente desde Oracle Utilities Smart Grid Gateway, con el fin de que coincidan con el XML entrante para el método DeviceManager.PerformCommand de API de NES, donde el COMMANID es Constants.DeviceCommands.SET_​ATM_​CONFIGURATION

SetATMConfigurationResponseMessage: cuando se devuelve el XML de forma sincrónica desde el sistema de recopilación de datos para la llamada PerformCommand, el nodo COMMAND solo se incluye en APIPAYLOAD si el estado de la llamada es Correcto.

Procesos relacionados

Establecimiento de comunicación con contador

Servicios web de NES

En la siguiente tabla se describen los servicios web de NES y las operaciones utilizadas para los mensajes de comandos de Oracle Utilities Smart Grid Gateway:

Comandos de Smart Grid Gateway

Objetos de negocio de adaptador de infraestructura de medición avanzada

Servicios web de NES

Operaciones de NES

Establecimiento de comunicación con dispositivo

D4-AddMeterRequest

D4-RetrieveMeterIdentifier

D4-SetATMConfiguration

DeviceManager

Create

RetrieveByParameter

PerformCommand:

SET_​ATM_​CONFIGURATION

Interrupción de comunicación con dispositivo

D4-DecommMeterRequest

DeviceManager

PerformCommand:

MOVE_​DEVICE_​ADD

Conexión remota

D4-ConnectLoad

D4-ReadLoadStatus

D4-RetrieveMeterInfo

DeviceManager

Retrieve

PerformCommand:

CONNECT_​LOAD

READ_​LOAD_​STATUS

Desconexión remota

D4-DisconnectLoad

DeviceManager

PerformCommand:

DISCONNECT_​LOAD

Lectura bajo demanda

D4-ReadBillingData

DeviceManager

PerformCommand

Command ID:

READ_​BILLING_​DATA_​ON_​DEMAND (Scalar)

READ_​LOAD_​PROFILE_​ON_​DEMAND (Interval)