...
| Code Block | ||||
|---|---|---|---|---|
| ||||
FUNCTION xpfCreateScratchInstanceAndPutAttrsBN (schemaName : STRING;
entityName : STRING;
numberOfAttributes : INTEGER;
attrName1 : STRING;
attrValue1 : GENERIC;
...
attrNameN : STRING;
attrValueN : GENERIC)
scratchInstanceId : GENERIC;
|
The xpfCreateScratchInstanceAndPutAttrsBN function creates a scratch instance and optionally set the specified attribute values of the created instance. Hence this operation is a combination of xpxCreateInstanceBN xpxCreateInstance and xpxPutAttrsBN xpxPutAttrs 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.
| Info |
|---|
...
Scratch instances can have relations to persistent instances but persistent instances cannot have relations to scratch in stances. |
...
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 |
...
defines the |
...
actual <entityId> must be open before this operation can be successfully performed. |
...
|
Arguments
| Type | Name | Comment |
| STRING | schemaName | comments |
| STRING | entityName | |
| INTEGER | numberOfAttributes | |
| STRING | attrName1 | |
| GENERIC | attrValue1 |
Return Value
...
| Type | Name | Comment |
| GENERIC | scratchInstanceId | comments |
Options
...
Example
...
| Code Block | ||
|---|---|---|
| ||
<Missing Example> |
See also
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|