xmlMergeGroupsByID3 (client-side)
Use this routine to merge three sets of XML records containing different information about the same entities, returning the result as an XML document.
One set of records, known as the master set, contains higher-level information about each entity represented in the set. A second set of records, known as the group set, contains more detailed information about the same set of entities. A third set of records, known as the detail set, contains the most detailed information about the same set of entities. All three sets of records are contained in XML data-islands in the current document.
The records from each set are matched up and merged into a resulting set of records containing three tiers. The first tier contains the higher-level information, the second tier contains the group level of detail, and the third tier contains the most detailed information.
Definition
xmlMergeGroupsByID3(sMaster,
sGroup,
sDetail,
sMasterKeyId,
sDetailKeyId)
Parameters
sMaster
A string that matches the id attribute of an XML data-island containing a set of record elements and associated data elements in the standard XML data record structure. These record elements contain the data that appears in the first tier of the resulting standard XML data record structure, and are considered to contain higher-level information.
sGroup
A string that matches the id attribute of an XML data-island containing a set of record elements and associated data elements in the standard XML data record format. These record elements contain the data that appears in the second tier of the resulting standard XML data record structure, and are considered to contain information of a medium level of detail.
sDetail
A string that matches the id attribute of an XML data-island containing a set of record elements and associated data elements in the standard XML data record format. These record elements contain the data that appears in the third tier of the resulting standard XML data record structure, and are considered to contain the most detailed information.
sMasterKeyId
A string that corresponds to the name of a field element that exists in both the xmlMaster and xmlGroup XML documents. The values for this element are used to match up records in one XML document with records in the other.
sDetailKeyId
A string that corresponds to the name of a field element that exists in both the xmlGroup and xmlDetail XML documents. The values for this element are used to match up records in one XML document with records in the other.
Return Value
An XML DOMDocument object that contains the merged, three-tiered set of records, represented in the standard XML data record format.
Remarks
This routine is useful for preparing a three-tiered XML data record structure for use by a three-level ListSheet HTC. For more information about how the ListSheet HTC expects its data in one-, two-, and three-tiered data record structures, see ListSheet and Standard XML Data Record Format.
For more information about how single-tiered XML data record structures are merged to create two- and three-tiered XML data record structures, see XML Data Merging.
This routine is available in the include file ActionPageUtil.asp.