Configuring Siebel Business Applications > Configuring Applet Layout > Process of Using the Applet Layout Editor >

Adding a Control or List Column to an Applet Layout

This task is a step in Process of Using the Applet Layout Editor.

You can use the Applet Layout Editor to add a control or list column to an applet:

• You can add a predefined control or list column that is a child object of the applet that exists in the Siebel repository but that Siebel CRM does not map to the applet web template.
• You can add a custom control or list column to an applet layout. For example, you can add a custom control to the applet layout that displays a custom business component field.

An applet header or footer can include a button control. You cannot place a nonbutton control, such as a field, in an applet header or footer.

For more information, see About Applet Controls and List Columns.

To add a control or list column to an applet layout

1. In Siebel Tools, click Applet in the Object Explorer.
2. In the Applets list, locate the applet you must modify, right-click, and then click Edit Web Layout.
3. Make sure Siebel Tools displays the Controls/Columns window.

   To display the Controls/Columns window, click the View menu, Windows, and then click the Controls Window menu item.

4. Drag and drop the control or list column you must add from the Controls/Columns window to the canvas.

   Siebel Tools displays the control or list column in the canvas and creates the corresponding web template item. If this is a custom control, then Siebel Tools creates an object definition for the control. If you add a control, then the Applet Layout Editor adds the corresponding child objects to the applet, including the control or list column, and the applet web template item. For more information, see Properties of the Applet Web Template Item.

5. Optional. Use the Properties window to define the properties for the control.

   If the Properties window is not open, then click the View menu, Windows, and then click the Properties Window menu item.

6. To add a control or list column in a layout that does not use a grid, drag and drop the control or list column from the Controls/Columns window to any empty placeholder in the canvas.

   The predefined placeholders in the web template determines the locations that are available for a control in an applet that references a web template that does not use a grid. For example, with a list applet. For these applets, you drag and drop a control onto an empty placeholder in the canvas. For more information, see About Nongrid Form Applet Templates.

7. Save your modifications.

How Siebel Tools Treats Labels and Controls in a Grid Layout

If an applet references an applet web template that uses a grid layout, then Siebel Tools treats the labels and controls as separate items. Siebel Tools does this to provide more flexibility when you design the layout. This functionality requires you to map the control and the label of the control onto the applet layout. A label includes the same name as the control, except that Siebel Tools appends the label with the word label. For more information, see Using Grid Layout for an Applet.

Deleting a Control or List Column

You can cut or delete a control or list column from an applet layout. It is not necessary to delete the object definition for the control or list column. For important caution information, see Deleting a Control or List Column While in Language Override Mode.

To delete a control or list column

1. In Siebel Tools, click Applet in the Object Explorer.
2. In the Applets list, locate the applet you must modify, right-click, and then click Edit Web Layout.
3. In the canvas, choose the control you must delete.

   To choose multiple controls, hold down the Shift key, and then choose the controls you must delete.

4. Do one of the following:
   • Click the Edit menu, and then click Cut.
   • Press CTRL+X.
   • Right-click, and then click Delete.

     Siebel Tools removes the item from the canvas and deletes the corresponding applet web template object definitions from the Siebel repository.