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
ConnectLoadRemoteConnectRecibe 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.
GrabBatchEventsRecupera 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
GrabBatchUsageRecupera 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
MeterDecommissioningRecibe 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
PerformCommandEste 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.
ReceivePanoramixEventsEn 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 / PostPerformCommandCalloutEstos 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.
ReceivedPanoramixEventsCalloutEste 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.
ReadBillingDataOnDemandEste 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
ReadLoadProfileOnDemandEste 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
ReadLoadStatusRemoteConnectRecibe 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.
RemoteDisconnectRecibe 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.
RetrieveMeterInfoInicia 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
RetrieveMeterIdentifierRecibe 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
SetATMConfigurationEste 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) |