Oracle Forms Developer – Form Builder Reference, Volume 1

ADD_GROUP_ROW built-in
Description
Adds a row to the given record group.
Syntax
PROCEDURE ADD_GROUP_ROW
(recordgroup_id RecordGroup,
row_number NUMBER);
PROCEDURE ADD_GROUP_ROW
(recordgroup_name VARCHAR2,
row_number NUMBER);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
recordgroup_id The unique ID that Form Builder assigns when it creates the group. The
data type of the ID is RecordGroup.
recordgroup_name The name you gave to the record group when creating it. The data type of
the name is VARCHAR2.
row_number A whole number that specifies a row in the group. If you add a row to any
but the last position in a group, all rows below that are logically
renumbered. To add a row to the end of a group, use the
END_OF_GROUP constant.
Error Conditions:
Form Builder returns a runtime error given either of the following conditions:
• If you enter the name of a non-existent record group.
• If you supply a row number that is out of range or is invalid (for example, an alphabetic character).
ADD_GROUP_ROW restrictions
• A group can consist of 0 or more rows.
• You can add rows to a group only after it has been created and columns have been added.
• If you specify a row number greater than the number of rows already in the group (or a negative
number), the row is inserted at the end of the group.
• You cannot add rows to a static group without a query.
ADD_GROUP_ROW examples
/*
** Built-in: ADD_GROUP_ROW
** Example: Add ten rows to a new record group and populate.
*/
9