Oracle Forms Developer – Form Builder Reference, Volume 1

SET_RELATION_PROPERTY built-in
Description
Sets the given relation property in a master-detail relationship.
Syntax
SET_RELATION_PROPERTY
(relation_id Relation,
property NUMBER,
value NUMBER);
SET_RELATION_PROPERTY
(relation_name VARCHAR2,
property NUMBER,
value NUMBER);
Built-in Type unrestricted procedure
Enter Query Mode yes
Parameters
relation_id Specifies the unique ID that Form Builder assigns the relation when it
creates the relation object. This can occur automatically when you define a
master-detail relationship in the Form Builder, or you can explicitly create
the relation. The data type of the ID is Relation.
relation_name Specifies the name you or Form Builder gave the relation object when
defining it. The data type of the name is VARCHAR2.
property Use one of the following relation properties, which can be passed to the
built-in as a constant:
AUTOQUERY Specifies that the detail block of this relation is to be
automatically coordinated upon instantiation of the block. This allows
potentially expensive processing to be deferred until blocks that are
involved in relations are actually visited. Valid values are
PROPERTY_TRUE and PROPERTY_FALSE.
DEFERRED_COORDINATION Specifies that a block requiring
coordination is to be marked but not coordinated until the detail blocks are
instantiated. Deferred coordination refers only to the population phase of
coordination. Even deferred detail blocks are cleared during the clear
phase of coordination to present the form in a visually consistent state.
Valid values are PROPERTY_TRUE and PROPERTY_FALSE.
MASTER_DELETES Specifies the default relation behavior for deletion
of a detail record in the detail block when there is a corresponding master
record in the master block. Valid values are NON-ISOLATED,
ISOLATED, or CASCADING. The ability to set this property
programmatically is included only for designers who are coding their own
master-detail coordination. It does not alter a default relation that was
created at design time.
409