Define Complex Entity
By default complex entities are not created during schema compilation in order to save space in the EDMdatabase and to enable optimal performance. This command defines specific complex entities in the actual dictionary model and enables the instantiation of complex entity instances in the appropriate data models. Creation of complex entities can optionally be done by the Schemata>DefineSchema command.
See ISO 10303-11: The Express language reference manual; for a description of complex entities.
The required complex entities will implicitly be defined when invoking the EDMinterface functions sdaiCreateInstance, sdaiCreateInstanceBN, sdaiGetEntity, sdaiGetAttrDefinition, and sdaiGetAttrDefinitionBN, such that the execution of the Schemata>DefineComplexEntity command is not required.
There are three possible consequences when activating this command:
- If the <Model> is a dictionary model, the new complex entity will be defined as a valid entity type in the appropriate schema.
- If the <Model> is a data model and the <Complex entity> exist in the appropriate dictionary model, an entity extent aggregate will be generated, i.e. the <Model> will be prepared to keep instances of the actual complex entity.
- If the <Model> is a data model and the <Complex entity> does not exist in the appropriate dictionary model, both 1) and 2) will happen.
Arguments:
Repository: |
Specify the name of the open repository that holds the actual model. Repository names are case sensitive. |
Model: |
Specify the name of a dictionary model or a data model that will be affected by this command. Model names are case sensitive. |
Complex entity: |
Specify the name of the complex entity. Complex entity names are case insensitive. A complex entity name is an alphabetically ordered concatenation of the names of all the constituents, i.e., the subtype entities that defines the complex entity. A '+' symbol must be used to concatenate the names. For example, the complex entity name involving the entities 'SUBTYPE1' and 'SUBTYPE2' shall be of the form 'SUBTYPE1+SUBTYPE2'. |
Options:
accumulating command output: |
A global option that appends the command output to the EDMsupervisor output window. Otherwise the output window is refreshed and only the last command output is displayed. |