KEEP processing during form synchronization

Mongoose supports the use of KEEP keywords for event handlers during form synchronization (FormSync) operations. The KEEP keyword enables event handlers to be automatically merged during FormSync operations. In cases where KEEP keywords have not been assigned to event handlers, FormSync uses a default process to automatically assign KEEP functionality.

This default process applies only if these situations are true:

  • All of the existing vendor-level event handlers are present and unmodified in the site, group, or user version of the form.
  • No KEEP keywords have been assigned to any event handlers in site, group, or user versions of the forms.
Note: KEEP keywords are applicable only to site, group, and user-level versions of forms. They do not apply to event handlers specified at the vendor level.

When these conditions are true, FormSync processes any event handlers that have been added to site, group, or user versions of forms according to these rules:

  • Handlers at the beginning of the list are treated as if KEEP( FIRST ) was specified.
  • Handlers at the end of the list are treated as if KEEP( LAST ) was specified.
  • Other handlers are processed as if KEEP( AFTER ) was specified.

For all these situations, no FormSync prompt is generated.

If this default behavior is undesirable, then you must explicitly assign KEEP keywords to your form event handlers.