Oracle Forms Developer – Form Builder Reference, Volume 1

DELETE_RECORD built-in
Description
When used outside an On-Delete trigger, removes the current record from the block and marks the record
as a delete. Records removed with this built-in are not removed one at a time, but are added to a list of
records that are deleted during the next available commit process.
If the record corresponds to a row in the database, Form Builder locks the record before removing it and
marking it as a delete.
If a query is open in the block, Form Builder fetches a record to refill the block if necessary. See also the
description for the CLEAR_RECORD built-in subprogram.
In an On-Delete trigger, DELETE_RECORD initiates the default Form Builder processing for deleting a
record during the Post and Commit Transaction process, as shown in Example 2 below.
Syntax
PROCEDURE DELETE_RECORD;
82
Built-in Type restricted procedure
Enter Query Mode no
Parameters
none
DELETE_RECORD examples
Example 1
/*
** Built-in: DELETE_RECORD
** Example: Mark the current record in the current block for
** deletion.
*/
BEGIN
Delete_Record;
END;
Example 2
/*
** Built-in: DELETE_RECORD
** Example: Perform Form Builder delete record processing
** during commit-time. Decide whether to use this
** Built-in or a user exit based on a global flag
** setup at startup by the form, perhaps based on
** a parameter.
** trigger: On-Delete
*/
BEGIN
/*
** Check the global flag we set during form startup
*/
IF :Global.Using_Transactional_Triggers = ’TRUE’ THEN
User_Exit(’my_delrec block=EMP’);