Oracle Forms Developer – Form Builder Reference, Volume 1

CREATE_GROUP_FROM_QUERY built-in
Description
Creates a record group with the given name. The record group has columns representing each column
you include in the select list of the query. Add rows to the record group with the POPULATE_GROUP
built-in.
Note: If you do not pass a formal column name or alias for a
column in the SELECT statement, Form Builder creates ICRGGQ with
a dummy counter . This happens whenever the column name
would have been invalid. The first dummy name-counter always
takes the number one. For example, the query SELECT 1 + 1 FROM
DUAL would result in a column named ICRGGQ_1.
Syntax
FUNCTION CREATE_GROUP_FROM_QUERY
(recordgroup_name VARCHAR2,
query VARCHAR2,
scope NUMBER,
array_fetch_size NUMBER);
58
Built-in Type unrestricted function
Returns RecordGroup
Enter Query Mode yes
Parameters
recordgroup_name The name of the record group. When Form Builder creates the record
group object it also assigns the object a unique ID of type RecordGroup.
query A valid SQL SELECT statement, enclosed in single quotes. Any columns
retrieved as a result of the query take the data types of the columns in the
table. If you restrict the query to a subset of the columns in the table, then
Form Builder creates only those columns in the record group
scope Specifies whether tlhe record group can be used only within the current
form or within every form in a multi-form application. Takes the following
constants as arguments:
FORM_SCOPE Indicates that the record group can by used only within the current
form. This is the default value.
GLOBAL_SCOPE Indicates that the record group is global, and that it can be used
within all forms in the application. Once created, a global record group persists for
the remainder of the runtime session.
array_fetch_size Specifies the array fetch size. The default array size is 20.
CREATE_GROUP_FROM_QUERY restrictions
• If a global record group is created from (or populated with) a query while executing form A, and the