Before Field Edit Trigger
The Before Field Edit trigger is a client trigger and executes before a user completes changes to a field on a record form. Before Field Edit is a client trigger because it occurs during the edit of a record during the time that it is loaded in the browser. Before Field Edit only occurs during the edit of a field on a record form when the record is in a state.
When you use the Before Field Edit trigger for an action, you must also identify the name of the client field in the Client Fields multi-select box for the action. This identifies which record field to execute the action on. For more information about Client Fields for actions, see Creating an Action and Using Conditional Fields with Actions.
The following diagram shows common record edit events and when the Before Field Edit trigger executes:
Use this trigger to validate field lengths, restrict field entries to a predefined format, or validate a field against values in an associated field. For example, use this trigger with a Return User Error action to alert users that they must fix a field value before the user continues editing the form. For a list of all the actions that support this trigger, see Workflow Triggers Quick Reference.
Before Field Edit Trigger Example
The following screenshot shows a Return User Error action used to validate the value of the Notes on Bike Pick-up field on a Before Field Edit trigger:
The following screenshot shows the results of the Return User Error action on the record form. The error appears after the user moves away from the Notes on Bike Pick-up. Clicking OK returns the window focus to the field that needs fixed. The popup keeps appearing until the user fixes the error.
Before Field Edit Trigger Guidelines
Consider the following when you use the Before Field Edit trigger:
-
For SuiteScript users, the Before Field Edit trigger is the workflow equivalent of the validateField client event. For JavaScript, the Before Field Edit trigger execution is the equivalent of an onBlur client event.