Mapeando Campos Adicionais
Arquivos de medições e de eventos de dispositivos recebidos do sistema Head-End do Landis+Gyr podem incluir campos adicionais contendo dados a serem importados para o Oracle Utilities Smart Grid Gateway. Esses campos adicionais devem ser mapeados para elementos dentro do documento XML processado pelo OSB e enviado para o Smart Grid Gateway.
Esse mapeamento pode ser realizado pelo uso de um documento XQuery personalizado, especificado no arquivo EnvironmentSettings.xq por meio do parâmetro "modifyResultXMLInput".
Os documentos XQuery de exemplo a seguir ilustram como os campos adicionais podem ser mapeados para o formato XML enviado para o Smart Grid Gateway.
XQuery de Amostra — Medições Iniciais
O XQuery a seguir é um exemplo que mostra uma transformação que passa em um elemento raiz com 3 derivados (o XML de "resultado". o XML "simples", as configurações do ambiente) que retorna um XML de "resultado" modificado para finalidades de teste, altera o valor original no elemento de "resultado" <enQty>
e o substitui por um valor do XML "simples", dependendo da variável de configuração do ambiente. O valor <serviceProviderExternalId>
também foi substituído por um valor de código fixo.
declare namespace lan = "http://xmlns.oracle.com/LandisGyrUsage";
declare namespace xf = "http://tempuri.org/D3/lgimd";
declare namespace soap = "http://schemas.xmlsoap.org/soap/envelope/";
declare function xf:modifyResultXML($modifyResultXMLInput as element(*)) as element(*){
<InitialLoadIMDList>
{
for $InitLoadIMD in $ modifyResultXMLInput/InitialLoadIMDList/InitialLoadIMD
return
<InitialLoadIMD>
<preVEE>
<dvcIdN>{ data($InitLoadIMD/preVEE/dvcIdN) }</dvcIdN>
<externalId>{ data($InitLoadIMD/preVEE/externalId)}</externalId>
<uom>{ data($InitLoadIMD/preVEE/uom)}</uom>
<mcIdN>{ data($InitLoadIMD/preVEE/mcIdN)}</mcIdN>
<enDt>{ data($InitLoadIMD/preVEE/enDt)}</enDt>
{
if ($modifyResultXMLInput/EnvironmentSettings/test1="true")
then <enQty>{ data($modifyResultXMLInput/lan:MeterReads/lan:MeterRead/lan:ExtraFields/lan:ExtraField[lan:FieldName
= 'EF4']/lan:FieldValue) }</enQty>
else <enQty>{ data($modifyResultXMLInput/lan:MeterReads/lan:MeterRead/lan:ExtraFields/lan:ExtraField[lan:FieldName= 'EF2']/lan:FieldValue) }</enQty>
}
<imdType>{ data($InitLoadIMD/preVEE/imdType) }</imdType>
</preVEE>
<serviceProviderExternalId>NewSPId</serviceProviderExternalId>
</InitialLoadIMD>}</InitialLoadIMDList>
};
declare variable $modifyResultXMLInput as element(*)external;
xf:modifyResultXML($modifyResultXMLInput)
XQuery de Amostra — Eventos de Dispositivos
O XQuery a seguir é um exemplo que mostra uma transformação que passa em um elemento raiz com 3 derivados (o XML de "resultado". o XML "simples" e as configurações do ambiente) e retorna um XML de "resultado" modificado para finalidades de teste, altera o valor original no elemento de "resultado" <externalCommunicationModuleIdentifier>
e o substitui por um valor do XML "simples", dependendo da variável de configuração do ambiente. O valor <externalServiceLocationId>
também foi substituído por um valor de código fixo.
declare namespace lan = "http://xmlns.oracle.com/LandisGyrEvent";
declare namespace xf = "http://tempuri.org/D3/event";
declare namespace soap = "http://schemas.xmlsoap.org/soap/envelope/";
declare function xf:modifyResultXML($modifyResultXMLInput as element(*)) as element(*){
<DeviceEventSeeder>
<externalSenderId>{data($modifyResultXMLInput/DeviceEventSeeder/externalSenderId) }</externalSenderId>
<deviceIdentifierNumber>{ data($modifyResultXMLInput/DeviceEventSeeder/deviceIdentifierNumber) }</deviceIdentifierNumber>
<externalEventName>{ data($modifyResultXMLInput/DeviceEventSeeder/externalEventName) }</externalEventName>
<eventDateTime>{ data($modifyResultXMLInput/DeviceEventSeeder/eventDateTime) }</eventDateTime>
<externalSourceIdentifier>{ data($modifyResultXMLInput/DeviceEventSeeder/externalSourceIdentifier)
}</externalSourceIdentifier>
<eventInformation>
<externalEventCategory>{data($modifyResultXMLInput/DeviceEventSeeder/eventInformation/externalEventCategory)
}</externalEventCategory>
<externalEventSeverity>{data($modifyResultXMLInput/DeviceEventSeeder/eventInformation/externalEventSeverity)
}</externalEventSeverity>
<externalDeviceType>{data($modifyResultXMLInput/DeviceEventSeeder/eventInformation/externalDeviceType)
}</externalDeviceType>
<externalServiceLocationId>{1234 }</externalServiceLocationId>
{
if ($modifyResultXMLInput/EnvironmentSettings/testA="true")
then <externalCommunicationModuleIdentifier>{ data($modifyResultXMLInput/lan:DeviceEvents/lan:DeviceEvent/lan:DeviceType)}</externalCommunicationModuleIdentifier>
else <externalCommunicationModuleIdentifier>{data($modifyResultXMLInput/lan:DeviceEvents/lan:DeviceEvent/lan:CategoryId)}</externalCommunicationModuleIdentifier>
}
<externalStatusValue>{data($modifyResultXMLInput/DeviceEventSeeder/eventInformation/externalStatusValue)
}</externalStatusValue>
<externalStatusDateTime>{data($modifyResultXMLInput/DeviceEventSeeder/eventInformation/externalStatusDateTime)}</externalStatusDateTime>
</eventInformation>
</DeviceEventSeeder>
};
declare variable $modifyResultXMLInput as element(*) external;
xf:modifyResultXML($modifyResultXMLInput)