Processos BPEL e Serviços da Web

Esses processos são responsáveis por executar a conversão do formato do Oracle Utilities para o formato NES, chamando os callouts de processos e chamando o ponto de extremidade remoto para acionar os eventos do dispositivo.

Todos os serviços da Web recebem XML de um serviço de entrada e, em seguida, transformam a chamada para um formato reconhecido pelo sistema NES.

CreateMeter: Recebe o XML de entrada do serviço de envio de mensagens, transforma-o no nó de parâmetros de APIs do NES, passa-o para o método de serviço da Web de APIs do NES DeviceManager.Create e coleta XML de CreateMeter para ser retornado para o Oracle Utilities Smart Grid Gateway.

Mensagens

CreateMeter RequestMessage: Contém os parâmetros que são formatados do Oracle Utilities Smart Grid Gateway para corresponder ao XML de entrada do método DeviceManager.Create de APIs do NES.

CreateMeter ResponseMessage: Contém o ID de Dispositivo que é usado quando o método DeviceManager.Create valida a chave de segurança e os parâmetros XML com sucesso.

Processos Relacionados

Ativação do Medidor

ConnectLoadRemoteConnect

Recebe o XML de entrada do remetente de mensagem D4-CONLOAD (Carga de Conexão) no Oracle Utilities Smart Grid Gateway e transforma no formato do NES.

GrabBatchEvents

Recupera os eventos não processados do repositório de eventos; transforma cada batch para substituir identificadores de GUI por um formulário legível e finalmente prepara um novo arquivo para OSB, antes de excluir o batch de eventos. A chamada programada para esse serviço pode conter as datas preferidas para as quais consultar ou pode aceitar o padrão, que é o uso do dia anterior.

Mensagens

GrabBatchEventsSoapIn

GrabBatchEventsSoapOut

GrabBatchUsage

Recupera o uso não processado do repositório de uso; transforma cada batch para substituir identificadores de GUI por um formulário legível e finalmente prepara um novo arquivo para OSB, antes de excluir o batch de uso. A chamada programada para esse serviço pode conter as datas preferidas para as quais consultar ou pode aceitar o padrão, que é o uso do dia anterior.

Mensagens

GrabBatchUsageSoapIn

GrabBatchUsageSoapOut

Processos Relacionados

Conexão

Event Management

Processamento de Uso

MeterDecommissioning

Recebe o XML de entrada do serviço senderOutbound e transforma para o nó de parâmetros de APIs do NES para ser passado para o método de serviço da Web de APIs do NES. O processo coleta, em seguida, o XML de retorno para ser devolvido para o Oracle Utilities Smart Grid Gateway.

Mensagens

MeterDecommissioningRequestMessage: Esta mensagem é a entrada para o método Move. O método contém os parâmetros convenientemente formatados do Oracle Utilities Smart Grid Gateway para corresponder ao XML de entrada para o método DeviceManager.Move de APIs do NES.

MeterDecommissioningResponseMessage: Essa mensagem contém status informando que o método DeviceManager.Create validou a chave de segurança e os parâmetros de XML são aceitos com sucesso. Se i status for SUCESSO, também contém o ID de Rastreamento para a chamada, o ID do Dispositivo e o ID do Tipo de Status.

Processos Relacionados

Desativação do Medidor

PerformCommand

Esse serviço da Web facilita a maior parte da comunicação entre o Oracle Utilities Smart Grid Gateway e o sistema NES. Se sua implementação precisar de funcionalidade que não foi entregue como parte do pacote base, esse serviço da Web desempenhará parte integrante no gerenciamento dessas personalizações.

PerformCommand executa um comando que gera os eventos que avançam o ciclo de vida do Oracle Utilities Smart Grid Gateway e depois retorna a string de saída para o chamador. A saída pode ser um ID de rastreamento ou informações sobre um dispositivo.

Mensagens

PerformCommandSoapIn: A entrada sXmlParameters é preparada de dentro do Oracle Utilities Smart Grid Gateway para executar principalmente um grupo de cinco comandos, que são Ler Status da Carga, Leitura Sob Demanda, Carga de Conexão, Carga de Desconexão e Definir Configuração de ATM.

PerformCommandSoapOut:

O retorno de PerformCommand é o XML do DeviceManager.PerformCommand para Ler Status da Carga, Leitura Sob Demanda, Carga de Conexão, Carga de Desconexão e Definir Configuração de ATM.

ReceivePanoramixEvents

Esse serviço da Web não é, realmente, nunca chamado pela implementação, mas sim, é chamado pelo NES e é necessário ao configurar o servidor do NES.

ReceivePanoramixEvents obtém a APIKey do serviço de autenticação do NES e, então, com o ID de definição do evento da lista de parâmetros desse serviço, altera para a agência para a definição do evento começar qualquer processamento específico. Por exemplo, um evento de conclusão de leitura sob demanda significa que o processo de PM de BPEL precisa recuperar o uso usando o RESULTID encontrado no XML do evento. Todos os eventos e uso a serem passados para o Oracle Utilities Smart Grid Gateway devem, primeiro, ser transformados para substituir o GUID por itens de formulário legíveis. Isso envolve usar a funcionalidade de pesquisa DVM do PM do BPEL.

Mensagens

ReceivePanoramixEventsSoapIn

ReceivePanoramixEventsSoapOut

Processos Relacionados

Event Management

PrePerformCommandCallout / PostPerformCommandCallout

Esses serviços da Web são ganchos criados para permitir a personalização de mensagens pouco antes e pouco depois de enviá-las para o servidor do NES. Sua implementação pode querer modificar os dados para finalidades especiais. Esse é o único lugar em que a modificação do código de PM do BPEL é permitida.

ReceivedPanoramixEventsCallout

Esse serviço da Web é um gancho criado para permitir a personalização de mensagens pouco antes e pouco depois de enviá-las para o servidor do NES. Sua implementação pode querer modificar os dados para finalidades especiais. Esse é o único lugar em que a modificação do código de PM do BPEL é permitida.

ReadBillingDataOnDemand

Esse método de serviço da Web inicia uma chamada para o sistema NES com parâmetro de XML de entrada formatado. Primeiro, ele transforma os Parâmetros recebidos do sistema de chamada no formato reconhecível pelo sistema NES. Em seguida, ele faz uma chamada para o Device Manager Service do sistema NES. Quando a chamada é invocada, o sistema recebe o XML de retorno do DeviceManager afirmando o status da execução do comando e, se tiver sucesso, o ID de rastreamento dessa chamada.

Mensagens

ReadBillingDataOnDemandRequestMessage: Contém o parâmetro de entrada para o DeviceManager Executar o Comando para ler os dados de faturamento Sob Demanda. Ele formata os parâmetros do sistema de chamada para corresponder ao XML de entrada para o método DeviceManager.PerfomCommand do NES.

ReadBillingDataOnDemandResponseMessage: Transforma o XML de resposta do formato do sistema NES para o formato do Oracle Utilities Smart Grid Gateway.

Processos Relacionados

Leituras Sob Demanda

ReadLoadProfileOnDemand

Esse método de serviço da Web inicia uma chamada para o Device Manager Service do sistema NES com parâmetro de XML de entrada formatado. Primeiro, ele transforma os Parâmetros recebidos do sistema de chamada no formato reconhecível pelo sistema NES. Em seguida, ele faz uma chamada para o sistema NES por meio do Device Manager Service. Depois de fazer a chamada, o sistema recebe a mensagem de resposta do DeviceManager afirmando o status da execução do comando e, se bem-sucedido, o ID de rastreamento dessa chamada.

Mensagens

ReadLoadProfileOnDemandRequestMessage: Essa mensagem é para solicitação de leitura sob demanda de intervalo para o sistema NES. Transforma o XML de entrada do formato do Oracle Utilities Smart Grid Gateway para o formato reconhecível pelo NES.

ReadLoadProfileOnDemandResponseMessage: Transforma o XML de resposta para ReadLoadProfileOnDemandRequest do formato do sistema NES para o formato do Oracle Utilities Smart Grid Gateway.

Processos Relacionados

Leituras Sob Demanda

ReadLoadStatusRemoteConnect

Recebe o XML de entrada do remetente de mensagem D4-RDLOADST (Ler Status da Carga) no Oracle Utilities Smart Grid Gateway e transforma no formato do NES.

RemoteDisconnect

Recebe o XML de entrada do remetente de mensagem D4-DISCONLD (Carga de Desconexão) no Oracle Utilities Smart Grid Gateway e transforma no formato do NES.

RetrieveMeterInfo

Inicia uma chamada para o Request Management Service com parâmetros XML de entrada formatados. Primeiro, ele transforma os Parâmetros recebidos do sistema de chamada no formato reconhecível pelo sistema NES. Em seguida, ele faz uma chamada para o sistema NES pelo Request Management Service e recupera uma resposta com Informações do Medidor.

Mensagens

RetrieveMeterInformationRequestMessage: Contém o parâmetro de entrada para o DeviceManager Executar Comando para recuperar informações do medidor. Ele também formata os parâmetros do sistema de chamada para corresponder ao XML de entrada para o método DeviceManager.PerfomCommand do NES.

RetrieveMeterInformationResponseMessage: Transforma o XML de resposta do formato do sistema NES para o formato do Oracle Utilities Smart Grid Gateway.

Processos Relacionados

Desconexão Remota

Conexão Remota

RetrieveMeterIdentifier

Recebe uma chamada do Oracle Utilities Smart Grid Gateway para o processo RetrieveMeterIdentifier e chama o método RetrieveByParameter no DeviceManager Service do sistema NES.

Converte a entrada formatada do Oracle Utilities Smart Grid Gateway de entrada para sXmlParameters no formato NES e, depois chama o RetrieveMeterIdentifier.

Mensagens

RetrieveMeterIdentifierRequestMessage: Transforma o XML recebido do sistema de chamada para corresponder ao XML de entrada para o método DeviceManager.RetrieveByParameter de APIs do NES. Esse método requer o Tipo de ID e o ID associado como entrada.

RetrieveMeterIdentifierResponseMessage: Quando o XML é retornado de forma síncrona do sistema Head-End para a chamada RetrieveByParameter, o nó DEVICEID só é incluído no APIPAYLOAD se o status da chamada for Bem-Sucedida.

Processos Relacionados

Ativação do Medidor

SetATMConfiguration

Esse método de serviço da Web é específico para definir o comando de configuração de Gerenciamento de Topologia Automático (ATM), que atribui o Medidor ao Concentrador de Dados.

Converte a entrada formatada do Oracle Utilities Smart Grid Gateway de entrada para sXmlParameters no formato NES e, depois chama o DeviceManager PerformCommand. Uma conexão deve ser estabelecida para começar o processamento de comando do NES.

Mensagens

SetATMConfigurationRequestMessage: Essa mensagem é a entrada para o método SetATMConfiguration. O método contém os parâmetros convenientemente formatados do Oracle Utilities Smart Grid Gateway para corresponder ao XML de entrada para o método DeviceManager.PerformCommand de APIs do NES em que COMMANID é Constants.DeviceCommands.SET_ATM_CONFIGURATION

SetATMConfigurationResponseMessage: Quando o XML é retornado de forma síncrona do sistema Head-End para a chamada PerformCommand, o nó COMMAND só é incluído no APIPAYLOAD se o status da chamada for Bem-Sucedida.

Processos Relacionados

Ativação do Medidor

Serviços da Web do NES

A tabela a seguir descreve os serviços da Web do NES e as operações usadas para as mensagens de comando do Oracle Utilities Smart Grid Gateway:

Comandos do Smart Grid Gateway

Objetos de Negócios do Adaptador do AMI

Serviços da Web do NES

Operações do NES

Ativação do Dispositivo

D4-AddMeterRequest

D4-RetrieveMeterIdentifier

D4-SetATMConfiguration

DeviceManager

Create

RetrieveByParameter

PerformCommand:

SET_​ATM_​CONFIGURATION

Desativação do Dispositivo

D4-DecommMeterRequest

DeviceManager

PerformCommand:

MOVE_​DEVICE_​ADD

Conexão Remota

D4-ConnectLoad

D4-ReadLoadStatus

D4-RetrieveMeterInfo

DeviceManager

Retrieve

PerformCommand:

CONNECT_​LOAD

READ_​LOAD_​STATUS

Desconexão Remota

D4-DisconnectLoad

DeviceManager

PerformCommand:

DISCONNECT_​LOAD

Leitura Sob Demanda

D4-ReadBillingData

DeviceManager

PerformCommand

Command ID:

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

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