KEEP keyword
Applies To
Form event handlers and validators
Description
The KEEP keyword is used to instruct FormSync which form event handlers and validators should be kept during form synchronization operations, and the order in which they should be kept.
Syntax
KEEP( string )
where string is one of the four values listed here.
Remarks
Note: The KEEP keyword is applicable only to site, group, and user-level
versions of forms. It is not applicable for event handler and validators specified at the
vendor level. For information about default KEEP behavior (in cases where no KEEP keywords
have been specified), see KEEP processing during form synchronization.
These are the valid specifications for the KEEP keyword:
- KEEP( FIRST ) - The event handler or validator comes at the beginning of the event handler or validator list. If multiple KEEP( FIRST ) handlers and validators are present, these handlers and validators are moved to the beginning of the list while maintaining their relative positions.
- KEEP( LAST ) - The event handler or validator comes at the end of the of the event handler or validator list. If multiple KEEP( LAST ) handlers and validators are present, these handlers and validators are moved to the end of the list while maintaining their relative positions.
- KEEP( AFTER ) - The event handler follows the next NON-KEEP event handler or validator that precedes it even if the vendor changes the position of the event handler.
- KEEP( BEFORE ) - The event handler precedes the next NON-KEEP event handler or validator that follows it.