trigger retrieveSequential
Trigger that retrieves the next occurrence in the database with a primary key value greater than the current one.
Declaration: | trigger
retrieveSequential
|
Applies to: | Form |
Activation: | Activated by the structure editor function ^RETRIEVE_SEQ. |
Default behavior: | None |
Behavior upon completion: | None |
Description
This trigger is only useful in forms in which the
Behavior property is set to Record
. Record behavior allows
only a single occurrence of the outer entity. A retrieve statement in this
trigger retrieves the next occurrence in the database with a primary key value greater than the
current one; that is, the occurrence that would appear next in the sort order.
Note: Uniface does not support this trigger for all DBMSs. For more information, see Data Retrieval Support.
If ProcScript in this trigger activates the read trigger and a negative value in the activated read trigger is returned, I/O processing is terminated after the read trigger completes.
By default, the retrieveSequential trigger contains the following code:
trigger retrieveSequential retrieve if ($status < 0) message $text(1762) ;error endif end; retrieveSequential