Siebel Developer's Reference > Siebel Web Engine Tags > Applet Tags >

Master and Detail Applet Tags

The for-each-child and child-applet tags display a view that includes master and detail applets. This view is similar to the layout that a catalog uses. SWE can interweave the records that it displays in these applets instead displaying only master records in the master applet and only detail records in the detail applet.

You can configure the master and detail applets as list applets to create a layout that is similar to a catalog. To define a relationship between these applets, you can use the Position attribute of the view web template item. This attribute is similar to the Position attribute of a tree node:

• The master applet uses a first-level position value, such as 1 or 2.
• A child applet uses a second-level position value, such as 1.1 or 1.2.
• A grandchild applet uses a third-level position value, such as 1.1.1 or 1.1.2.

SWE can display more than one set of master and detail relationships in a view where more than one master applet can exist.

Siebel CRM only maps the master applets to the applet tags that the view template contains. It does this mapping in the view web template item. It does not assign IDs to the other applets that the view web template item contains. It specifies the layout of nonmaster applets in the applet template of the master applet. It does not specify this layout in the view template.

Siebel CRM supports this layout only for an applet that is in base mode.

The catalog style layout works only in standard interactivity mode. You must not use these tags in high interactivity mode.

Example of Using Master and Detail Applet Tags

In the example that this topic describes, assume a master and detail view includes the Category Items List Applet as the master applet and the Sub Category Items List Applet as the detail applet. The following table lists the view web template items that this view uses.

The base template for the Category Items List Applet contains the following code:

<table>
<swe:for-each-row>
<tr>
<td>
<swe:control id ="5001" /> </td><!-- field value similar to "Small Business" -->
<td>
<swe:for-each-child>
<swe:child-applet> <!-- Display the child applet -->
</swe:for-each-child>
</td>
</tr>
</swe:for-each-row>
</table>

The base template for the Sub Category Items List Applet contains the following code:

<table><tr>
<swe:for-each-row>
<td>
<swe:control id="5001"/> </td><!-- field value similar to "Desktop" -->
</swe:for-each-row>
</tr></table>

Iterate Child Applets Tag

The for-each-child tag iterates each of the child applets that Siebel CRM defines for this applet according to the position value of the view web template that resides in the view that references this applet. It uses the following format:

<swe:for-each-child> ...... </swe:for-each-child>

SWE can use this tag only in the base template of an applet. If the applet does not contain a child applet, then SWE ignores this tag.

Child Applet Tag

The child-applet tag places a child applet in a parent applet. The base template of this child displays the child at the point where SWE places this tag.

The child-applet tag uses the following format:

<swe:child-applet/>

You can set the HTML Number of Rows property of the Sub Category Items List Applet to the number of values that SWE must display in each category.

You must configure the appropriate drilldown objects to allow the user to drill down from the category and subcategory values.