xpfCreateInstance

 
SYNTAX:
 
xpfCreateInstance (modelId                 : GENERIC;
                   entityIdOrViewEntityId  : GENERIC)                   instanceId              : GENERIC;
 
The xpfCreateInstance function creates a new entity instance of the specified instance type, <instanceType>, in a specified model, <modelId>, in the EDMdatabase^. The instanceID of the created instance is returned in the argument <newInstanceId>.
All the attributes of the created instance are initially unset, i.e., the attribute values are indeterminate. The xpfTestAttr, and xpfTestAttrBN functions will return sdaiFALSE for all attributes of the created instance until the attribute values have been set with one of the functions: xpxPutAttr, xpxPutAttrBN, xpxPutAttrs, xpxPutAttrsBN, xpxCreateAggr, xpxCreateAggrBN.
A numeric instanceID, <newInstanceId>, that uniquely identifies the entity instance in the EDMdatabase^ will be the returned function value. This instanceID should be used to identify this particular instance in subsequent EDMinterface^ operations. An instanceID is persistent and fixed, i.e. it is constant throughout the lifetime of the actual instance.
An instanceID will not be reused before the actual model that holds the particular instance identified by this instanceID is deleted.
This function is applicable only to data models.
The model that will hold the new created aggregate must be open for write access before this function can be successfully performed.
This function is equivalent to the EDMinterface^ function sdaiCreateInstance.
See also xpxCreateInstance and xpfCreateInstanceBN.