Oracle Forms Developer – Form Builder Reference, Volume 1

offset_type Specifies the type of offset for the node. Possible values
are:
PARENT_OFFSET
SIBLING_OFFSET
If offset_type is PARENT_OFFSET, adds a data subset
immediately under the specified node at the location
among its children indicated by offset.
If offset_type is SIBLING_OFFSET, adds the new data
as a sibling to the specified node.
offset Indicates the position of the new node.
If offset_type is PARENT_OFFSET, then offset can be
either 1-n or LAST_CHILD.
If offset_type is SIBLING_OFFSET, then offset can be
either NEXT_NODE or PREVIOUS_NODE.
data_source Indicates the type of data source. Possible values are:
RECORD_GROUP
QUERY_TEXT
data Specifies the data to be added. If data source is
QUERY_TEXT, then data is the text of the query. If
data source is RECORD_GROUP, then data is an item
of type RECORDGROUP or the name of a record
group.
ADD_TREE_DATA examples
/*
** Built-in: ADD_TREE_DATA
*/
-- This code copies a set of values from a record group
-- and adds them as a top level node with any children
-- nodes specified by the structure of the record group.
-- The new top level node will be inserted as the last
-- top level node.
DECLARE
htree ITEM;
rg_data RECORDGROUP;
BEGIN
-- Find the tree itself.
htree := Find_Item(’tree_block.htree3’);
-- Find the record group.
rg_data := FIND_GROUP(’new_data_rg’);
17