Adding form action fields to a form
Although toolbar buttons can provide the functionality that you need in web applications, you can use form action fields to customize a view. Form action fields are the same as any other fields, except that they have reserved field IDs and predefined operations on the web.
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 (as shown in the following figure) on the Preferences window. (In BMC Remedy Developer Studio, select Window > Preferences > BMC Remedy Developer Studio > Form.)
Form Action Fields selection in Preferences window
The following table lists and describes the available form action fields.
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. |
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 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. |
* This field is required on most forms. |
You can set a preference for which form action fields are automatically included, and you can add form action fields manually to a form.