xref:BulkPopulateElementData

Syntax

xref:BulkPopulateElementData(mapName, elementList, dataRowsPath, dataValuesPath, mode)

Description

The XREF bulk populate element data function populates cross-reference data from XML. It sequences through the rows of data provided in the XML nodeset and uses the supplied pairs of elements and XPath expressions to access the values for the elements in each row. Each row of data is then inserted into the XREF framework for the specified map utilizing bulk insert to maximize performance. This function is expected to be used for processing large volumes of data. It provides an abstraction layer from the physical data persistence layer of the XREF framework. because inserts are done using bulk mode, duplicates are not looked for until the end of the insert sequence. If a duplicate is encountered, none of the rows of data will be inserted.

Parameters

Parameter	Description
mapName	The name of a dynamic (cross reference) value map, as string.
elementList	A comma separated list of element names identifying the order of the data values to be imported.
dataRowsPath	An XPath expression resulting in a series of XML nodes where each node represents one row of data.
dataValuesPath	An XPath expression (relative to each row of data) used to identify each node containing a data value within a row of data. The nodeset returned when this path is evaluated must contain the same number of nodes as there are domains in the specified domainList.
mode	Only ADD mode is supported.

Returns

Boolean indicating success or failure of the process.