xpfCreateTypedAggrBN

FUNCTION xpfCreateTypedAggr (instanceId      : GENERIC; 
                             attributeName   : STRING; 
                             typePath        : LIST OF GENERIC) 
                             newAggregateId  : AGGREGATE OF GENERIC;
               

The xpfCreateTypedAggr function creates an empty typed aggregate instance and connects the created aggregate to the specified attribute in the specified instance. Typed aggregates must be used when the attribute domain in the appropriate Express schema not uniquely defines the aggregate to be created. This can only occur when the actual element specification is of type SELECT. A struct of type SdaiSelect containing the aggregate typing should be supplied. A numeric aggregateID that uniquely identifies the new created typed aggregate instance in the EDMdatabase will by the returned function value in the argument <newAggregateId>. This aggregateID should be used to identify this particular aggregate instance in subsequent EDMexpressX operations. An aggregateID is persistent and fixed, i.e. it is constant throughout the lifetime of the actual aggregate instance. The actual aggregate type to be created is defined by the typing information in the argument <typePath>. If the actual aggregate is a nested aggregate, only the first level, i.e., the outer-most aggregate is created. The actual attribute that will own the new created aggregate is specified by the attributeName that uniquely identifies an attribute definition instance in the EDMdatabase. If the actual attribute already owns an aggregate, the existing aggregate will be deleted before a new one is created by this function. An aggregateID can never be used as a data value in any of the EDMexpressX put operations, it can only be returned as data value in EDMexpressX get operations. This operation is only applicable to Explicit attributes in application instances.

Arguments

Return Value

Options

Example

<Missing Example>

See also