LookupValue1M

Syntax

 LookupValue1M (mapName, referenceElementName, referenceValue, elementName, needAnException)

Description

Locate the reference element value in a domain value map, and return the equivalent values of the specified element name as an NVP list. This form of DVM lookup is used to find a single reference element and return one to many equivalent values for the specified element.

Parameters

Parameter	Description
mapName	Name of a static value map definition (DVM), as string.
referenceElementName	Name of an element in the DVM in which to look for a value, as string.
referenceValue	Value of an element in the DVM to look for, as string.
elementName	Name of the element in the DVM to return equivalent values for, as string.
needAnException	True to return error messages, false to return the default values.

Returns

An array of string containing the equivalent values of elementName in the DVM.

Example

This example will look up value &guid1 in the UniqueGUID element of the &TestName DVM and return the equivalent value of element &EBS1 :

&returnValue = &dvm.LookupValue1M(&TestName, &UniqueGUID, &guid1, &EBS1, True);

This example will look up a value that does not exist in the UniqueGUID element of the &TestName DVM to verify that no value is returned when the NeedAnException parameter is false:

 &returnValue = &dvm.LookupValue1M(&TestName, &UniqueGUID, "NotFound", &EBS1,⇒
 False);