...
| Code Block | ||||
|---|---|---|---|---|
| ||||
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 | OPTIONaggrIndex | DESCRIPTION|
0 | The new aggregate will be a volatile aggregate and the InstanceId of the new 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. | |
| AGGREGATE OF GENERIC | newAggrId |
Return Value
...
| Insert excerpt | ||||||
|---|---|---|---|---|---|---|
|
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_ | TOSCRATCH_AGGREGATE | The new | createdaggregate 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.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. | xpxNEW_SCRATCH_AGGREGATE
| xpxASSIGN_VOLATILE_AGGR_TO_GLOBAL_VARIABLE | The new aggregate will be a | scratchvolatile aggregate | (located in the | scratch model)"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
...
| Code Block | ||
|---|---|---|
| ||
<Missing Example> |
See also
...
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|