Define Query Schema
Invokes the EDMexpressXCompiler to compile Query schemata. The compiler will perform a complete validation of the Query schemata and optionally store the schemata as meta-data in the dictionary model of the underlying EXPRESS schema to enable later execution of the queries defined in the actual Query schemata.
The underlying EXPRESS schema of the Query schema must exist as a dictionary model in the EDMdatabase before this command can be performed without any errors. The actual dictionary model must be closed. Any number of Query schemata can be defined for each EXPRESS schema. The name of a Query schema must be unique for all Query schemata of the same EXPRESS schema.
Existing Query schemata can be deleted by the Schemata>QuerySchema>DeleteSchema command. The command Schemata>DeleteSchema will delete all Query schemata belonging to the EXPRESS schema addressed in this command.
Normally only Query schemata that are compiled without any errors can be stored in the EDMdatabase. This default action can be overruled by setting the [continue storing on error] option. This option should be used with care as executing a Query function that contains errors detected during compilation time may lead to unpredictable exceptions, including system crash!
Arguments:
File name: |
Specify the name of the file(s) containing Query 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 ".qex". |
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. |
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>QuerySchema>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>QuerySchema>ShowSchemata. |
deleting existing schemas: |
Specifies that the existing Query schemata with the same name as the currently compiled Query schemata belonging to the same underlying EXPRESS schema, will be replaced by the actual compiled Query schemata. |
parse only: |
Specifies that the Query 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>QuerySchema>DefineSchema command. |
continue storing on error: |
Enforces the EDMexpressXCompiler to update the dictionary models of the underlying EXPRESS schemata for Query schemata that is reported erroneous by the compiler. Only schema(ta) compiled without any errors will be stored in the actual dictionary model(s) in the EDMdatabase when this option is unset. |
html error listing |
Specifies that compilation errors will be presented in HTML format by the EDMsupervisor configured Internet Browser. |