xref:lookupXRefNVP
Syntax
xref:lookupXRefNVP (mapName, referenceDomain, referenceNVP, targetDomain, needAnException)Description
Use the lookupXRefNVP function to look up cross-reference values that correspond to a specified set of values in a reference domain. All primary elements in the reference domain must be included in the reference NVP list, but any qualifier elements are optional.
Parameters
| Parameter | Description |
|---|---|
|
mapName |
The name of the cross-reference map, as string. |
|
referenceDomain |
The name of the reference domain, as string. |
|
referenceNVP |
NVP list of reference elements and values, as string. |
|
targetDomain |
The name of the domain to be looked up for the values, as string. |
|
needAnException |
Specify true or false. If the needAnException parameter is set to true, an exception occurs if the value being looked up in the map is not found. If the needAnException parameter is set to false, an empty value is returned if the value being looked up in the map is not found. |
Returns
The return string includes values for all primary and qualifier elements in the target domain as an NVP list.
An exception can occur for the following reasons:
-
The cross-reference map with the given name is not found.
-
The specified domain names are not found.
-
The specified element names are not found.
-
The specified reference value is empty.
-
Multiple target values are found.
Example
The following code looks up the values of all elements in the Common domain of the Items cross-reference map that correspond to values SHARE/1000 in the PeopleSoft domain:
xref:lookupXRefNVP("Items","PeopleSoft","<Setid>SHARE</Setid><ItemID>1000</Item⇒
ID>","Common",true())