merge()

Merges a collection of business objects under one top-level business object.

Syntax

BusObj merge(java.util.Vector BusObjs,
           String Level)
 BusObj merge(java.util.Vector BusObjs,
           String Attr,
           BusObj mergeBusObj)
 

Parameters

BusObjs
Specifies the collection of child business objects to be merged.

Level
Specifies the merge level, which comprises the business object type and the name of its array attribute whose child business objects are going to be merged. Names are delimited by a period (.).

Attr
Specifies the name of the array attribute in the mergeBusObj business object in which the child business objects are to be merged.

mergeBusObj
Specifies the top-level business object that is going to hold the merged collection of child business objects.

Return values

Returns the top-level business object (either new or specified) that contains the merged collection of child business objects.

Exceptions

CollaborationException--Thrown if an error occurs while merging business objects.

Copyright IBM Corp. 2003, 2004