Form

Each Form resource has a layout and controls for user input. At runtime, HTML templates are used to render the form in a browser. The layout and form controls, shown in the design panel as logical entities, are rendered according to the styles and structure defined in the templates.

For basic forms, you can use the default templates provided with TIBCO BusinessWorks FormBuilder.

For customized forms, you can build custom templates. For details, see Form Resource Store.

A form must include at least one control that generates a form action. For more information on form actions and transitions, see the TIBCO BusinessWorks FormBuilder User’s Guide, Chapter 7, Designing Formflows.

This tab allows you to specify a layout scheme, which specifies how fields are organized in the runtime form. The Configuration tab has the following fields.

Field	Description
Name	The label for the resource in a formflow.
Layout	The layout scheme for the form. Select one of the following values from the dropdown list:
Single Column	The simplest layout, consisting of a single pane with a button area below. The button area usually contains button controls, but any type of control can be added to any area.
Two Columns	A layout with two vertical panes and a button area below. The button area usually contains button controls, but any type of control can be added to any area.
	Single Column with Grid	A layout that accommodates multiple lines with repeating sets of fields. For example, a timesheet form might require a separate line item for each week, or an invoice might contain several line items. There is a single pane for nonrepeating fields at the top of the form, with a grid area below. Below the grid area is a button area, which usually contains button controls, but any type of control can be added to any area.
Two Columns with Grid	A layout that accommodates multiple lines with a repeating set of fields. There are two vertical panes for nonrepeating fields at the top of the form, with a grid area at the bottom. Below the grid area is a button area. The button area usually contains button controls, but any type of control can be added to any area.
Custom Layout	A layout with the configuration you define. For more information on creating custom layouts and controls, see Form Resource Store. When the resource is validated, this field is selected for a valid value.

Field

Description

Name

The label for the resource in a formflow.

Layout

The layout scheme for the form. Select one of the following values from the dropdown list:

Single Column

The simplest layout, consisting of a single pane with a button area below. The button area usually contains button controls, but any type of control can be added to any area.

Two Columns

A layout with two vertical panes and a button area below. The button area usually contains button controls, but any type of control can be added to any area.

Single Column with Grid

A layout that accommodates multiple lines with repeating sets of fields.

For example, a timesheet form might require a separate line item for each week, or an invoice might contain several line items.

There is a single pane for nonrepeating fields at the top of the form, with a grid area below.

Below the grid area is a button area, which usually contains button controls, but any type of control can be added to any area.

Two Columns with Grid

A layout that accommodates multiple lines with a repeating set of fields.

There are two vertical panes for nonrepeating fields at the top of the form, with a grid area at the bottom.

Below the grid area is a button area. The button area usually contains button controls, but any type of control can be added to any area.

Custom Layout

A layout with the configuration you define.

For more information on creating custom layouts and controls, see Form Resource Store.

When the resource is validated, this field is selected for a valid value.

Field	Description
Name	The name of the pane. The default pane names are column1, buttonbar, grid, and gridbuttons. For default panes, this value cannot be modified.
Horizontal Alignment	A dropdown list that specifies whether to place controls to the left, right, or center of the pane.
Vertical Alignment	A dropdown list that specifies whether to place controls at the top, middle, bottom, or baseline of the pane.
Cell spacing	A numeric value that specifies how many pixels of blank space to insert between controls in the pane.
Repeating	A Boolean value that specifies whether the pane can contain multiple instances of controls. If selected, the pane is a grid pane.
Orientation	A dropdown list that specifies whether to align controls in the pane horizontally or vertically.

Field

Description

Name

The name of the pane. The default pane names are column1, buttonbar, grid, and gridbuttons. For default panes, this value cannot be modified.

Horizontal Alignment

A dropdown list that specifies whether to place controls to the left, right, or center of the pane.

Vertical Alignment

A dropdown list that specifies whether to place controls at the top, middle, bottom, or baseline of the pane.

Cell spacing

A numeric value that specifies how many pixels of blank space to insert between controls in the pane.

Repeating

A Boolean value that specifies whether the pane can contain multiple instances of controls. If selected, the pane is a grid pane.

Orientation

A dropdown list that specifies whether to align controls in the pane horizontally or vertically.