sMergeGroups3 (client-side)
Use this routine to merge three sets of XML records containing different information about the same entities, returning the result as a string containing XML tagging.
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 documents.
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
sMergeGroups3(xmlMaster,
xmlGroup,
xmlDetail,
sMasterKeyId,
sDetailKeyId)
Parameters
xmlMaster
An XML DOMDocument object 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 presumably considered to contain higher-level information.
xmlGroup
An XML DOMDocument object 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 presumably considered to contain information of a medium level of detail.
xmlDetail
An XML DOMDocument object 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 presumably considered to contain the most detailed information.
sMasterKeyId
A string that corresponds to the name of a data 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 data 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
A string 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 created two- and three-tiered XML data record structures, see XML Data Merging.
This routine is available in the include file ActionPageUtil.asp.
There is a functionally equivalent version of this routine defined for server-side use in the file ASPUtil.asp.
See Also
xmlMergeGroupsByID2 (client-side)