xpfWideCopyInstanceBN

FUNCTION xpfWideCopyInstanceBN (instanceId                    : GENERIC; 
                                modelId                       : GENERIC;   
                                options                       : INTEGER;   
                                in_includeExcludeRecursively  : SET OF GENERIC;   
                                in_includeExcludeShallow      : SET OF GENERIC;  
                                out_includeExcludeRecursively : SET OF GENERIC;  
                                out_includeExcludeShallow     : SET OF GENERIC)  
                                newInstance                   : GENERIC;
                

Use this function to ....

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".

 

Arguments


TypeNameComment
GENERIC

instanceId

A numeric instanceID that uniquely identifies the instance to be copied in the EDMdatabase.

GENERIC

modelId

A numeric modelID that uniquely identifies the data model locating the target instance(s).  This target model must be a population of the same schema as the model that locates the <instanceId>.

INTEGER

options

see below

SET OF GENERIC

in_includeExcludeRecursively

 

SET OF GENERIC

in_includeExcludeShallow

 

SET OF GENERIC

out_includeExcludeRecursively

 

SET OF GENERIC

out_includeExcludeShallow

 

Return Value


 

TypeNameComment
GENERICnewInstancecomments

Options


OptionComment

xpxINCLUDE_FILTER

 

xpxEXCLUDE_FILTER

 

Example


<Missing Example>

 

See also

Filter by label

There are no items with the selected labels at this time.

Â