xpfCreateMapInstance

 
SYNTAX:
 
xpfCreateMapInstance (entityId         : GENERIC)
                       newMapInstanceId : GENERIC;
 
 
The xpfCreateMapInstance will create a persistent instance of the type specified by the entityId argument in the target model. The instanceId of the created instance will be returned through the newMapInstanceId argument.
When the xpfCreateMapInstance is executed in a MAP declaration, the actual created instance will be added to the set of created MAP Instances, i.e., the set of instances that is created from a set of one or more source instances. This set of MAP instances can be fetched by the xpxGetMapInstances function. If the function xpfCreateMapInstance is called from another declaration than a MAP declaration, it will have the same effect as a xpfCreateInstance function on the target model.