Siebel Object Interfaces Reference > Interfaces Reference > Property Set Methods >

AddChild Method

The AddChild method is used to add subsidiary property sets to a property set, so as to form hierarchical (tree-structured) data structures.

Syntax

oPropSet.AddChild(childPropSet as PropertySet)

Returns

An integer indicating the index of the child property set.

Usage

Property sets can be used to create tree-structured data structures. Any number of arbitrarily structured child property sets can be added to a property set. You may use child property sets to structure a property set in a manner similar to the data model. For example, the parent property set might be Account, with child property sets for opportunities, contacts, activities, and so on. At the same time, you could construct an independent property set called Opportunity, to which accounts, contacts, and activities might be children.

If a property set is instantiated within script and then added to a parent property set, the child property set is not released when the parent property set is released. This is because a reference to the child property set still exists independently.

Used With

Browser Script, COM Data Control, COM Data Server, Java Data Bean, Mobile Web Client Automation Server, Server Script, Web Client Automation Server

Example

The following fragment of eScript code shows how child property sets may be added to a parent property set:

   var Account = TheApplication().NewPropertySet();
   var Opportunity = TheApplication().NewPropertySet();
   var Contact = TheApplication().NewPropertySet();
   var Activity = TheApplication().NewPropertySet();

   Account.AddChild(Opportunity);
   Account.AddChild(Contact);
   Account.AddChild(Activity);

Related Topics

GetChild Method
InsertChildAt Method
RemoveChild Method