Create Form

Use the Create Form dialog to visualize data from a web service data control in a form layout.

The Create Form dialog is arranged in the following tabs:

Type

The Type tab of the Create Form dialog enables you to select the type of form to use to visualize your data.

Element	Description
Select the type of form	Select: Form to add an editable form where users can edit information within the form, and then commit those changes to the data source. The data in the form can be edited only if the underlying data source supports updating of records. Read-only Form to display form data that cannot be edited.
Include Submit Button	Select to display a Submit button on the form. You will need to submit a form only when you allow users to specify values or edit form data. Therefore, this option is enabled only if you are creating an editable form.
Include Navigation Controls	Select to provide navigation controls to view all the retrieved records. When you select this option, the form displays First, Previous, Next, and Last buttons.

Element

Description

Select the type of form

Select:

Form to add an editable form where users can edit information within the form, and then commit those changes to the data source. The data in the form can be edited only if the underlying data source supports updating of records.
Read-only Form to display form data that cannot be edited.

Include Submit Button

Select to display a Submit button on the form. You will need to submit a form only when you allow users to specify values or edit form data. Therefore, this option is enabled only if you are creating an editable form.

Include Navigation Controls

Select to provide navigation controls to view all the retrieved records. When you select this option, the form displays First, Previous, Next, and Last buttons.

Items

The Items tab of the Create Form dialog enables you to identify which data to display.

Element	Description
Available Items	Displays the items available in the data source. Select the items you want to display in the form. Select a single item or multiple items and use the arrows next to this list to move items to the Selected Items list.
Selected Items	Displays the items selected for display in the form. Select a single item or multiple items and use the arrows to the left of this list to remove items from the list.

Element

Description

Available Items

Displays the items available in the data source. Select the items you want to display in the form.

Select a single item or multiple items and use the arrows next to this list to move items to the Selected Items list.

Selected Items

Displays the items selected for display in the form.

Select a single item or multiple items and use the arrows to the left of this list to remove items from the list.

Fields

The Fields tab of the Create Form dialog enables you to determine how to display data within the form.

Element	Description
Column	Select a column to define its format in the form.
Label	Specify text to use as the label for the selected column.
Form Component	Select: Input Text to display data as editable fields and thereby enable users to modify the data in this field (available only for editable forms). Read Only Text to display data records as read-only text. This is the default selection in a read-only form.

Element

Description

Column

Select a column to define its format in the form.

Label

Specify text to use as the label for the selected column.

Form Component

Select:

Input Text to display data as editable fields and thereby enable users to modify the data in this field (available only for editable forms).
Read Only Text to display data records as read-only text. This is the default selection in a read-only form.

Visualization Parameter

The Visualization Parameter tab of the Create Form dialog lists the parameters defined by the data control. You can include data control parameters in a parameter form above the form to enable users to control the data displayed. You can specify parameter values to determine the initial data displayed. This step is optional. If you do not expose a parameter form, the form displays data pertaining to the values specified when the data control was created.

Element	Description
Parameter	Lists the parameters defined by the data control. Select the check box next to the parameter name to display the parameter in a parameter form above the form so that users can control the data displayed in the form.
Default Value	Enter a value for the parameter. This value determines the initial data displayed in the form.
Submit Button Label	Enter the text to display on the button that end users click to submit values on the parameter form.