Oracle Forms Developer – Form Builder Reference, Volume 1

CREATE_QUERIED_RECORD built-in
Description
When called from an On-Fetch trigger, creates a record on the block’s waiting list. The waiting list is an
intermediary record buffer that contains records that have been fetched from the data source but have not
yet been placed on the block’s list of active records. This built-in is included primarily for applications
using transactional triggers to run against a non-ORACLE data source.
Note that there is no way to remove a record from the waiting list. Consequently, the application must
ensure that there is data available to be used for populating the record programmatically.
Syntax
PROCEDURE CREATE_QUERIED_RECORD;
Built-in Type restricted procedure
Enter Query Mode no
Parameters
none
CREATE_QUERIED_RECORD restrictions
• In blocks with a large number of records, this procedure can have side effects on disk I/O, memory
allocation, or both.
CREATE_QUERIED_RECORD examples
/*
** Built-in: CREATE_QUERIED_RECORD
** Example: Fetch the next N records into this block. Record
** count kept in Global.Record_Count.
** trigger: On-Fetch
*/
DECLARE
fetch_count NUMBER;
FUNCTION The_Next_Seq
RETURN NUMBER IS
CURSOR next_seq IS SELECT uniq_seq.NEXTVAL FROM DUAL;
tmp NUMBER;
BEGIN
OPEN next_seq;
FETCH next_seq INTO tmp;
CLOSE next_seq;
RETURN tmp;
END;
BEGIN
/*
** Determine how many records Form Builder is expecting us to
** fetch
*/
fetch_count := Get_Block_Property(’MYBLOCK’,RECORDS_TO_FETCH);
FOR i IN 1..fetch_count LOOP
/*
63