edmiCreateScratchInstanceAndPutAttrs

Owned by Former user (Deleted)
Last updated: Dec 12, 2017
daiAppInstance edmiCreateScratchInstanceAndPutAttrs(SdaiEntity        entity, 
                                                      SdaiInteger       numberAttr, 
                                                      /*[SdaiAttr       attribute, 
                                                      SdaiPrimitiveType valueType, 
                                                      void              attributeValue] */ 
                                                      ... );

This operation creates a scratch instance and optionally set the specified attribute values of the created instance. Hence this operation is a combination of edmiCreateScratchInstance and sdaiPutAttrs 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 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.
 

Arguments

TypeNameComment
SdaiEntity

entity

A numeric entityID that uniquely identifies an entity definition instance in a dictionary model in the EDMdatabase.  The entityID is returned by the sdaiGetEntity function.

SdaiInteger

numberAttr

An integer number that specifies the number of attribute values to put in the operation.

 

values

For each attribute value to assign the three following arguments in the following order have to be specified:

  1. SdaiAttr <attribute>: A numeric identifier that uniquely identifies an attribute definition instance in the EDMdatabase, hence defines the attribute within the specified instance to assign the specified value to. The attributeID is returned from the sdaiGetAttrDefinition and sdaiGetAttrDefinitionBN functions.
  2. SdaiPrimitiveType <valueType> : The specified primitive type <valueType> must be the same or a compatible data type of the actual attribute domain as defined in the attribute declaration in the related EXPRESS schema.
    All data types except sdaiAGGR can be handled by this operation. Aggregates cannot be assigned as attribute data value by this operation. Aggregates must be assigned to attributes by either sdaiCreateAggr or sdaiCreateAggrBN operations. The primitive type sdaiSELECT can be used to write all data types. The primitive type sdaiADB can be used to write all data types except typed values.  The primitive type sdaiINTEGER is compatible with sdaiREAL, and sdaiBOOLEAN is compatible with sdaiLOGICAL, hence conversion between these compatible data types will be performed when required. An aggregate, i.e. data type sdaiAGGR is illegal in this operation.
  3. void <attributeValue> : The data value to assign to the actual attribute in the specified instance. The type of <attributeValue> must be the same as specified in the <valueType> argument.

Return Value

TypeComment
SdaiAppInstance 

 

Options

  

 

Example

 

 SdaiEntity personId;
 SdaiAppInstance instId;
 SdaiAttr familyNameId, sexId;
 ...
 instId = edmiCreateScratchInstanceAndPutAttrs (
 personId, 
 2, 
 familyNameId, sdaiSTRING, "Smith", 
 sexId, sdaiENUMERATION, Male); 
 if (! instId) {
 /* Error in operation */ 
 printf("\nError in edmiCreateScratchInstanceAndPutAttrs: %s\n", 
 edmiGetErrorText(sdaiErrorQuery())); 
 goto error; 
 }
 ...

 

See also

Filter by label

There are no items with the selected labels at this time.

Â