Focus Action

A Focus action allows you to set the focus to a particular field (using the name of the field) based on the data entered or retrieved from the data map. For example, if a user enters invalid data in a field and then performs an action to validate the data, the focus can be set to that field for correction by the user.

Note: This type of action is available only in applications.

Note: Each action must have a name by which it is identified, and this name must be unique within the form in which it appears. This name can be modified in the Name field of the action and is displayed in View > Actions after the action has been created.

The following are the properties for a Focus action.

Important! Content in an action or rule is case sensitive.

Value	Description
Name	The name for the action or rule.
Trigger source	The field that is used in conjunction with a trigger event to interactively run the rule. For example, a button that runs a query when clicked, a prompt that runs a query when submitted, or a form that runs a query when loaded.
Trigger event	The event that is used in conjunction with the trigger source to run the rule. For example, clicking a button, entering text at a prompt, loading a form, or submitting a job.
Priority	The order in which the rules that have otherwise identical triggers are run. Trigger values are compared only if the triggers have the same trigger source, trigger event, and trigger key (if any). The type of trigger source is irrelevant. The trigger source with the lowest value for priority is run first.
Conditional	Determine whether to perform an action based on the result of a comparison of values or the result of a logical operation. Name Operator Equals Not Equal Equals Ignore Case Not Equal Ignore Case Less Than Greater Than Is Missing Is Not Missing Is Empty Is Not Empty Value
Field name source	Whether the value in Field is literal or the reference to a data map entry. Literal: The value in Field should be treated as a literal value and used in its current form. From data map: The value in Field should be resolved to values in the data map.
Field	The name of the field to set focus to, or the reference to a data map entry that contains the name of the field to set focus to.