...
| Code Block | ||||
|---|---|---|---|---|
| ||||
SdaiAppInstance edmiCreateScratchInstanceAndPutAttrsBN(SdaiString schemaName,
SdaiString entityName,
SdaiInteger numberAttr,
/* [SdaiString attributeName,
SdaiPrimitiveType valueType,
void attributeValue,] */
. . . ); /* values */
|
This operation creates a scratch instance and optionally set the specified attribute values of the created instance. Hence this operation is a combination of edmiCreateScratchInstanceBN and sdaiPutAttrsBN operations. 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 has 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 specified by the <schemaName> 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.
...
Arguments
...
| Type | Name | Comment |
| SdaiString | schemaName | Specifies the name of EXPRESS schema that defines the actual instance type to be created. This EXPRESS schema must exist as a dictionary model in the EDMdatabase. Schema names are case insensitive. Schema names are unique in an EDMdatabase. |
| SdaiString | entityName | Specifies the name of an entity in the schema <schemaName>. The combination of <schemaName> and <entityName> uniquely defines the instance type to create. Entity names are case insensitive. |
| SdaiInteger | numberAttr | An integer number that specifies the number of attribute values to put in the operation. |
attributeName | For each attribute value to assign the three following arguments in the following order have to be specified:
|
...
Return Value
...
| Type | Comment |
| SdaiAppInstance |
Options
...
Example
...
| Code Block | ||
|---|---|---|
| ||
SdaiAppInstance instId; SdaiAttr familyNameId, sexId; ... instId = edmiCreateScratchInstanceAndPutAttrsBN ( "Example_Schema", |
...
"Person", |
...
2, |
...
"FamilyName", sdaiSTRING, "Smith", |
...
"Sex", sdaiENUMERATION, Male); |
...
if (! instId) { |
...
/* Error in operation */ |
...
printf("\nError in edmiCreateScratchInstanceAndPutAttrsBN: %s\n", |
...
edmiGetErrorText(sdaiErrorQuery())); |
...
goto error; |
...
}
... |
See also
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|