<?xml version="1.0" encoding="Windows-1255" ?><Rule name="doInsert" modifier="transactive" scope="protected" sortGroup="true" id="core.gml2:doInsert" sort="27" urn="core.gml2:rules.composition.doInsert.xml" toc="\Rules\Composition rules"><Summary>Inserts a collection of elements into a given parent element.</Summary><Parameters signature="transactive rule::<div style="padding:6 0 0 16"><b>doInsert</b>(<i>unit</i>, <i>board</i>, <i>parent</i>, <i>parentKey</i>, <i>elements</i>) &rarr; Boolean</div>"><Param name="unit" type="core.gml2:Unit!" typeRef="<q ref="core.gml2:Unit">Unit</q>">The unit classifier.</Param><Param name="board" type="core.dev:IBoard!" typeRef="<q ref="core.dev:IBoard">IBoard</q>">The board classifier.</Param><Param name="parent" type="core.gml2:Element!" typeRef="<q ref="core.gml2:Element">Element</q>">The parent classifier. This is the parent element into which the given elements are to be inserted.</Param><Param name="parentKey" type="String">The parent collection key.</Param><Param name="elements" type="core.gml:GmlObject![id]" typeRef="<q ref="core.gml:GmlObject">GmlObject</q>[id]">The elements to insert.</Param></Parameters><Classifiers><Classifier name="unit" type="gml2:Unit" expr="unit"></Classifier><Classifier name="board" type="dev:IBoard" expr="board"></Classifier><Classifier name="parent" type="gml2:Element" expr="parent"></Classifier></Classifiers><Return type="Boolean">Returns the rule's success/failure status.</Return><Remarks><h2>Dependencies</h2><table class="WHITE" style="width:auto; margin-top:0" cellspacing="1"><tr><td class="H V"><i>pre-condition:</i> </td><td class=H><q ref="core.gml2:canInsert">canInsert</q> == true </td></tr></table> <h2>Behavior</h2> The behavior can be extended to perform custom actions when elements are inserted.</Remarks><Copyright>(c) SAP AG 2003-2006. All rights reserved.</Copyright> <Topics> </Topics> </Rule>