xref:BulkPopulateDomainData

Syntax

xref:BulkPopulateDomainData(mapName, domainList, dataRowsPath, dataValuesPath, mode)

Description

The XREF bulk populate domain data function populates cross-reference data from XML. It sequences through the rows of data provided in the XML nodeset and uses the supplied domain list and data values path to access the values for each domain 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. When a domain contains multiple elements, each value for the domain must contain a compound value consisting of a value for each element in the domain separated by the concatenation string specified in the value map options. In this scenario, this function will unconcatenate the domain element values before inserting the data into the transformation framework.

Parameters

Parameter Description

mapName

The name of a dynamic (cross reference) value map, as string.

domainList

A comma separated list of domain 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.