xpfConditionalDeepCopyInstances

 
SYNTAX:
 
xpfConditionalDeepCopyInstances (sourceInstances : SET OF GENERIC;                                  modelId         : GENERIC;                                  options         : INTEGER;                                  include_exclude : SET OF GENERIC)                                  newInstances    : LIST OF GENERIC;
 
To be completed.
The xpfConditionalDeepCopyInstances function returns an aggregate of numeric instanceIDs that will uniquely identify the created instances (target instances) in the EDMdatabase^.
This function is equivalent to the EDMinterface^ function edmiConditionalDeepCopyInstances.
See also xpxConditionalDeepCopyInstances.
 
Remarks:
When copying objects (entity instances & aggregate instances) from  one model to another model, the actual objects must be "copied" from the source model into the target model. Copied in this context means that new entity instances/aggregate instances have to be created in the target model and then the "primitive attribute/aggregate values" have to be assigned from the source objects to the new created objects in the target model. Hence, "normal" assignment statements cannot be used for this purpose. An assignment operation will only "copy" the InstanceId of the actual object resulting in "invalid InstanceId in target model".