Bookshelf Home | Contents | Index | Search | PDF

Siebel Tools Reference > Logical User Interface Objects Layer > Views >

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.

Bookshelf Home | Contents | Index | Search | PDF