Domain Value Map Functions in SOA

In this post we will see some of the available DVM functions.

dvm:lookupValue –>

Syntax ##

dvm:lookupValue(mapName, referenceElementName, referenceValue, elementName, defaultValue, needAnException)

Description ##

The dvm:lookupValue function finds the reference element value in a domain value map and returns the equivalent value of the specified element name as a string. This form of DVM lookup is used to find a single reference element and return a single element value.

Example ##

The following code looks up the value of the Short element in the CityCodes DVM map corresponding to the Bangalore value in the Long element:

dvm:lookupValue(“CityCodes”,”Long”,”Bangalore”,”Short”,”NotFound”,True).

dvm:lookupValueNVP –> 

Syntax ##

dvm:lookupValueNVP(mapName, referenceDomain, referenceNVP, targetDomain, defaultNVP, needAnException)

Description ##

The dvm:lookupValueNVP function finds the reference domain element values in a DVM and returns the equivalent values of all elements in the specified domain as an NVP list. This form of DVM lookup should be used when multiple elements exist in either the reference or return domain. All required elements in the reference domain must be included in the reference NVP list, but optional elements (qualifiers perhaps) do not have to be included. The return string will include values for all elements in the target domain as an NVP list regardless of whether they are required.

dvm:lookup-dvm –>

Syntax ##

dvm:lookup-dvm (mapName, referenceElementName, referenceValue, elementName, defaultValue, needAnException)

Description ## 

The dvm:lookup-dvm function finds the reference element value in a domain value map and returns the equivalent value of the specified element name as a string. This form of DVM lookup is used to find a single reference element and return a single element value. Lookups involving multiple elements in a reference or return domain need to be done using the dvm:lookupValueNVP function. This function is identical in purpose and function to the dvm:lookupValue function. It exists to mimic the function names defined in the ESB implementation of DVM.

Example ##

The following code looks up the value of the Long element in the CityCodes DVM map corresponding to the value in the Abbrev element:

dvm:lookup-dvm(“CityCodes”,”Abbrev”,”Bang”,”Long”,”NotFound”, True)