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.