Configuring Siebel eBusiness Applications > Editing Applet Layout >

Converting Form Applets to a Grid Layout Using the Conversion Wizard

The Applet Web Template Conversion Wizard allows you to convert one or more existing applets to a grid-based layout. You may need to do this when you preserve custom layout during an upgrade (and have not previously converted to grid layout) and then want to convert form applets to grid layout. Or you may need to do this when you have custom applets that you have created using non-grid layout templates and then decide to convert them to grid-layout templates.

To convert one or more applets to a grid-based layout

1. In the Configuration Context Toolbar, make sure the application context that you want, such as All Applications, is selected.

   The wizard only converts controls that are valid in the current application context selected in the Configuration Context Toolbar. For example, if Siebel ERM is selected, only controls valid in the context of Siebel ERM are converted. If controls are not valid in the selected application context, a dialog box appears giving you the option of canceling the conversion or continuing. If you choose to continue, the controls not converted are written to a log file (awtconversion.txt) that is located in tools_install\temp. See Troubleshooting Conversions to Grid Layout.

2. If you are working in Language Override mode, make sure your Tools Language Mode is set to the language you want convert.

   For more information about Language Mode and Language Override, see Using Siebel Tools.

3. In the Object Explorer, select the Applet object type.
4. In the Object List Editor, select the applet or applets that you want to convert.

   You cannot convert applets based on the Web templates defined in Applet Web Templates that Cannot Be Converted to a Grid Layout.

   You cannot convert applets that do not have Web templates associated with them.

5. Do one of the following:
   • Right-click and then select Convert to Grid Layout.
   • Choose Tools > Convert to Grid Layout.

     The Applet Web Template Conversion Wizard appears.

6. Move the applets you want to convert from the Available Applets window to the Selected Window.
7. Select additional options.

   It is recommended that you select the Backup existing Applet Web Templates option.

   If you select the Label on the left of the fields option, the Conversion wizard creates a new non-grid form template, moves labels to the left, then converts that template to grid layout.

   If you select the Launch web layout editor upon completion option, the applet Web template displayed in the editor is the last applet that was selected in Step 6.

8. Click Next.

   The wizard converts the active Web templates to grid-layout Web templates.

   If no errors occur, you can edit the layout of these applets using the Web Applet Editor. For more information, see Working with the Applet Layout Editor.

   If errors occur, they are displayed in a dialog box at the end of the conversion wizard. The same content is stored in a log file (awtconversion.txt) that is located in tools_install\temp. For more information about errors, see Troubleshooting Conversions to Grid Layout.

   NOTE:  Sometimes items in applet headers or footers are not converted properly and may have to be manually adjusted after the conversion. This can happen when a field is mapped to a placeholder in an applet header or footer. Typically controls mapped to headers and footers are buttons.