Define Schema
Invokes the EDMexpressCompiler to compile one or more files, each containing one or more Express schemata. For each input schema an Express syntax check, an Express schema consistency check and a dictionary model creation is available. This is specified through command options.
Both short form and long form notation is fully supported. This command can create and populate a dictionary model for all schemata compiled (DEFAULT if the <Schema to store> argument is empty), or for a specified set of EXPRESS Schemata compiled from the specified input file(s). See the description of <File> and <Schema to store> arguments for more details.
The ISO 10303 Part 22 defines the standard for naming the dictionary models. The name of a dictionary model is equal to the name of the EXPRESS Schema with "_DICTIONARY_DATA" appended. The dictionary model names are all in uppercase and is case sensitive. Existing dictionary models can be removed from the database by the Schemata>DeleteSchema or the Data>Delete>Model command as long as there exists no data models of the actual dictionary model. All dictionary models are by default write protected, as it is assumed that no dictionary models should be changed. An exception is when using the Schemata>DefineComplexEntity command.
Normally only Express schemata that are compiled without any errors can be stored as dictionary models in the EDMdatabase. This default rule can be overruled by setting the [continue storing on error] option. This option should be used with care as manipulating data in the EDMdatabase that is defined by an erroneous dictionary model may lead to unpredictable exceptions, including system crash!
Arguments:
File name: |
Specify the name of the file(s) containing Express Schema(ta). If more than one file is specified, delimit each file name with a comma. The wild card symbol "*" is also a permitted character in a filename. The default file extension is ".exp". |
Diagnostic file: |
Specify the file name for diagnostic information generated by this command. If no file name is supplied, all diagnostic information will be displayed in the EDMsupervisor output window. |
Schema to store: |
Specify the name of one or more schemata that will be stored as dictionary models in the EDMdatabase. If more than one schema name is specified, delimit each schema name with a comma. Express schema names are case insensitive. |
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. |
clear all options: |
Unset all Schemata>DefineSchema command options except [accumulating command output]. |
storing source: |
Specifies that the Express schema(ta) in its original form will be stored in the EDMdatabase. This Express source can later be retrieved and displayed by the command Schemata>ShowSchemata. |
deleting existing schemas: |
Specifies that the existing dictionary model(s) with the same name as the resulting dictionary model(s) from this compilation will be replaced by the new dictionary model(s) as long as there are no data models associated with this (these) existing dictionary model(s). Dictionary models with associated data models or associated Express-X dictionary models cannot be deleted before all the associated data models or associated Express-X dictionary models are deleted. |
parse only: |
Specifies that the Express schema(ta)will be checked for syntax errors only. This option will set and unset several other options, and these options cannot be changed until the [parse only] option is reset. |
no dictionary model: |
Specifies that no dictionary models will be created by the current execution of the Schemata>DefineSchema command. |
continue storing on error: |
Enforces the EDMexpressCompiler to create and populate a dictionary model of erroneous schema(ta). Only schema(ta) compiled without any errors can be stored as a dictionary model(s) in the EDMdatabase when this option is unset. |
log schema interface: |
Specifies that a log record will be written to the diagnostic report for each Express construct that is interfaced from one schema to another. This log record contains information such as the name of the interfaced construct, if it is explicit or implicit interfaced etc. |
sdai warnings: |
Activates EDMinterface/SDAI warnings relevant for the usage of EDMinterface functions on an instantiated data model of the actual schema. |
errors only: |
Warnings will be suppressed. |
diagnostics for root only: |
By implicit long form generation: Only show diagnostics for the main schema. |
diagnostics for interfaced only: |
By implicit long form generation: Skip diagnostics for schemata that are not interfaced. |
extensive diagnostics: |
Will provide more extensive diagnostics. |
html error listing |
Specifies that compilation errors will be presented in HTML format by the EDMsupervisor configured Internet Browser. |
EXPRESS edition 2: |
Supports edition 2 of the Express language. |
ignore empty select: |
Specifies that no error message should be produced when the compiler detects that a SELECT definition with an empty selection list is interfaced from one schema to another. |
tc2 |
Parse schema in accordance to Technical Corrigendum no.2 |
edm express extension: |
The compiler will accept EDM extensions to Express. Currently there is only one, namely xpxPrintf function. (see EDMassistVol6). |
Â
Options do not have equal priority. That is, some options may overrule others. The actual dependencies should be quite clear from the behaviour of the dialogue box, and are therefore not explained in further detail.
(Windows only)
The default value of the options for the Schemata>DefineSchema command can be set individually for each user in the file Edms.ini.
Example:
[OPTIONS]
EDMS_COMPILER_OPTIONS = "storing_source, sdai_warnings, max_checking_level"
(UNIX/Linux only)
The default value of the options for the Schemata>DefineSchema command can be set individually for each user by the environment variable EDMS_COMPILER_OPTIONS.
Example:
setenv EDMS_COMPILER_OPTIONS "storing_source, sdai_warnings, max_checking_level"