Settings
Configure the settings of a form.
Controls | |
Control width |
Lets you update the width of all the controls on a form at a time rather than doing it individually for each control. To update the width of all controls, enter or select the control width and click Update. Once you update the width for a single control, the width of all the controls is updated automatically. If the form is set to percentage width mode, any controls set to percentage width mode adjust depending on the form percentage width. However, if any controls are set to a fixed width, then the form percentage does not affect those controls. The controls that support control width are:
|
Associated label width | The width of labels associated with all the existing controls and with any new controls added to the form. (Default: 100) |
Background | |
Color |
Lets you accept the default Theme as the background or an Inline color scheme. |
Use image |
If selected, allows you to use an image for the background to enhance the look of the form. Use background image in one of the following ways:
Resize to fit: If selected, fits the image to the full size of the form. By default, the original size of the image is used. |
Behavior | |
Use browser tab order |
If selected, the form uses the default browser tab order rather than a specific tab order on each control. The tab order property for all controls becomes read-only (cannot be edited) and the tab index of all existing form controls is reset to 0. The tabs in a browser typically function in the following order:
|
Expand last row to fit |
If selected, any controls within the row expand to take up the remaining browser window height.
|
Enable column splitting |
If selected, allows you to resize the columns on a cell at runtime. When you resize a column, the adjacent columns auto-adjust accordingly. Resizing a column provides you the flexibility to assign less or more space to the contents of the column as needed. |
Show column splitter |
If selected, shows the splitter at runtime. If a form contains more than one column, a splitter becomes available between each column. If cleared, the splitter becomes unavailable; however, you can still resize the columns.
This property is not available for a form if the width mode is set to "Fixed". |
Redirect confirmation |
At runtime, when the user navigates away from a form, a message is displayed with the following options:
Additional information:
|
Refresh interval |
The interval at which the form is refreshed automatically. |
Show asterisk |
By default, displays the red asterisk for all the mandatory fields when you view the form at runtime.
|
Session validation |
If selected, at runtime the form will require all actions to pass a valid session ID when executing server-side form actions. This means the form can only be used by a logged-on TotalAgility user. If the session ID is invalid, the following message is displayed: " Invalid Session ID - Your session is invalid because it may have timed out. Log on again." (Default: Clear. This means, a valid session is not required when executing server-side form actions.) |
Form factors | |
Primary form |
The type of form (Desktop, Phone, or Tablet) to open as the primary form in the Form Designer. For example,
|
JavaScript | |
See Configure JavaScript functions |
Configure JavaScript functions
JavaScript functions can be called using the JavaScript action. See JavaScript action.
-
In the properties panel of the form, click
Configure next to
JavaScript.
The JavaScript dialog box is displayed.
-
In the
JavaScript functions field, enter the script.
Function sample
function sample() { alert("Hi"); }
The script can contain one or more functions; however, you must enter a valid script, otherwise the form fails to load at runtime.
- Click Save.