About the xref:lookupPopulatedColumns Function
You can use the xref:lookupPopulatedColumns
function to look up all the populated columns for a given cross reference table, a cross reference column, and a value. The xref:lookupPopulatedColumns
function returns a node-set with each node containing a column name and the corresponding value.
The syntax of the xref:LookupPopulatedColumns
function is shown in the following example:
xref:LookupPopulatedColumns(xrefTableName as String,xrefColumnName as String,xrefValue as String,needAnException as boolean)as node-set
Parameters
-
xrefTableName
: The name of the reference table. -
xrefColumnName
: The name of the reference column. -
xrefValue
: The value corresponding to the reference column name. -
needAnException
: If this value is set totrue
, then an exception is thrown when no value is found in the referenced column. Otherwise, an empty node-set is returned.
Exception Reasons
An exception can occur for the following reasons:
-
The cross reference table with the given name is not found.
-
The specified column names are not found.
-
The specified reference value is empty.