xpxCopyAggrToNewAggr
FUNCTION xpxCopyAggrToNewAggr (options : INTEGER; sourceAggrId : AGGREGATE OF GENERIC; aggrOrInstanceId : GENERIC; attrIdOrAttrIntsance : GENERIC; aggrIndex : INTEGER; VAR newAggrId : AGGREGATE OF GENERIC) status : INTEGER;
The xpxCopyAggrToNewAggr function creates a new aggregate and copies the content of the source aggregate into the new created aggregate.
Arguments
Type | Name | Comment |
INTEGER | options | comment |
AGGREGATE OF GENERIC | sourceAggrId | Â |
GENERIC | aggrOrInstanceId | Â |
GENERIC | attrIdOrAttrIntsance | Â |
INTEGER | aggrIndex | Â |
AGGREGATE OF GENERIC | newAggrId | Â |
Return Value
Error rendering macro 'excerpt-include' : User 'null' does not have permission to view the page 'US:_r_XPX_Return_Value'.
Options
Option | Comment |
xpxASSIGN_TO_ATTRIBUTE | The new aggregate will be assigned to the attribute specified by the "attrIdOrAttrName" argument of the instance specified by the "aggrOrInstanceId" argument. The "attrIdOrAttrName" argument can be specified as an attribute name or as an attrId (InstanceId of the actual attribute). The arguments "aggrIndex" and "newAggrId" are optional for this options value. |
xpxASSIGN_TO_AGGREGATE_BY_INDEX | The new created aggregate will be inserted in the (parent) aggregate specified in the "aggrOrInstanceId" argumen at the position (index) specified by the "aggrIndex" argument. This operation is legal for parent aggregates of type ARRAY and LIST. The arguments "attrIdOrAttrName", "aggrIndex" and "newAggrId" are optional for this options value. |
xpxADD_TO_AGGREGATE | The new created aggregate will be added to the (parent) aggregate specified in the "aggrOrInstanceId" argument. The parent aggregate must be SET, BAG or LIST. Hence, this option value is illegal when the "aggrOrInstanceId" aggregate is an ARRAY. When the parent aggregate is LIST, the actual operation will be APPEND. |
xpxINSERT_BEFORE_LIST_ELEMENT | The new created aggregate will be inserted in the (parent) aggregate specified in the "aggrOrInstanceId" argument at the position before the element specified by the "aggrIndex" argument. This operation is legal only for parent aggregates of type LIST. The arguments "attrIdOrAttrName", and "newAggrId" are optional for this options value. |
xpxNEW_SCRATCH_AGGREGATE | The new aggregate will be a scratch aggregate (located in the scratch model). The InstanceId of the new created aggregate will be returned in the  "newAggrId" argument. The arguments "aggrOrInstanceId", "attrIdOrAttrName" and  "aggrIndex" are optional for this options value. |
xpxASSIGN_VOLATILE_AGGR_TO_GLOBAL_VARIABLE | The new aggregate will be a volatile aggregate located in the "heap of the EDMexpressVM", i.e., will not be "out of scope" before the actual EDMexpressVM process is terminated. The InstanceId of the new created aggregate will be returned in the  "newAggrId" argument. The arguments "aggrOrInstanceId", "attrIdOrAttrName" and  "aggrIndex" are optional for this options value. |
Â
Example
<Missing Example>
Â
See also
Filter by label
There are no items with the selected labels at this time.
Â