xpfConditionalDeepCopyInstancesEx

FUNCTION  xpfConditionalDeepCopyInstancesEx (sourceInstances     : SET OF GENERIC;
                                             modelId             : GENERIC;
                                             options             : INTEGER; 
                                             include_exclude     : SET OF GENERIC;  
                                             instanceContainerId : GENERIC;   
                                             rolesToCopy         : SET OF GENERIC; 
                                             noContainerRoles    : SET OF GENERIC) 
                                             newInstances        : LIST OF GENERIC;

This function returns an aggregate of numeric instanceIDs that will uniquely identify the created instances (target instances) in the EDMdatabase.

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". The "ROLES" arguments in this function should be specified without the "EXPRESS_SCHEMA_NAME." part as the schema is implicitly uniquely specified by the actual model. Examples of legal"ROLES" arguments for these functions:

'IFCROOT.GLOBALID'

'IFCROOT.NAME'

'IFCOBJECTDEFINITION.DECOMPOSES'

'IFCBUILDINGSTOREY.ELEVATION'

Arguments

Type	Name	Comment
SET OF GENERIC	sourceInstances	comments
GENERIC	modelId
INTEGER	options
SET OF GENERIC	include_exclude
GENERIC	instanceContainerId
SET OF GENERIC	rolesToCopy
SET OF GENERIC	noContainerRoles

Return Value

Type	Name	Comment
LIST OF GENERIC	newInstances	comments

Options

Option	Comment
xpxSUBTYPES	comment
xpxINCLUDE_TYPES
xpxEXCLUDE_TYPES
xpxEXCLUDE_INSTANCES
xpxCOPY_SHALLOW
xpxUSE_MAPPED_INSTANCES
xpxEXCLUDE_ALL_INSTANCES

Example

<Missing Example>

EDMsix

xpfConditionalDeepCopyInstancesEx

Arguments

Return Value

Options

Example

See also

Filter by label