Create Form

The Form option is displayed only for data control accessors that return a collection of objects that can be displayed as a form element.

When you add a data control to a task flow as a form, you have two options:

• Read-only Form—Add the data control as a read-only form. The form displays data based on your specification, but the data cannot be edited.

• Form—Currently editable forms are not supported.

To present data as a form:

1. On the Type page of the Create Form wizard, select Read-only Form.
2. Select Include Navigation Controls to display First, Previous, Next, and Last buttons on the form. Navigation controls are helpful when multiple records are retrieved from the data source.

   Note:

   Navigation controls may not work properly if the data control provides bind parameters.

3. Click Next.
4. On the Items page, by default all the accessor attributes are selected to display in the form. If there are any accessor attributes that you do not want to display in the form, select them in the Selected Items list and move them to the Available Items list.

   Note:

   If an item has a scalar value, you cannot add the item to the form after initial creation.

5. Use the arrow icons next to the Selected Items list to determine the order in which the attributes are displayed as fields in the form.
6. Click Next.
7. On the Fields page, for each field in the form, specify display options as follows:

   • Label—Specify text to use as a label for the selected field.

   • Form Component—Select Read Only Text to display the field as read-only text.

8. If the data control has associated parameters that you want to expose on a parameter form, click Next.
   1. On the Visualization Parameter page, select the check box next to the parameter for which you want users to be able to provide their own values.

      Any parameters you select in this way are displayed in a parameter form above the table, form, or graph that you are adding. Users can specify a value and click a button to refresh the data according to the values they specified.

   2. On the Visualization Parameter page, select the check box next to the parameter for which you want users to be able to provide their own values.

      The initial value displayed in this field is specified when the data control was created. You can override this initial value to control the initial display of data.

   3. In the Submit Button Label field, enter the text that you want to be displayed on the button that users click to submit values on the parameter form.
9. Click Create.