edmiCreateScratchInstance

 
Creates a scratch instance of the specified instance type. A scratch instance is located in the scratch model, i.e., scratch instances will not be written to the persistent EDMdatabase.
All EDMinterface access operations defined for persistent instances are applicable on scratch instances.
The scratch model is a volatile model that is deleted when the session is closed or the database is closed. The scratch model can hold instances of any instance types defined by any dictionary models in the EDMdatabase. Each open session have it own unique scratch model, hence the data in a scratch model cannot be shared between concurrent users of an EDMdatabase. The scratch model will implicitly be created and open for write access when the session is opened.
The dictionary model that defines the actual <entityId> must be open before this operation can be successfully performed.
A scratch instance can be deleted by the sdaiDeleteInstance , edmiDeleteInstanceAndReferences , edmiDeleteAllScratchInstancesOfSchema , edmiDeleteAllScratchInstancesOfSchemaBN operations. All scratch instances are deleted when the open session is closed or when the database is closed.
Related functions: edmiCreateScratchInstanceBN , edmiCreateScratchInstanceAndPutAttrs, edmiCreateScratchInstanceAndPutAttrsBN , sdaiDeleteInstance , edmiDeleteInstanceAndReferences , edmiDeleteAllScratchInstancesOfSchema , edmiDeleteAllScratchInstancesOfSchemaBN
Header:
#include "sdai.h"
Prototype:
SdaiAppInstance edmiCreateScratchInstance(SdaiEntity entityId);
Arguments:

Returns:
A numeric instanceID that uniquely identifies the new created entity instance in the EDMdatabase. This instanceID should be used to identify the particular instance for subsequent EDMinterface operations.
instanceID != 0 : operation successfully performed.
instanceID = 0 : operation failed, use sdaiErrorQuery function to get error reason.
EXAMPLE
SdaiEntity personId;
SdaiAppInstance instId;
...
instId = edmiCreateScratchInstance (personId);
if (! instId) {
/* Error in operation */ 
printf("\nError in edmiCreateScratchInstance: %s\n", 
edmiGetErrorText(sdaiErrorQuery())); 
goto error; 
}
...