...
| Code Block | ||||
|---|---|---|---|---|
| ||||
SdaiAggr edmiCreateSubtypeAggrBN(SdaiModel modelId,
SdaiString entityName);
|
Creates a subtype aggregate, i.e. a
...
volatile aggregate instance that contains all instances of the specified type and all instances that is a subtype of the specified type in one data model.
...
A numeric aggregateID that uniquely identifies the new created subtype aggregate instance in the EDMdatabase will be the returned function value. This aggregateID should be used to identify this particular subtype aggregate instance in subsequent EDMinterface operations.
...
The resulting subtype aggregate instance will not be persistent in the EDMdatabase, it will exist until it is deleted by the sdaiDeleteAggr operation or until the open EDMserver session is closed by the function sdaiCloseSession or the current open database is closed.
...
The resulting subtype aggregate can only be accessed by read operations. It is not permitted to change the contents of a subtype aggregate. All read (get) operations available for SET and BAG aggregate types are available for accessing subtype aggregates.
...
This operation is only applicable to data models. The actual data model must be open before this operation can be successfully performed.
Note: The creation and deletion of instance types held by a subtype aggregate will influence the contents of the related subtype aggregates, hence it is recommended to delete and re-create the related subtype aggregate after such operations.
...
Arguments
...
| Type | Name | Comment |
| SdaiModel | modelId | A numeric modelID that uniquely identifies the data model of interest in the EDMdatabase. |
| SdaiString | entityId | Name of the ENTITY that defines the instance type of the instances that will be contained in the resulting subtype aggregate. ENTITY names are case insensitive. This actual ENTITY must be defined in the EXPRESS schema that is the underlying schema of the model specified by the <modelId> argument. |
...
Return Value
...
| Type | Comment |
| SdaiAggr |
Options
...
Example
...
| Code Block | ||
|---|---|---|
| ||
SdaiAggr subtypeAggr; SdaiModel modelId; ... subtypeAggr = edmiCreateSubtypeAggrBN (modelId, "Person"); if (! subtypeAggr) { /* Error in operation */ printf("\nError in edmiCreateSubtypeAggrBN: %s\n", edmiGetErrorText(sdaiErrorQuery())); |
...
goto error; |
...
}
. . . |
See also
| Filter by label (Content by label) | ||||||
|---|---|---|---|---|---|---|
|