Oracle Forms Developer – Form Builder Reference, Volume 1

8
column_width If you specify CHAR_COLUMN as the column_type, you must indicate the
maximum length of the data. COLUMN_WIDTH cannot exceed 2000,
and must be passed as a whole number.
Error Conditions:
An error is returned under the following conditions:
• You enter the name of a non-existent record group.
• You specify the name for a group or a column that does not adhere to standard Oracle naming
conventions.
• You enter a column type other than CHAR, NUMBER, DATE, or LONG.
ADD_GROUP_COLUMN restrictions
• You must add columns to a group before adding rows.
• You cannot add a column to a group that already has rows; instead, delete the rows with
DELETE_GROUP_ROW, then add the column.
• You can only add columns to a group after it is created with a call to CREATE_GROUP.
• If the column corresponds to a database column, the width of CHAR_COLUMN-typed columns
cannot be less than the width of the corresponding database column.
• If the column corresponds to a database column, the width of CHAR_COLUMN-typed columns can
be greater than the width of the corresponding database column.
• Only columns of type CHAR_COLUMN require the width parameter.
• Performance is affected if a record group has a large number of columns.
• There can only be one LONG column per record group.
ADD_GROUP_COLUMN examples
/*
** Built-in: ADD_GROUP_COLUMN
** Example: Add one Number and one Char column to a new
** record group.
*/
PROCEDURE Create_My_Group IS
rg_name VARCHAR2(15) := ’My_Group’;
rg_id RecordGroup;
gc_id GroupColumn;
BEGIN
/*
** Check to see if Record Group already exists
*/
rg_id := Find_Group( rg_name );
/*
** If Not, then create it with one number column and one
** Char column
*/
IF Id_Null(rg_id) THEN
rg_id := Create_Group( rg_name );
gc_id := Add_Group_Column(rg_id, ’NumCol’,NUMBER_COLUMN);
gc_id := Add_Group_Column(rg_id, ’CharCol’,CHAR_COLUMN,15);
END IF;
END;