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
ConnectLoadRemoteConnectRecebe 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.
GrabBatchEventsRecupera 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
GrabBatchUsageRecupera 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
MeterDecommissioningRecebe 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
PerformCommandEsse 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.
ReceivePanoramixEventsEsse 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 / PostPerformCommandCalloutEsses 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.
ReceivedPanoramixEventsCalloutEsse 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.
ReadBillingDataOnDemandEsse 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
ReadLoadProfileOnDemandEsse 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
ReadLoadStatusRemoteConnectRecebe 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.
RemoteDisconnectRecebe 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.
RetrieveMeterInfoInicia 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
RetrieveMeterIdentifierRecebe 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
SetATMConfigurationEsse 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) |