Adding form action fields to a form
Form action fields are not visible in some modes. For example, the Modify All button is not visible in New Search mode.
The form action fields that are displayed in a form are based on the selections that you make in the Add New Form Action Fields in Web View section on the Preferences window. (In Developer Studio, select Window > Preferences > Developer Studio > Form.)
The following table lists and describes the available form action fields.
Form Action Field | Description |
|---|---|
Submit * | Sends the data on the form to the database. If any workflow is designed to execute on submit, it will be executed. If Submit is disabled on a form, Mid Tier does not prompt to save the changes while the form is being unloaded, even if the field values have changed by user or workflows on that form. |
Query * | Executes the search on the current form. Because the results will be displayed in the results list field, you must select the Results List check box to include a results list field on the view when the Web Toolbar is disabled. If any workflow is designed to execute when a user performs a search operation, the workflow will be executed. |
Modify * | Submits your changes to the database. If any workflow is designed to execute on modify, it will be executed. |
Modify All | Performs a Modify action on fields in selected requests. This button is visible for the user in Modify mode only. |
Search Bar | Displays the advanced search bar, so that the user can perform advanced searches. When you create a Search Bar form action field, you must resize it to a field width of at least 650 and the number of rows should be modified to 4 so that all of the buttons appear when the form is viewed in a browser. See Sizing-fields. |
Form Help | Displays form-level help in a separate window. |
Clear | Removes values from all fields on the form. |
Home Page * | Opens the form configured to be your home page. |
Set to Defaults | Sets the entries on the form to the defaults. If any workflow is designed to execute after setting defaults, it will be executed. |
New Search * | Opens the form in Search mode so that the user can begin a new search. |
New Request * | Opens the form in New mode so that the user can submit a new request. |
Show Status History | Shows the progress that has been made on a request: the time that the entry was last changed to each of the states defined by the status field, and the name of the user who made the change. Users select the entry (request) from the results list field. When users click the Show Status History button, the form is searched, and the results are displayed in a new browser window. Show Status History is enabled only in Modify mode. |
Results List | Adds a results list field to the form. If a form does not already have a results list, it will be added automatically in the Standard view. If you find that the number of search results is limited and you receive an out-of-memory error message, increase the Maximum Heap Size in the virtual machine settings of your servlet engine. The results list field is visible only in Modify, Modify All, and Display Only modes. It is hidden in New Search mode. |
* This field is required on most forms.
To set a preference to automatically add form action fields
- In Developer Studio, select Window > Preferences.
- Open the Developer Studio node.
- Click Form.
- Under Add New Form Action Fields in Web View, select the fields that you want to add.
- Click OK.
To add a form action field manually to a view
- In Developer Studio, open a form view.
- Place the cursor where you want to insert the form action field.
- Select Form > Add Form Action Fields.
The Form Action Controls dialog box appears. - Select the fields that you want included in the view.
- Click OK to close the Form Action Controls dialog box and add your new fields.
- Save your changes.