You are here: User interface > User interface rules > Harness and section forms > Converting a section or flow action to smart layouts

How to convert a section to use smart layouts

A smart layout-based form provides attractive, consistent spacing of horizontal elements such as field labels and Text Input controls, even when sections are embedded within sections. Smart layouts contribute to a professional-looking application and may improve user productivity and quality.

In many cases, you can convert non-smart layout forms to use only smart layouts, realizing some of the benefits. In other cases, conversion is inadvisable or impractical.

Tactics

For the harnesses and sections, identify each included section, sections included within those sections, and so on.

Work in a new ruleset version. Start by saving each rule to be converted into the higher ruleset version.

Upgrade or rebuild the harness first. Then upgrade or rebuild the harness or flow action .

Approach 1: Upgrade in place

Follow these tips to "upgrade" an older layout into a quasi-SmartLayout layout.

  1. Decide whether the contents of the existing layout are most nearly matched by the Single, Double, or Triple smart layout format.
  2. Use the Insert Column, Merge Cells, and other operations as necessary so that columns correspond to alternating labels and fields, with an empty spacer column between label-field pairs.
  3. Open the Layout Panel. If the Header value is Hidden or Hidden (Sub), change it to No Format.
  4. Change the Template from Custom to Single, Double, or Triple.
  5. Click Apply. Save the rule form.
  6. Open the Column panel for each column. Select a Column Type of Label for the leftmost column and click Apply. Make the second column have a Column Type of Field and the third column have a Column Type of Spacer. Repeat to mimic the Single, Double or Triple pattern of columns. Save the rule form.
  7. Repeat for each section. After all sections are upgraded, make a Save As copy of harnesses and flow actions. Refresh to see the upgraded sections. Save.
  8. Test.

Approach 2: Replacement

The upgrade process in Approach 1 preserves your previous settings within individual cells (except for width, height, and styles), and preserves many previous settings for the layout itself. However, the result of this "upgrade" is not a true Smart Layout. To achieve a true SmartLayout, you must reproduce the cells in a smart layout.

  1. Decide whether the contents of the existing layout are most nearly matched by the Single, Double, or Triple smart layout format.
  2. Select the Layout control from the Layout control group. Drop a new layout below the original layout.
  3. Open the Set the Template to Single, Double or Triple as appropriate. The smart layout is empty.
  4. Select a cell in the original layout. Right-click and choose Copy from the context menu. Find the correspondence cell in the smart layout, right-click, and choose Paste.
  5. Repeat for each cell in the layout, adding or deleting rows (not columns) as appropriate. Save.
  6. Open the Layout properties panel of the original layout, and note the property settings. Enter these values in the new smart layout panel. However, if the original layout has a Header value of Hidden or Hidden (Sub), select No Format for the Header of the smart layout panel.
  7. After all cells and properties are copied to the smart layout delete the original layout. (You can still examine the original layout in the original rule.)
  8. Test.

Example

Original user form. Labels and fields are not aligned on the left or the right, and have differing widths.

Not SmartLayout

After upgrade. (Added green lines to emphasize uniform widths)

SmartLayout 1

As a best practice, use dynamic layouts for new development. It is recommended that you upgrade existing smart layouts to take advantage of HTML5 capabilities including cross-browser and cross-platform compatibility, access to the latest HTML markup, and improved performance.

When you open a section with a smart layout, you'll see a guardrail warning and a suggestion to upgrade.

Click Update layouts for Designer Studio to update this layout instance to a dynamic layout.

Some smart layout configurations may not have a one-to-one correspondence with dynamic layouts and may require some manual modifications. Note the following:

User Interface category