Defining transient references

Transient references are kind of place holder in an instance. Transient references are not stored, but used for access related data in an application. Typically, transient references are filled by calling setTransientReference() in the doAfterRead() handler of the owning data type (context class). More details are described in the "Transient reference" sub topic of the Reference documentation. Transient references may refer to any type of property (attribute, reference, relationship).

Also names for transient references have to be unique within the members defined for a data type and its base types. Reference names are technical names and must not contain special characters or spaces except underscores. After filling in the reference name, Next should be pressed in order to continue.

The Data type field should contain the type or a common base type of data instances referenced in the transient reference later on. For referring to any type of instance VOID has to be defined. Th data type will be checked when assigning a property handle to the transient reference. After assigning a property handle, property definition from the assigned property handle is used. Thus, one may set the transient option, but one need not.

The Next step requests the reference type.

For defining a transient reference, the reference type transient reference has to be selected. The Next button directly leads to the definition summary.