LookupValue1M

Syntax

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

Description

Locate the reference element value in a cross-reference value map, and return the equivalent values of the specified element name as a named value pair (NVP) list. This form of 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 dynamic (cross-reference) value map definition, as string.
referenceElementName	Name of an element in the Xref in which to look for a value, as string.
referenceValue	Value of an element in the Xref to look for, as string.
elementName	Name of the element in the Xref for which to return equivalent values, as string.
needAnException	True to return error messages, false to return blank.

Returns

An array of string containing the equivalent values of elementName in the cross-reference.

Example

This example will look up value &guid1 in the UniqueGUID element of the &TestName cross-reference map and return the equivalent value of element &EBS1:

Local array of string &returnValue;

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

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

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