http://download.oracle.com/docs/cd/E05554_01/books/ToolsRef/ToolsRefuiobj16.

html

Applet Toggles

Applet toggles allow users to switch back and forth between different applets within the same
view. This is useful when you want to display different types of data or present the same data in
a different way. There are two types of applet toggles, static and dynamic:

 Static applet toggles. Allow users to toggle between applets by selecting the name of the
applet from the Show drop-down list.
 Dynamic applet toggles. Automatically toggles between applets based on the value of a
field in a parent applet.

When configuring applet toggles, consider the following:

 For applets involved in a toggle cycle the search spec on the form applet in the view will
be applied first. Therefore, to apply a search spec on a list applet in a toggle cycle, you
also need to add the search spec for the form applet.
 Dynamic toggle applets must be based on the same business component.
 Static toggle applets do not have to be based on the same business component.
 You cannot configure more than one applet toggle in a view.

To understand applet toggles consider an example. Suppose you need to store information about
your customer's preferred payment method using the contact business component. Payment
methods are cash, credit card or check. For each payment method, you need to gather different
data:

 Cash. No special data requirement, this is the default payment method

 Credit Card. Credit Card Type, Credit Card Number, Expiration Date
 Check. Checking Account Number, Routing Number, Driver License Number, Driver
License State

You could configure this scenario using a static toggle applet or a dynamic toggle applet. A static
toggle applet would require the user to toggle between the different applets by selecting it from
the Show drop-down list. Dynamic toggle would automatically toggle between applets based on
the value entered in a Payment Type field.

To configure applet toggles (an example)

1. Create new fields in the Contact business component to capture the following
information:
  Payment Method (use a static bound picklist that contains Cash, Credit Card, and
Check)
 Credit Card Type
 Credit Card Number
 Expiry Date
 Checking Account Number
 Routing Number
 Driver License Number
 Driver License State

2. Expose the Payment Method Field in the Contact Form Applet. This is the default applet
that would be used when the contact's preferred payment method is Cash.

3. Create two copies of the Contact Form Applet.

Name one of them Contact Form Applet - Credit Card and the other Contact Form Applet
- Check.

4. Expose the following fields in the Contact Form Applet - Credit Card:
 Credit Card Type
 Credit Card Number
 Expiry Date BC Fields

NOTE:  When the contact's preferred payment method is Credit Card, the
Contact Form Applet - Credit Card applet allows the user to enter a contact's
credit card information.

5. Expose the following fields in the Contact Form Applet - Check:

 Checking Account Number
 Routing Number
 Driver License Number
 Driver License
 State BC Fields

NOTE:  When the contact's preferred payment method is Check, the Contact
Form Applet - Check applet allows the user to enter a contact's checking account
information.

6. Find and select the Contact Form Applet in the Object List Editor, navigate to the Applet
Toggle child object, type and create the following records:
 Record 1:
 Applet=Contact Form Applet - Check
 Auto Toggle Field=Payment Method
 Auto Toggle Value=Check
 Name=Contact Form Applet - Check
 Parent Name=Contact Form Applet
  Record 2:
 Applet=Contact Form Applet - Credit Card
 Auto Toggle Field=Payment Method
 Auto Toggle Value=Credit Card
 Name=Contact Form Applet - Credit Card
 Parent Name=Contact Form Applet

NOTE:  To configure this example as a static toggle applet that allows the
user to select the appropriate applet from the Show drop-down list, leave
the Auto Toggle Field and Auto Toggle Value properties blank.

7. Compile your changes and test.