LookupValueNVP

Syntax

LookupValueNVP (mapName, referenceDomain, referenceNVP, targetDomain, needAnException)

Description

Locate the reference domain element values in a cross-reference map, and return the equivalent values of all elements in the specified domain as an NVP list. This form of 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.

Parameters

Parameter	Description
mapName	Name of a dynamic (cross-reference) value map definition, as string.
referenceDomain	Name of a domain in the XREF in which to look for a value, as string.
referenceNVP	Name value pairs of elements and values in the reference domain to look for, as an array of DataElement.
targetDomain	Name of the domain to return equivalent values for, as string.
needAnException	True to return error messages, false to return an NVP with the default values.

Returns

An array of DataElement for name value pairs containing the equivalent values for the elements in the target domain, or the default values.

Example

This example will look up value &guid1 in the UniqueGUID domain of the &TestName cross-reference map and return the equivalent values for the &RTK domain:

 Local array of EOTF_CORE:Common:DataElement &returnValue = &xref.LookupValueNVP⇒
(&TestName, &UniqueGUID, &UniqueGUIDrequestValues, &RTK, True);